Встроенные боты

Помимо отправки команд в личных сообщениях или группах, пользователи могут взаимодействовать с вашим ботом с помощью встроенных запросов. Если встроенные запросы включены, пользователи могут вызвать вашего бота, введя его имя пользователя и запрос в поле ввода текста в любом чате. Запрос отправляется вашему боту в обновлении. Таким образом, люди могут запрашивать контент у вашего бота в любом из своих чатов, групп или каналов, не отправляя никаких сообщений.

Чтобы включить эту опцию, отправьте команду /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 - Найдите и отправьте наклейки на основе эмодзи