Show/Hide Toolbars

Руководство администратора

Чат-бот для интеграции с Telegram

Ссылки Назад Вверх Вперед

Внешний пользователь использует Telegram и создает в нем чат для общения с сотрудником "Первой Формы". Сотрудник создает задачу в "Первой Форме", чтобы вести переписку и хранить в системе историю сообщений. Для интеграции между чатом Telegram и задачей в "Первой Форме" используется чат-бот: его нужно добавить как участника в чат Telegram и в задачу в "Первой Форме", и тогда он будет дублировать сообщения между двумя этими каналами. Сотрудник "Первой Формы" может отправлять сообщения как из "Первой Формы", так и из чата Telegram.

Таким образом:

все пользователи используют для общения удобный и доступный канал,

в системе сохраняется история переписки в привязке к конкретной обсуждаемой задаче.

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

При публикации сообщения делается попытка распознать автора. Если в системе есть учетная запись пользователя с таким ником в Telegram, то сообщения будут публиковаться в "Первой Форме" от имени конкретного пользователя. Если же в системе нет подходящей учетной записи (т.е. это внешний пользователь), то сообщения будут публиковаться от имени служебного пользователя, назначенного на роль чат-бота.

Порядок действий

В Telegram

1.Создайте чат-бот. Узнайте его ID и токен для аутентификации. В скрипте ниже подставьте его ID вместо tlgChatBot, а токен — вместо tlgToken.

2.Добавьте созданный чат-бот в качестве участника в нужный чат.

В "Первой Форме"

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

2.Создайте и сделайте активной публикацию, которая будет дублировать сообщения (или выполнять другие нужные действия). Настройте доступ к публикации — включите флажки Виден всем и Включить анонимный доступ.

3.Установите боту WebHook на адрес указанной публикации в формате: https://api.telegram.org/bot[токен телеграм бота]/setWebhook?url=[адрес публикации]

Объекты и настройки

Публикация

Публикация имеет тип POST и единственный входящий параметр requestBody. 

Пакет действий для публикации содержит два смарт-действия:

1. HTTP ответ

Параметр

Значение

Тип возвращаемого результата

JSON

Тело ответа

{"ok":200}

Код ответа

OK

Заголовки

-

Файл

-

2. Выполнить Lua скрипт

Параметр

Значение

Lua скрипт

Отправить комментарий в 1Ф чат

Полезные ссылки