База знаний GetMyBot

Виджеты и приватные ответы Telegram

Настройка виджетов Telegram, обработка выбора и приватные ответы в реакциях.

На этой странице

В реакциях можно отправлять интерактивный виджет, обрабатывать выбор и отвечать приватно на команду или кнопку. Возможности появляются в редакторе, когда они включены для проекта и выбран подходящий канал Telegram.

Урок 1. Создайте виджет выбора

  1. Подключите Telegram-бота и откройте его проект. Создайте реакцию на команду, например choose.
  2. В действии Отправить сообщение выберите Добавить блок → Виджет Telegram. Введите заголовок и при необходимости текст.
  3. Добавьте варианты. Для каждого укажите видимое название и уникальные данные события, например yes и no. Допустимо от одного до восьми вариантов; данные каждого занимают не более 64 байт UTF-8.
  4. Сохраните блок и реакцию. Отправьте команду боту в личном чате Telegram и проверьте выбор на устройстве.

Урок 2. Обработайте выбор

Создайте вторую реакцию с триггером Событие виджета Telegram. Укажите данные нужного варианта либо оставьте поле пустым для любого выбора. Добавьте действия реакции и сохраните её. Затем выберите вариант в отправленном виджете и проверьте результат.

Действие Ответить виджету Telegram возвращает данные виджету; разместите его сразу после необходимых вычислений. Ожидание ограничено двумя секундами, после чего ответ может быть пустым. Действие Обновить данные виджета Telegram меняет данные исходного виджета; пустое значение очищает выбранное поле. Каждое поле – не более 1024 байт UTF-8.

Общие и пересланные виджеты

Включите Общий виджет, если одни и те же публичные данные должны быть видны всем получателям. Не помещайте в них личные сведения. Для повторной отправки выберите ранее созданный виджет того же бота и канала.

Опция обработки пересланных виджетов доступна отдельно. Telegram не передаёт чат пересланного виджета: ограничения по типу и ID чата для такого события не применяются, а данные конкретного чата недоступны. Для него можно обновлять только публичные данные.

Урок 3. Приватный ответ

Для кнопки, вызывающей реакцию, откройте целевую реакцию и в действии отправки включите приватный ответ. Он предназначен для человека, нажавшего кнопку, и не должен превращаться в обычное сообщение группы. Приватную команду можно зарегистрировать в настройках команд Telegram-бота.

В приватном ответе используйте один блок: текст либо один поддерживаемый медиафайл, включая аудио и видео. Проверьте сценарий с тестовым ботом и реальным пользователем. Если контекст кнопки или сообщения недоступен либо истёк, отправка не выполняется как публичная.

Аудио, видео и цитата

В действии отправки доступны отдельные блоки Аудио и Видео. Загрузите файл в медиатеку или выберите доступный Telegram file_id; для приватного ответа используйте ровно один файл. Настройка цитаты форматированного сообщения применяется к обычному ответу Telegram и несовместима с приватным ответом.

Виджет в диалоге оператора

Отправленный виджет появляется в диалоге отдельной карточкой с его HTML и последними подтверждёнными данными. После успешного обновления данных карточка обновляется. Публичные данные общего виджета обновляются у его получателей в том же Telegram-канале; данные чата относятся только к конкретному получателю.

Предпросмотр доступен только для чтения: кнопки не запускают реакции. Он показывает сохранённое состояние, а не снимок экрана или подтверждение прочтения на устройстве. Ответ виджету, который Telegram не сохраняет как данные сообщения, и локальное состояние клиента могут отличаться. Если подтверждённый снимок недоступен, карточка сообщает об этом.

Повторное нажатие может отправить Telegram те же данные. Ответ message is not modified для редактирования обрабатывается как успешное действие без изменений. Если такой ответ остался в старой записи истории, это означает, что сообщение уже содержало нужный текст и кнопки.

Если что-то не получилось

  • Нет пункта виджета или приватного ответа: проверьте выбранный канал и доступность возможности для проекта.
  • Выбор не запускает реакцию: проверьте триггер, данные варианта, область чатов и включённость реакции.
  • Общий виджет не выбирается: убедитесь, что он создан в том же проекте и канале.
  • Пересланное событие не меняет данные чата: Telegram не передаёт для него контекст чата; используйте публичные данные.

См. также реакции и сообщения и кнопки.