Встроенные боты
@Toxa8878Помимо отправки команд в личных сообщениях или группах, пользователи могут взаимодействовать с вашим ботом с помощью встроенных запросов. Если встроенные запросы включены, пользователи могут вызвать вашего бота, введя его имя пользователя и запрос в поле ввода текста в любом чате. Запрос отправляется вашему боту в обновлении. Таким образом, люди могут запрашивать контент у вашего бота в любом из своих чатов, групп или каналов, не отправляя никаких сообщений.
Чтобы включить эту опцию, отправьте команду /setinline в @BotFather и укажите текст-заполнитель, который пользователь увидит в поле ввода после ввода имени вашего бота.
Соответствующие методы и объекты см. в Руководстве по API ботов.
Встроенные результаты
Встроенные боты поддерживают все типы контента, доступного в Telegram (20 всего). Они способны отправлять наклейки, видео, музыку, локации, документы и многое другое.
Клиенты могут отображать результаты с вертикальной или горизонтальной прокруткой в зависимости от типа контента:
Как только пользователь нажимает на элемент, он немедленно отправляется получателю, и поле ввода очищается.
Переключение режимов встроенного/PM
Некоторые встроенные боты могут извлечь выгоду из первоначального процесса настройки, например, подключения их к учетной записи во внешней службе (например, YouTube). Мы добавили простой способ переключения между приватным чатом с ботом и любым чатом, в котором пользователь хочет поделиться результатами на линии.
Вы можете отобразить специальную кнопку «Переключиться на PM» над встроенными результатами (или вместо них). Эта кнопка откроет приватный чат с ботом и передаст выбранный вами параметр, чтобы вы могли предложить пользователю соответствующие действия по настройке. После завершения вы можете использовать встроенную клавиатуру с кнопкой switch_inline_query, чтобы отправить пользователя обратно в исходный чат.
Образцы ботов
@youtube - Показывает кнопку «Войти на YouTube», а затем предлагает персонализированные результаты.
Руководство: Переключиться на PM
Результаты на основе местоположения
Встроенные боты могут запрашивать данные о местоположении у своих пользователей. Используйте команду /setinlinegeo с @BotFather, чтобы включить это. Ваш бот будет запрашивать у пользователя разрешение на доступ к их местоположению всякий раз, когда он отправляет встроенный запрос.
Образец бота
@foursquare - Этот бот запросит разрешение на доступ к местоположению пользователя, а затем предоставит геотаргетированные результаты.
Распространение вирусно
Сообщения, отправленные с помощью вашего бота, будут показывать его имя пользователя рядом с именем отправителя.
Когда пользователь нажимает на имя пользователя бота в заголовке сообщения, упоминание автоматически вставляется в поле ввода. Если ввести символ @ в поле ввода, появится список предложений с недавно использованными встроенными ботами.
Сбор отзывов
Чтобы узнать, какой из предоставленных результатов ваши пользователи отправляют своим партнерам по чату, отправьте @Botfather команду /setinlinefeedback
. Если это включено, вы будете получать обновления результатов, выбранных вашими пользователями.
Обратите внимание, что это может создать проблемы с нагрузкой для популярных ботов - вы можете получить больше результатов, чем фактические запросы, из-за кэширования (см. параметр cache_time в answerInlineQuery). В этих случаях мы рекомендуем настроить настройку вероятности, чтобы получить 1/10, 1/100 или 1/1000 результатов.
Встроенные образцы ботов
Вот несколько примеров встроенных ботов, если вам интересно увидеть одного в действии. Попробуйте любой из них:
@gif – поиск GIF
@vid – Поиск видео
@pic – Поиск изображений Яндекса
@bing – Поиск изображений Bing
@wiki – поиск в Википедии
@imdb – поиск IMDB
@bold - Сделать полужирный, курсив или фиксированный системный текст
НОВОЕ
@youtube - Подключите свою учетную запись для получения персонализированных результатов
@music - Поиск и отправка классической музыки
@foursquare - Поиск и отправка адресов мест проведения
@sticker - Найдите и отправьте наклейки на основе эмодзи