Telegram

Содержание:

• Действия
  • Отправка сообщения
  • Отправка фото
  • Отправка документа
• Триггеры
• Подключение
  • Подключение существующего бота
  • Подключение нового бота

Действия

Отправка сообщения

Для отправки необходимо заполнить ID чата, текст сообщения и указать подключение.

ID чата (chat_id) - это уникальный идентификатор чата пользователя в Telegram. Узнать ID чата с пользователем может владелец бота, на которого подписан пользователь, при условии, что пользователь отправил хотя бы одно сообщения боту. Получить ID чата можно, например, через модуль Webhook (см. раздел ниже - Триггеры).

Так же Вы можете выбрать ID чата "ApinitaBot" для получения сообщений в подключенный Телеграм в разделе настройки уведомлений. Подключение при этом способе выбирать не нужно.

Отправка фото

Для отправки необходимо заполнить ID чата, путь до фото и подпись (не обязательно). Путь до фото может быть внешним (в виде URL-ссылки), локальным, полученным через Webhook или в виде file_id, если фото было загружено ранее в чат Телеграм. Подробнее о способах отправки фото.

Отправка документа

Для отправки необходимо заполнить ID чата, путь до документа и подпись (не обязательно). Путь до документа может быть внешним (в виде URL-ссылки), локальным, полученным через Webhook или в виде file_id, если файл был загружен ранее в чат Телеграм. Подробнее о способах отправки документов.

Триггеры

Телеграм может отправлять событие в момент написания сообщения пользователем в бот. Для получения сообщения (а так же chat_id пользователя) в APInita необходимо создать сценарий с первым шагом Webhook, а полученный URL задать в Вашем боте, перейдя по следующей ссылке в браузере:

https://api.telegram.org/bot{bot_id}/setWebhook?url={webhook_url}

- где {bot_id} это токен Вашего бота, а {webhook_url} это URL, полученный при создании Webhook в APInita. Если у Вас нет бота/токена бота, Вы можете создать его (см. раздел ниже - Подключение).

Подключение

Подключение существующего бота

Если у Вас уже есть токен бота - создайте подключение в APInita с типом "Custom", в качестве ключа укажите "bot_id", а значение вместо "12345" - токен Вашего бота, так же установите галочку "Передавать в запросе":

Подключение нового бота

Для создания бота у Вас должно быть установлено приложение Телеграм (https://telegram.org) на мобильном и/или десктопном ПК. Производить настройку удобнее с ПК.

Открываем Telegram и в строке поиска (1) вводим "BotFather":

В окне ввода (1) введите команду "/new_bot" (2) и нажмите Enter:

Далее в том же окне (1) введите название Вашего бота (3), например "Flowers" или любое другое имя (позже его можно будет изменить). После ввода имени - введите название ссылки для бота (4): название должно быть на латинице и в конце указано Bot или _bot, например - FlowersApinitaBot. В дальнейшем Вы сможете отправлять данную ссылку, например, своим клиентам в виде: http://t.me/FlowersApinitaBot

После ввода ссылки бот будет создан, скопируйте полученный токен (5 - bot_id) и вставьте в подключение созданное в APInita (см. раздел выше - Подключение существующего бота).