Функция для добавления кнопок в чат Telegram

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

Telegram поддерживает два вида кнопок: Inline-кнопки (кнопки в тексте) и Reply-кнопки (обычные или клавиатурные). В примерах ниже мы рассмотрим функции для добавления разного вида кнопок в чат.

В первом примере на уровне функции будет реализовано отображение Inline-кнопок.

Каждая Inline-кнопка должна содержать обязательное поле text (текст кнопки) и одно из необязательных полей url или callback_data. Если кнопка содержит только callback_data, при ее нажатии происходит вызов функции и выводится текст из callback_data. Если у кнопки есть url и callback_data, либо только url, кнопка работает как ссылка.

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

Если клиент пишет сообщение Привет. Без клавиатуры, бот клавиатуру с кнопками не показывает.

1. Создайте канал Telegram, как показано здесь.
2. Перейдите в раздел Управление > Функции > Управление.
3. Нажмите кнопку Новая функция.

4. Скопируйте следующий код и вставьте его в функцию.

5. Нажмите Создать.

6. Перейдите в Настройка > Диалоги > Каналы и выберите нужный канал Telegram.
7. В поле Перенаправление сообщений канала выберите Функция.
8. Из раскрывающего списка выберите добавленную ранее функцию.

9. Нажмите Сохранить изменения.

Теперь после приветственного сообщения бот отобразит клиенту клавиатуру с кнопками.

Далее добавим функцию для отображения Reply-кнопок. Это могут быть обычные кнопки или кнопки, содержащие местоположение или контакт.

Предполижим, клиент написал в сервис знакомств Найти друга рядом. По условиям функции, если клиент пишет сообщение Привет, бот выводит клавиатуру с кнопками:

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

По условиям функции, если сообщение клиента содержит Без клавиатуры, бот клавиатуру не показывает.

Информацию по опциональным настройкам клавиатуры можно посмотреть здесь.

10. Перейдите в раздел Управление > Функции > Управление.
11. Нажмите кнопку Новая функция.

12. Скопируйте следующий код и вставьте его в функцию.

13. Нажмите Создать.

14. В настройках канала Telegram в поле Перенаправление сообщений канала выберите Функция.
15. Из раскрывающего списка выберите добавленную функцию.

16. Нажмите Сохранить изменения.

Теперь после приветственного сообщения бот отобразит клиенту клавиатуру с кнопками.

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