Начало работы
Чтобы начать, отправьте сообщение @BotFather в Telegram, чтобы зарегистрировать своего бота и получить его токен аутентификации.
Токен вашего бота — это его уникальный идентификатор. Храните его в безопасном месте и делитесь им только с теми, кому нужен прямой доступ к боту.
Создать нового бота можно при помощи команды
/newbot
Документация Telegram Bot API - https://core.telegram.org/bots/apiВсе запросы к API Telegram Bot производятся на адрес следующего формата:
https://api.telegram.org/bot<ТОКЕН>/<МЕТОД>
Ответ содержит объект JSON, который всегда имеет логическое поле «ok» и может иметь необязательное строковое поле «description» с описанием результата.
Telegram поддерживает HTTP-методы GET и POST.
Тип содержимого может быть как x-www-form-urlencoded так и application/json.Ограничения API
- В одном чате не отправляйте более одного сообщения в секунду. Telegram может разрешить кратковременные превышения этого лимита, но в конечном итоге вы начнете получать ошибки 429.
- В группе боты не могут отправлять более 20 сообщений в минуту.
- Что касается массовых уведомлений, боты не могут отправлять более 30 сообщений в секунду, если не включено платное увеличение лимита.
Отправка сообщений в чат бота
Для отправки сообщений HTTP запросом в Телеграм используется метод
sendMessage.Обязательные параметры метода
sendMessage:Параметр | Тип | Описание |
chat_id | Число или строка | Уникальный идентификатор чата или имя пользователя канала (в формате @channelusername) |
text | Строка | Текст отправляемого сообщения. 1-4096 символов |
Обработка команд
В шаблоне необходимо заменить токен, полученный от @BotFather, и ссылку на ваш эндпоинт сценария в последнем действии. Для установки вебхука, необходимо запустить сценарий как минимум один раз (без входящих данных).
Где взять URL эндпоинта сценария?
После установки вебхука можно отправлять боту команды и обрабатывать их сценарием.
Создание меню команд
Чтобы создать набор вариантов команд в чате бота, можно использовать меню команд бота (бот автоматически подскажет пользователю доступные команды) или клавиатуру с кнопками команд.
Меню команд
Меню команд позволяет ботам показывать список доступных команд пользователю.
Если пользователь введет
/ в чате с ботом, ему автоматически предложат установленные команды в выпадающем меню.Для установки меню команд можно использовать метод
set_my_commandsКлавиатура с кнопками команд
Есть возможность использовать ReplyKeyboardMarkup для создания кнопок команд прямо в чате, которые будут отображаться под строкой ввода сообщения. Это особенно удобно, если вы хотите, чтобы пользователь выбирал из предложенных вариантов, не вводя команды вручную.
При отправке команды
/start пользователю предложат эти кнопки под строкой ввода текста.Inline-кнопки с callback_data
Этот подход позволяет задать кнопке данные, которые отправляются боту при нажатии на неё, не посылая текст в чат.
Цепочка вопросов-ответов (квиз)
Для создания цепочки сообщений или квиза в Telegram-боте требуется разработать логику отслеживания состояния диалога с пользователем и отправки соответствующих сообщений в зависимости от его ответов.
Такую функциональность можно реализовать с помощью вспомогательной таблицы для учета сессий. При первом обращении пользователя создается новая сессия, в которую сохраняются ID пользователя, ID чата и текущий этап диалога (или номер вопроса в квизе). При последующих обращениях или ответах этого же пользователя бот использует данные из таблицы, чтобы отвечать в соответствии с текущим этапом диалога.