Вывод Агента в Telegram
В данной статье описан вывод Агента напрямую в Telegram и возможности общения Агента в Telegram.
Telegram - мессенджер, имеющий веб версию, десктоп версию, а также версию для мобильных устройств. Имеет встроенный функционал чат-ботов.
Вывести Агента в Telegram возможно не только напрямую, но и с помощью омниканальных Платформ. В данной статье описан вывод Агента напрямую.
Подключение Агента
Создание бота в Telegram
В первую очередь нужно произвести конфигурацию на стороне Telegram.
Откройте Telegram и авторизуйтесь.
Создайте бота в Telegram:
Отправьте боту BotFather команду /newbot.
Настроить аватар, описание, и прочие параметры бота вы можете через бота BotFather.
На этом конфигурация бота в Telegram завершена.
Конфигурация канала Агента в Платформе
Агенту необходимо создать и настроить Канал Агента с коннектором Telegram.
В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:
выберите тип канала Messaging
Заголовки разных каналов агента могут совпадать.
После активации Канала Агента, если есть проблемы с его доступностью, будет выведено предупреждение (Канал будет активирован несмотря на проблемы):
Сохраните Канал Агента — нажмите Save.
Все настройки будут применены только после сохранения.
Общение
Общение в групповых чатах Telegram
Чатбот может быть добавлен в групповой чат Telegram и обрабатывать сообщения и события этого чата.
Если Telegram-бот НЕ является администратором группы: чтобы отправить сообщение, которое будет обработано Агентом и записано в переменную контекста client_message, нужно либо ответить на сообщение бота(reply), либо написать свое сообщение после символа / .
Если Telegram-бот является администратором группы: Агент обрабатывает все сообщения, отправляемые в чат.
После каждого обработанного сообщения, в Канальных переменных будут установлены данные участника группы, отправившего сообщение.
Также Агент обрабатывает события о добавлении в групповой чат новых пользователей. При этом в переменную client_message будет записана строка вида
“telegram_chat_new_member: telegram_user_id|telegram_username|telegram_first_name|telegram_last_name” .
Сервисные сообщения канала
Из Telegram передаются следующие сервисные сообщения:
| Сообщение | Шаблон сообщения, получаемого в переменной client_message |
|---|---|
Пользователь группы Telegram присоединился в группу | Строка: telegram_chat_new_member: {user.id}|{user.first_name}|{user.last_name} |
Пользователь группы Telegram покинул в группу | Строка: telegram_member_left_chat: {user.id}|{user.first_name}|{user.last_name} |
Маппинг канальных переменных из канала Telegram
| Канальная переменная | Переменная в теле входящего запроса из канала | Особенности |
|---|---|---|
channel_visitor_id | id | При ответе на сообщение бота в групповом чате, в переменную записывается id ответившего юзера |
channel_conversation_id | id | |
channel_visitor_firstname | first_name | |
channel_visitor_lastname | last_name | |
channel_visitor_phone | — | |
channel_visitor_email | — | |
channel_visitor_account | username | |
channel_visitor_auth | — | |
channel_visitor_source | — |
Возможности общения в Telegram
| Функционал | Наличие в канале | Описание |
|---|---|---|
Переменная channel_chat_id | Да | Формат: |
Сообщения дойдут до собеседника, если Агент напишет первый в существующем чате | Да | |
Перевод на оператора | Нет | В мессенджере нет такого функционала |
Кнопки | Да | |
Передача файлов в виде ссылок от Агента (слот Attachment) | Да | Файл будет передан ссылкой, если он не удовлетворяет требованиям Telegram к файлам данного типа. |
Передача файлов в виде файлов от Агента (слот Attachment) | Да | Telegram может принимать и передавать собеседникам вложения типа “file” только форматов gif, pdf и zip. Возможна поддержка других форматов, но Telegram её не гарантирует. Подробнее: https://core.telegram.org/bots/api#sending-files |
Получение файла от Собеседника в сценарий | Да | В переменную client_message записывается строка вида |
Получение геолокации от собеседника в сценарии | Да | В переменную client_message записывается строка вида location:Широта|Долгота, например, location:83.000000|54.000000 |
Доставка сообщений более 1000 символов от Агента до Собеседника | Да | Допускаются сообщения до 4096 символов |
Использование маркдауна | Да | Работает в соответствии с документацией |
Last updated
