Показать уведомление при нажатии кнопки
Действие блок-схемы «Показать уведомление при нажатии кнопки в Telegram» отвечает на нажатие кнопки под сообщением: показывает пользователю короткое уведомление вверху чата или окно с кнопкой «OK». Новое сообщение в переписку не добавляется.
Действие находится в каталоге действий блок-схемы: вкладка «Интеграции», раздел «Телеграм». Работает с ботами Telegram — в личных сообщениях, группах и каналах (кнопки под постами).
Оглавление
Когда использовать
- Подтвердить действие: «Готово! Заявка принята», «Вы записаны на 12:00».
- Ответить на кнопку под постом в канале: «Спасибо за голос!» — в канале бот не может написать пользователю в комментарии, а уведомление увидит только нажавший.
- Сообщить, что кнопка больше не работает: «Акция закончилась».
- Убрать значок загрузки у кнопки. Пока бот не ответил на нажатие, Telegram некоторое время показывает на кнопке часики. Это действие с пустым текстом просто убирает их.
Как настроить
- Отправьте сообщение с кнопками под ним — например, действием «Отправить сообщение» с включённой галочкой «Инлайн кнопки (прикрепить к сообщению)» или действием «Отправить статью в Telegram» с включённой клавиатурой бота.
- Соедините кнопку со следующим блоком (или используйте событие «Нажата кнопка в сообщении (инлайн)»).
- Первым действием в этом блоке поставьте «Показать уведомление при нажатии кнопки в Telegram» и напишите текст уведомления.
- Дальше — любые другие действия: запись в CRM, отправка сообщения и т.д.
Поля
| Поле |
Зачем |
| «Текст уведомления» |
До 200 символов, только обычный текст — без жирного, ссылок и т.п. Переменные работают, например {user:first_name}, готово!. Если оставить пустым, уведомление не покажется, но у кнопки пропадёт значок загрузки. |
| «Показать окном с кнопкой «OK»» |
Без галочки текст появится вверху чата и сам исчезнет через пару секунд. С галочкой — окно посреди экрана, пользователь закроет его кнопкой «OK». Окно подходит для важного или длинного текста. |
| «ID нажатия кнопки» |
Какое нажатие получает ответ. По умолчанию {var:object.callback.id} — нажатие, которое запустило эту ветку схемы. Менять не нужно. |
Важно знать
- Только кнопки под сообщением. Обычные кнопки (вместо клавиатуры телефона) отправляют в чат текст, а не «нажатие», — на них уведомлением ответить нельзя.
- Ответить можно один раз. На одно нажатие — одно уведомление. Второе такое действие в той же ветке завершится ошибкой.
- Отвечайте сразу. Telegram принимает ответ только в первые секунды после нажатия. Ставьте действие в начало ветки, до долгих действий (запросов к ИИ, CRM, таймеров).
- Уведомление видит только нажавший — даже в группе или канале.
- Это не сообщение: оно не попадает в «Диалоги» и не расходует сообщения тарифа.
- Пока только Telegram. Во ВКонтакте и Max действие завершится ошибкой.
Результат и ошибки
Ошибки (текст доступен в {var:error.message}):
Button press ID is empty — пустой ID нажатия: действие запущено не нажатием кнопки под сообщением (например, событием «Новое сообщение»).
Integration with type [...] does not support this effect — контакт не из Telegram.
Bad Request: query is too old and response timeout expired or query ID is invalid — ответ опоздал, на это нажатие уже ответили или ID нажатия неверный.
Что делать, если…
| Симптом |
Причина и что сделать |
Ошибка query is too old |
Перед действием стоят долгие действия или таймер. Перенесите уведомление в самое начало ветки после нажатия. |
Ошибка Button press ID is empty |
Ветку запускает не кнопка под сообщением. Проверьте, что блок соединён с инлайн-кнопкой или с событием «Нажата кнопка в сообщении (инлайн)». |
| Уведомление не появилось, ошибок нет |
Пустой «Текст уведомления» — в этом случае Telegram только убирает значок загрузки у кнопки. Впишите текст. |
| Нужно показать оформленный текст или картинку |
Уведомление поддерживает только обычный текст. Для оформленного ответа отправьте сообщение или статью следующим действием. |