Клавиатура

К сообщению можно прикреплять кнопки, удалять их и менять местами. Текст отображается по центру кнопки и обрезается, если не помещается полностью при текущем размере экрана.

Клавиатура в сообщении

Кнопки можно перемещать между собой в строке и между строк с помощью зажатия левой кнопкой мыши или долгим зажатием на мобильном устройстве.

Типы кнопок

Текстовая кнопка

Нажатие на нее выполнит переход к следующему шагу в боте.

Кнопка-ссылка

Позволяет перейти по ссылке, указанной в настройках данной кнопки.

Стандартная клавиатура

По умолчанию, клавиатура показывается под полем ввода в диалоге с пользователем.

Стандартная клавиатура

При нажатии на кнопку стандартной клавиатуры в чат с пользователем отправляется сообщение с текстом данной кнопки от его имени.

Если установить опцию Скрыть клавиатуру после нажатия, то стандартная клавиатура будет скрываться после нажатия на кнопку.

Если в момент прохождения пользователем бота ему пришло сообщение из массовой рассылки, кнопки от бота сохранятся.

Если в момент прохождения пользователем бота ему пришло сообщение от другого бота, кнопки от первого бота будут заменены.

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

Клавиатура с кнопками может быть скрыта. Чтобы ее показать, нужно нажать на кнопку с четырьмя точками.

Показать клавиатуру Telegram

Особенности стандартной клавиатуры:

  • Располагается под формой для ввода сообщения

  • Удаляется после получения нового сообщения от бота с включенной галочкой - Удаление клавиатуры

  • Скрывается под иконкой с четырьмя точками (можно не заметить эту иконку и потерять клавиатуру)

Клавиатура внутри сообщения

Inline-клавиатура (или inline-кнопки) - это клавиатура, которая показывается под определенным сообщением.

Клавиатура внутри сообщения

Особенности Inline-клавиатуры:

  • Располагается под определенным сообщением

  • Cохраняется в истории сообщений

  • При нажатии на кнопку текст с нее не отправляется

  • Можно использовать кнопку-ссылку с отслеживанием переходов по ссылке и выполнением дальнейших шагов после перехода

  • Не скрывается (с одной стороны это плюс - ее нельзя не заметить, с другой стороны - на эти кнопки можно нажимать бесконечное количество раз)

  • Удалить данные кнопки можно только путем удаления отправленных сообщений

  • Отправленные сообщения, содержащие такие кнопки, можно изменять

Скрытие клавиатуры после нажатия

Опция Скрыть клавиатуру после нажатия позволяет убрать клавиатуру в значок в виде 4-х точек, чтобы она не мешала пользователю.

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

Переменные

В тексте кнопок можно использовать глобальные или пользовательские переменные.

Пример кнопки, которая содержит переменную

Удаление старых кнопок

Можно удалить старые кнопки у всех пользователей только путем удаления отправленных сообщений, которые были отправлены не более 48 часов назад.

Не работают кнопки

Если бот не реагирует на нажатие кнопок, выполните автоматическую настройку в разделе Настройки - вкладка Подключение. Это должно решить проблему, так как в редких случаях перестает работать API Callback Telegram, из-за этого сервис не получает информации о нажатии на кнопки.

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

Автоматическая настройка подключения TG

Полезные материалы

Источник информации по клавиатуре в документации Telegram

Last updated