Отправьте желаемый идентификатор бота. Он должен быть уникальным среди всех существующих ботов в Telegram и заканчиваться на “bot”. Например, My_new_telegram_bot_username_bot.

⁠

Если отправленный идентификатор бота соответствует требованиям, вы получите сообщение об успешном создании бота. В сообщении будет указана ссылка на вашего бота в Telegram и токен доступа к боту.

⁠

Скопируйте в удобное место токен доступа.

⁠

Настроить аватар, описание, и прочие параметры бота вы можете через бота BotFather.

На этом конфигурация

@Бот⁠

а в Telegram завершена.

2. Конфигурация канала агента в Платформе

⁠

@Агент⁠

у необходимо создать и настроить

@Канал Агента⁠

с коннектором “Telegram”.

Войдите в меню редактирования (Edit) настроек

@Агент⁠

а.

⁠

В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:

выберите тип канала Messaging.

Нажмите кнопку Add another channel.

⁠

Интеграция с Telegram происходит через

@Коннектор⁠

с названием “Telegram”, установите его в поле Channel.

⁠

По необходимости пропишите заголовок для данного

@Канал Агента⁠

в поле Title.

⁠

После выбора

@Канал Агента⁠

вам станет доступно для записи поле Token, в которое нужно вставить

предварительно скопированный токен⁠

⁠

Активируйте

@Канал Агента⁠

переключением тумблера для того, чтобы

@Агент⁠

начал отвечать в нем после сохранения.

⁠

Если

@Агент⁠

не был обучен, появится предупреждение. В таком случае необходимо обучить

@Агент⁠

а, после чего повторить попытку активации

@Канал Агента⁠

⁠

После активации

@Канал Агента⁠

, если есть проблемы с его доступностью, будет выведено предупреждение (

@Канал Агента⁠

будет активирован несмотря на проблемы):

"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL

⁠

”Couldn’t register agent webhook” — выводится в случае, если не удалось зарегистрировать вебхук в удаленном канале.

⁠

Сохраните

@Канал Агента⁠

— нажмите Save.

Все настройки будут применены только после сохранения

Общение

Общение в групповых чатах Telegram

⁠

@Бот⁠

может быть добавлен в групповой чат Telegram и обрабатывать сообщения и события этого чата.

Чтобы

@Бот⁠

обрабатывал все сообщения, отправляемые в группу, необходимо обеспечить ему доступ ко всем сообщениям, выключив настройку Group Privacy:

Перейти в BotFather;

Написать команду /mybots;

Выбрать нужного

@Бот⁠

а;

Перейти в Bot Settings → Group Privacy;

Выбрать Turn off.

При включенной настройке Group Privacy, чтобы отправить сообщение, которое будет обработано

@Агент⁠

ом и записано в

⁠

, нужно либо ответить на сообщение

@Бот⁠

а (reply), либо написать свое сообщение после символа / .

После каждого обработанного сообщения, в

@Канальные переменные⁠

будут установлены данные участника группы, отправившего сообщение.

Также,

@Агент⁠

обрабатывает события о добавлении в групповой чат новых пользователей. При этом в переменную

⁠

будет записана строка вида “telegram_chat_new_member: telegram_user_id|telegram_username|telegram_first_name|telegram_last_name” .

При обновлении группы до супергруппы генерируется новый идентификатор группы и

@Агент⁠

не может отправить сообщение.

Сервисные сообщения из Telegram

Сервисные сообщения из Telegram

Сообщение

Конечный канал

Client message

Описание

Пользователь группы телеграм присоединился в группу

Строка: telegram_chat_new_member: {user.id}|{user.first_name}|{user.last_name}

При присоединении пользователя к группе Telegram в

@Контекстная переменная

⁠

@client_message

⁠

передается сообщение в соответствии с шаблоном

Пользователь группы телеграм покинул в группу

Строка: telegram_member_left_chat: {user.id}|{user.first_name}|{user.last_name}

При выходе пользователя из группы Telegram в

@Контекстная переменная

⁠

@client_message

⁠

передается сообщение в соответствии с шаблоном

There are no rows in this table

⁠

О том, что такое сервисные сообщения и как активировать их передачу из

@Конечный канал⁠

Принцип вывода Агента в различные каналы⁠

⁠

Маппинг Канальных переменных из канала Telegram

Маппинг Канальных переменных из канала Telegram

Канальная переменная

Конечный канал

Переменная в теле входящего запроса из канала

Особенности

channel_visitor_id

При ответе на сообщение бота в групповом чате, в переменную записывается id ответившего юзера

channel_conversation_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

channel_message_id

channel_reply_to

reply_to_message.text

Если

@Сообщение собеседника

⁠

не является ответом (Reply) на сообщение

@Бот

⁠

а в Telegram, то переменная остается пустой

There are no rows in this table

⁠

Возможности общения в канале Telegram

Возможности общения в канале Telegram

Функционал

Конечный канал

Наличие в канале

Описание

channel_chat_id

Да

Формат: channel_visitor_id|telegram

Сообщения дойдут до собеседника, если агент напишет первый в существующем чате

Да

Перевод на оператора

Нет

В мессенджере нет такого функционала

Кнопки

Да

Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )

Да

Файл будет передан ссылкой, если он не удовлетворяет требованиям Telegram к файлам данного типа.

Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )

Да

⁠

Telegram может принимать и предавать собеседникам вложения типа “file” только форматов gif, pdf и zip. Возможна поддержка других форматов, но Telegram её не гарантирует.

⁠

При попытке передать изображение в слоте

@Attachment

⁠

, если указана ссылка на файл из Telegram, то файл придет в виде ссылки, а не изображения

Получение файла от Собеседника в сценарий

Да

@client_message

⁠

записывается строка вида file:Тип файла|ID файла|Ссылка на файл, например, file:photo|HgYjJJGYuxkBAAMNYK1eZR1fbZv-KQ09Omcsz9A8AjwAAsSzMRtug3FJ079jiwXcvo-egdKiLgADAQADAgADeAADE7gCAAEfBA|https://api.telegram.org/file/bot1815753186:AAH_LtRWy_FSDAGFgstlTaQdkHHIFHV3xGI/photos/file_0.jpg . При этом, файл будет доступен по ссылке в течение 24 часов. Для получения файла в дальнейшем потребуется обновить ссылку на файл, используя

Telegram API

⁠

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

Да

@client_message

⁠

записывается строка вида location:Широта|Долгота, например, location:83.000000|54.000000

Доставка сообщений более 1000 символов от Агента до Собеседника

Да

Допускаются сообщения до 4096 символов

Использование маркдауна

Да