Telegram Bot API
Базовые понятияПрежде всего ответим на вопрос "Зачем вообще нужно обращаться к Telegram API"?
Благодаря использованию API можно расширить функционал чат-бота, так как на платформе доступны не все форматы взаимодействия с пользователями.
Например, благодаря использованию API вы можете запросить геолокацию пользователя, закрепить сообщение в чате, отправить галерею файлов и т.д. А некоторые проекты без использования вешних запросов реализовать в целом невозможно.
Работа с внешними запросами является low-code разработкой, которой мы обучаем на курсе "Разработчик PRO" 😎
А теперь рассмотрим базовые составляющие.
1. Для работы с запросами к API TG вам понадобится блок HTTP-запрос на платформе Leadtex.
При работе с данным блоком вы можете:
- Отправлять запрос к серверу в форматах URL и Json;
- Получать ответ от сервера и выводить его в чат, для этого воспользуйтесь ползунком "выводить тело ответа в чат" (это важно для проверки успеха отправки запроса и при анализе выходных данных);
- Отправлять в запросе данные контакта;
- Сохранять данные из ответа сервера в переменные с помощью функции "Записать ответ json в переменные";
- Обрабатывать ответ сервера с помощью JavaScript.
2. Запрос к Telegram Bot Api можно отправлять в 4-х форматах:
- Запрос в URL
- application/x-www-form-urlencoded
- application/json (не подходит для загрузки файлов)
- multipart/form-data (для загрузки файлов)
3. Для отправки запроса вам понадобится базовая URL ссылка: https://api.telegram.org/bot<ТОКЕН>/НАЗВАНИЕ_МЕТОДА
Токен присваивается всем ботам в процессе создания в @BotFather. Получить его можно, кликнув по необходимому боту, в разделе "API Token".
Крутая фишка. Когда вы работаете с токеном на платформе Leadtex, сохраните его в глобальную переменную, чтобы не менять все настройке вручную, в случае, если будет необходим перевыпуск токена. В строке запроса глобальная переменная считывается корректно :)
Название метода - это то самое действие, которое мы хотим совершить, например: отправить сообщение, получить геопозицию, отправить фото, получить мобильный телефон пользователя и т.д. Всего в Telegram API представлено 78 доступных методов 😎
Ознакомиться со всеми можно в документации мессенджера, в разделе "Available methods".
Каждый из методов включает в себя ряд параметров, которые встраиваются во внешний запрос. Мы разобрали основные базовые понятия, а более подробно работу с различными методами мы разберем в следующих постах.
На связи была LEAD Академия! Надеемся, что было полезно 😉