Сообщения и кнопки
Как составить ответ бота: текст, фото, кнопки под сообщением и вопросы с сохранением ответа.
На этой странице
Чтобы бот прислал текст, фото и кнопку «Выбрать», добавьте действие «Отправить сообщение». Ответ собирается из отдельных частей, блоков. Например, сначала фото товара, затем описание с кнопками под ним. Кнопки под сообщением также называются inline-кнопками.
В том же действии можно задать вопрос и дождаться ответа. Например, спросить телефон и сохранить его в карточку клиента. Ниже описаны блоки, кнопки и настройка вопросов.
Блоки сообщения
Нажмите Добавить блок и выберите, что отправить. Блоки можно сочетать: текстовое приветствие, фото и файл с программой занятия.
- Текст: форматированный текст (до 4096 символов) с подстановками и кнопками.
- Фото: изображение с подписью.
- Файл: документ с подписью.
- Голосовое: аудио (OGG/OPUS, MP3, M4A, до 50 МБ), которое Telegram показывает как голосовое сообщение (
sendVoice). - GIF: анимация или MP4 без звука, до 50 МБ (
sendAnimation). - Видеокружок: квадратное MP4 до 60 секунд (
sendVideoNote). У кружка нет подписи. При каждой отправке файл из медиатеки загружается заново: Telegram не принимает вsendVoice,sendAnimationилиsendVideoNoteидентификаторfile_id, полученный другим способом. - Карусель: от 2 до 10 карточек «фото + подпись + свои кнопки». В Telegram карточки листаются кнопками «‹ ›» в одном сообщении через
editMessageMedia, если для каждого фото доступен пригодныйfile_id: заданный в карточке или полученный для файла из медиатеки. Если хотя бы для одного фото такого ID получить не удалось, все карточки отправляются отдельными фото-сообщениями. Так же они отправляются в других каналах, например VK. Подпись и кнопки каждой карточки сохраняются. - Задержка: пауза в секундах перед следующим блоком.
- ИИ: ответ, сгенерированный моделью по промпту.
- Реакция: вызов другой реакции (опционально дождавшись её обработки).
Голосовые, GIF, видеокружки и карусели работают в реакциях так же, как остальные блоки, и попадают в быструю рассылку реакции (см. Рассылки).
Блоки перетаскиваются. Режим показа блоков: «По порядку» или «Случайно» (для вариативных ответов). Главное меню бота можно оставить без изменений, задать новое или спрятать.
Опции блока
У текстовых и медиа-блоков есть флаги: закрепить, без звука, защита от пересылки, спойлер, без превью ссылок, автоудаление через N секунд.
Inline-кнопки
В блоке настраиваются кнопки (Текст кнопки + Тип):
- Текст: отправляет надпись как пользовательский ответ. В Telegram и VK это reply-клавиатура: нажатие может ответить на вопрос или запустить реакцию по тексту. В WhatsApp, Instagram, Messenger и веб-виджете используется кнопка ответа без постоянной клавиатуры.
- Ссылка: открывает URL.
- Веб-приложение: открывает Telegram Mini App. См. Mini App.
- Вызов реакции: нажатие запускает другую реакцию.
- Inline-запрос: вставляет «@бот запрос» в поле ввода текущего чата или предлагает выбрать другой чат (
switch_inline_query/switch_inline_query_current_chat). Доступен только в Telegram после включения inline-режима у @BotFather через/setinline. GetMyBot не отвечает на такие запросы (answerInlineQueryне реализован), поэтому кнопка лишь готовит текст запроса, но не выполняет поиск. - Заготовленный текст: кнопка-ссылка на
https://t.me/<бот>?text=…– открывает чат с ботом и кладёт текст в поле ввода, ничего не отправляя (prefill). - Ссылка оплаты: открывает обязательный платёжный URL. Сам платёж создаётся действием «Создать платёж». Это переход на внешнюю страницу оплаты, а не нативный счёт Telegram.
- Уведомление: показывает текст при нажатии, не запускает реакцию и не передаёт сохранённые данные кнопки (Carry). В Telegram это короткое уведомление или всплывающее окно до 200 символов, в VK – короткая плашка до 90 символов без окна.
Текст или заготовка
| Задача | Тип и настройка | Результат нажатия |
|---|---|---|
| Выбрать «Да» в анкете | «Текст», надпись «Да»; сообщение должно ждать ответ | Ответ «Да» передаётся шагу диалога |
| Подготовить обращение | «Заготовленный текст», надпись «Написать», заготовка «Хочу сделать заказ» | В поле ввода чата с ботом появляется черновик; пользователь редактирует и отправляет его сам |
Надпись на кнопке и текст заготовки – разные поля. Заготовка не отправляет сообщение и не запускает реакцию сама по себе.
У кнопки «Вызов реакции» нажатие передаётся боту как отдельное событие. В техническом описании это событие называется callback. У кнопок «Inline-запрос» и «Заготовленный текст» такого события нет: они выполняют действие в приложении Telegram, поэтому не поддерживают ни ответ answerCallbackQuery, ни передачу данных Carry.
Иконка и цвет кнопки
Перед текстом кнопки можно показать премиум-эмодзи. В поле иконки укажите его ID (icon_custom_emoji_id), положительное 64-битное целое число. Например, 007 читается как 7. Буквы, ноль, отрицательное или слишком большое число отбрасываются: кнопка сохранится без иконки.
Telegram показывает такую иконку только у ботов с нужными правами: дополнительным именем через Fragment либо Telegram Premium у владельца при прямой отправке в личный чат или группу. У остальных Telegram игнорирует иконку, не заменяя её обычным эмодзи.
Стиль задаёт цвет: «Обычная» без цвета, «Основная» синяя, «Успех» зелёная, «Опасная» красная. Техническое поле называется style.
«Одноразовая» (single_use) разрешает использовать сохранённые данные кнопки только один раз. Она подходит, например, для подтверждения выбора. Изменение надписи и удаление сообщения настраиваются отдельно, в поведении при нажатии.
Флаги кнопок
Флаг – дополнительная настройка, которую включают или выключают галочкой. В редакторе показаны:
- С новой строки: переносит кнопку в следующий ряд.
- Растянуть на всю ширину: размещает кнопку в отдельном ряду; следующая кнопка также начинает новый ряд.
Схема предполагаемого вида (квадратные скобки обозначают кнопки):
Один ряд: [Каталог] [Помощь]
С новой строки: [Каталог]
[Помощь]
На всю ширину: [ Помощь ]
Ряды и цвета доступны в Telegram и VK. Расположение кнопок по рядам сохраняется при повторном открытии и редактировании. Премиум-эмодзи Telegram доступны только при совместимом подключении. Переключателя «Открывать внутри Telegram» нет: Bot API не позволяет управлять этим поведением через такой флаг.
Ограничения каналов
Выберите подключение для блока или отдельной кнопки. Для «Всех каналов» редактор использует пересечение возможностей. Неподдерживаемый тип нельзя сохранить.
- Telegram: URL, Mini App, реакция, уведомление/alert, ряды, цвета и custom emoji (при наличии прав у бота).
- VK: URL, реакция, snackbar, ряды и цвета. VK Mini App и VK Pay доступны только при выборе совместимого VK-подключения.
- WhatsApp: одна URL-кнопка CTA без других кнопок в том же сообщении. Кнопки ответа: до 3 обычных, от 4 до 10 показываются списком. Надпись до 20 символов. Ряды, цвета, Mini App и уведомления недоступны.
- Instagram / Messenger: текущий адаптер передаёт только кнопки ответа (quick replies), надпись до 20 символов. URL, Mini App, уведомления, ряды и цвета не поддерживаются.
- Веб-виджет: URL и кнопки ответа, без рядов, цветов и уведомлений.
- Email: ссылки, включая ссылку оплаты; кнопки ответа и уведомления недоступны.
В кнопках, созданных из списка, число колонок можно указать только для каналов с поддержкой рядов. В остальных каналах расположение выбирает сам канал. Лимиты количества кнопок и длины надписей проверяются при отправке.
Поведение при нажатии
Для кнопок, передающих нажатие боту, можно заменить сообщение текстом или содержимым другой реакции, удалить сообщение, поставить метку или сохранить параметр, если канал поддерживает соответствующее действие. Замена текста самой кнопки после нажатия доступна только в Telegram: например, изменить «Записаться» на «Выбрано». Поддержка редактирования сообщений в VK не включает изменение надписи кнопки.
Telegram ждёт подтверждения нажатия от бота, вызова answerCallbackQuery. Обычно GetMyBot отправляет его сам и убирает индикатор загрузки на кнопке. Настройка «Пропустить answerCallbackQuery» отключает это подтверждение.
В поле «Текст при нажатии» у кнопки «Реакция» можно написать короткое подтверждение, например «Занятие выбрано» (Telegram: до 200 символов, VK: до 90; подстановки работают). Обычно Telegram покажет его ненадолго поверх чата. Флаг «Показывать как всплывающее окно» доступен только в Telegram и откроет окно с подтверждением (answerCallbackQuery с show_alert). Если текст пустой, бот только уберёт индикатор загрузки. При включённом «Пропустить answerCallbackQuery» ни текст, ни окно не отправляются.
Параметры в кнопке (Carry)
Carry помогает кнопке запомнить, к чему она относится. Например, у пальто и платья одинаковая кнопка «Купить». У первой сохраните product_id=101, у второй product_id=102. При нажатии на платье следующая реакция получит {{ctx.product_id}} со значением 102.
В редакторе настройка называется «Данные при нажатии». Ключ задаёт имя значения, а значение может быть числом, текстом или подстановкой. Бот запоминает его при отправке сообщения, а при нажатии помещает во временные данные реакции (ctx). Для каждой кнопки значения отдельные.
Срок действия (ttl_seconds, TTL) задаётся в секундах: 3600 означает час. 0 выбирает срок по умолчанию, 30 дней. После окончания срока данные недоступны. «Одноразовая» (single_use) удаляет данные уже после первого нажатия. Сохранённая цена сама не обновляется при изменении каталога: перед оплатой проверяйте актуальную цену по ID товара.
Пошаговая настройка и отличие от постоянных параметров: Динамические кнопки и параметры.
Динамические кнопки
Если товары или занятия уже есть в списке, не добавляйте кнопки вручную. Блок «Динамические кнопки из списка» создаёт по кнопке на каждый элемент. Укажите, где лежит список в ctx, как назвать один элемент (псевдоним), сколько кнопок поставить в ряд и как выглядит шаблон. Например, {{item.name}} вставит название очередного товара. Подробнее: Динамические кнопки и параметры.
Премиум-эмодзи в тексте
В текстовом блоке кнопка форматирования «Премиум-эмодзи» вставляет <tg-emoji emoji-id="…">🙂</tg-emoji>: у Telegram Premium вместо запасного эмодзи в теге покажется кастомный, у остальных получателей – сам запасной эмодзи. Работает и в HTML-, и в Markdown-формате блока. ID эмодзи – число до 32 цифр; узнать его можно через getCustomEmojiStickers или переслав сообщение с нужным эмодзи боту вроде @idstickerbot.
Ссылка на бота и заготовленный текст
Ссылка t.me/<бот>?start=<параметр> запускает команду /start <параметр> в Telegram. Открыть чат с параметром, но без команды /start, через такую ссылку нельзя. Выберите подходящий вариант:
- Молчаливый /start: у реакции на триггер «Команда /start» с нужным значением Метка в ссылке запуска действие «Отправить сообщение» можно оставить без блоков – заметного ответа на сам
/startне будет, а значение метки уже доступно в контексте события и его можно использовать в условиях и других действиях той же реакции. - Заготовленный текст: ссылка
https://t.me/<бот>?text=<текст>(кнопка «Заготовленный текст» или обычная кнопка-ссылка) открывает чат и кладёт текст в поле ввода, ничего не отправляя;/startпри этом не срабатывает, отправляет сообщение сам пользователь. - Автосообщение «от лица пользователя» при переходе Bot API не даёт сделать в принципе: бот не может отправить сообщение от имени пользователя. Ближайшая замена – deep-link
?start=и реакция, которая сама отвечает нужным текстом от бота.
Ожидаемый ответ (шаги диалога)
Текстовый блок может ждать ответ пользователя. Тогда сообщение становится шагом диалога и ставит сценарий на паузу до ответа. Несколько шагов подряд образуют анкету или мастер прямо в чате.
Тип ожидаемого контента
Бот может ждать конкретный вид ответа: текст, выбор из вариантов (кнопки-варианты), фото, видео, видео-заметку, аудио, документ, голосовое, местоположение, контакт, календарь или кубик. Если пользователь пришлёт не тот тип, шаг считает ответ неподходящим.
Проверка текста
Для текстового ответа можно включить проверку: телефон, e-mail, ссылка, дата, время или соответствие формуле. Например, если ждёте телефон, произвольный текст не будет принят и бот покажет сообщение об ошибке. Проверка формулой использует расширенную формулу, возвращающую пустой текст при успехе и текст ошибки при отказе.
Сохранение ответа
Ответ пользователя можно сохранить в параметр: после чего он доступен в подстановках как {{param.ключ}} и в условиях. Так шаги диалога наполняют мини-профиль клиента.
Если включить «Пропускать вопрос, если параметр уже заполнен», бот использует имеющееся значение. Для вопроса с проверкой email и личным параметром он также может использовать подтверждённый email связанного профиля в виджете, Telegram, VK и WhatsApp. Из профиля автоматически подставляется только подтверждённый адрес; если подходящего значения нет, бот задаст вопрос.
Ошибки, напоминание и таймаут
- Сообщение при ошибке проверки: что показать, если ответ не прошёл валидацию.
- Напоминание: что отправить, если пользователь молчит.
- Снятие ожидания по таймауту: через сколько перестать ждать; при таймауте можно запустить реакцию (например, мягко завершить анкету). Эта реакция видна в связях как «Таймаут ожидания», а реакция на сам ответ: как «Ожидаемый ответ».
Выход из шага командой
/cancel или слово «отмена» снимают ожидание и отвечают «Отменено.» (или запускают реакцию отмены, если она задана). Остальные команды по умолчанию считаются ответом и проходят проверку, как любой текст: так шаг может удерживать пользователя, пока он не ответит. Если включить «Команды бота (например, /start) прерывают ожидание» (escape_on_command), любая команда – например, /start посреди анкеты – молча снимет ожидание и выполнится как обычно.
Подстановки
Кнопка «Подстановки» вставляет переменные: данные отправителя ({{first_name}}, {{username}}, {{user_id}}), события ({{text}}, {{chat_id}}, {{datetime}}) и параметры ({{param.ключ}}). Полный список и формулы: Подстановки и формулы.
Кнопка меню бота
Действие Кнопка меню выбирает обычное меню бота, команды или кнопку Mini App с текстом и URL. Область действия: текущий чат или общая настройка бота. Например, задайте персональную Mini App только текущему клиенту. Доступность зависит от возможностей канала.
Что дальше
- Подстановки и формулы: переменные в текстах и кнопках.
- Действия: другие действия реакции.
- Mini App: кнопка веб-приложения.