Telegram

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

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

Open

Группы

Созданный канал можно подключить в одну или несколько групп в системе. Если канал будет подключен в несколько групп, то на данный момент выбор группы, куда определить диалог, будет осуществляться через запрос у пользователя - ему нужно будет нажать соответствующую кнопку. Если пользователь не выберет группу, а продолжит диалог с ботом, то диалог определится в основную группу.

Способ получения входящих сообщений

Webhook - сервер Telegram сам возвращает ответ серверу АФ, когда поступает новое событие/сообщение

Longpool - сервер АФ сам опрашивает сервер Telegram о поступлении новых событий/сообщений

Запрос контактных данных

Можно включить функцию бота “Требовать контактные данные”, тогда при обращении пользователя в бот он попросит пользователя представиться, т.е. предоставить свой номер телефона. В Телеграме будет отображаться кнопка “For start, click here”.

Open

Просьба представиться в Телеграм

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

Регулирование количества кнопок в строке

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

• одна

• две

• три

• определять автоматически

Если выбрано значение “автоматически”, то каждый раз система будет определять количество кнопок в зависимости от длины текста на кнопке. При этом она будет комбинировать кнопки, т.е. может получиться так, что в одной строке будет одна кнопка, в другой две, а в третьей три кнопки. При этом еще учитывается порядок кнопок, как они были заданы в сценарии или контекстом документе.

Работа с группами

Есть возможность добавить бота в группу Telegram. В этом случае в стандартном процессе обработки диалогов будут следующие изменения:

1. При отправке любым участником группы сообщения в чат в системе открывается новый диалог. Все последующие реплики ВСЕХ участников чата попадают в этот диалог.

2. Работает стандартное правило склейки диалога. Если во входящих уже есть диалог и его не взяли в работу в течение указанного времени, то при следующей реплике создается новый диалог.

3. В качестве пользователя, на кого зарегистрирован чат в системе, указано название группы в Telegram.

У оператора в окне диалога в работе отображается список участников чата, кто писал сообщения. Отображается имя пользователя и его логин, если указан. Также у каждого сообщения подписан его автор. Аналогично в выгрузке истории запросов в Excel.

Для добавления бота в группу необходимо внести изменения в настройки бот в BotFather:

• выбрать бота в BotFather

• выбрать пункт Настройки (Bot Settings)

• установить настройку Group Privacy в OFF

• установить настройку Allow Groups в ON

Подключение Telegram через https proxy

В работе сервиса AutoFAQ с Telegram есть возможность использования https proxy для исходящих запросов от сервера AutoFAQ до сервера Telegram. Поддерживается прокси сервер с авторизацией и без.

Эта возможность позволяет передавать запросы от АФ в сторону ТГ через прокси. Обратные запросы идут без изменений.

Для подключения необходимо добавить следующие параметры в раздел environment для bot-platform-back:

где:

TELEGRAM_PROXY_HOST - IP адрес хоста с проксей

TELEGRAM_PROXY_PORT - порт на котором прокся слушает АФ

TELEGRAM_PROXY_PORT - логин, указывать только для случаев когда прокся требует авторизации

TELEGRAM_PROXY_PASSWORD - пароль юзера