Настройка интеграции с чат-ботом Telegram

Интеграция Итилиум с чат-ботом Telegram позволяет пользователю с ролью «Потребитель услуг» регистрировать обращения, просматривать результат своего обращения, подтверждать, уточнять, вносить изменения в обращение.
Процесс работы с обращениями при помощи чат-бота Telegram представлен в видео.
Примечание
Перед настройкой должны быть выполнены следующие условия.

1. На web-сервере «1С:Предприятия» должен быть открыт порт 80 или 443 для приема сообщений из сервиса heroku (он транслирует обращения в Итилиум из Telegram) для входящих соединений.

2. Должен быть доступен ресурс api.telegram.org c каждого сервера кластера серверов «1С:Предприятия».

Для регистрации телеграм-бота необходимо в Telegram зайти на канал @BotFather и написать "/newbot". После этого BotFather предложит ввести название бота и имя пользователя для аккаунта бота. Название будет отображаться в окне диалога с ботом, а имя пользователя будет использоваться для ссылки на бота. После ввода названия и имени пользователя BotFather вернет token, его необходимо скопировать и сохранить для дальнейшей настройки.

Создание чат-бота

07-07_01

Далее необходимо развернуть web-приложение чат-бота Telegram. Для этого необходимо опубликовать информационную базу на веб-сервере, на вкладке «HTTP сервисы» установить флаг «TelegramAPI».

Публикация на веб-сервере

07-07_02

На следующем шаге необходимо в опубликованной информационной базе в разделе «Администрирование и настройки» выбрать «Параметры системы», в настройках ИБ указать полученный код в строке активации и дату окончания лицензии для Telegram.

Настройка в параметрах системы

05

Далее в параметрах системы во вкладке «Прочие настройки» необходимо нажать на кнопку «Настройка Telegram-бота». В открывшемся окне необходимо вставить токен Telegram-бота, полученный на этапе регистрации бота.

Листайте скриншоты: настройка Telegram-бота (рис. 1), токен Telegram-бота (рис. 2)

07-07_04
07-07_05

Для распознания чат-ботом пользователя с ролью «Потребитель услуг», у него необходимо сгенерировать идентификатор подписчика для мессенджера. Для этого необходимо в справочнике «Пользователи информационной базы нажать кнопку «Сгенерировать».

Справочник «Пользователи ИБ»

07-07_16

Вариант 1. Настройка чат-бота с помощью сервиса Postman

Скачайте программу Postman по ссылке: https://www.postman.com/. После установки можно либо создать аккаунт, либо пропустить его создание.

1

Затем на вкладке «Overview» в разделе «Get started» нажмите «Create a request».

2

Следующим шагом будет отправка POST-запроса через Postman.

Для этого нужно выполнить следующие шаги.

Шаг 1. Выбрать вид запроса «POST».

Шаг 2. Ввести адрес запроса.

Например:

3

Шаг 3. На вкладке «Headers» задать для параметра «Content-Type» значение application/json.

4

4. На вкладке «Body» установить переключатель в значение raw и указать строку:

{"url":"https://ЛогинПользователя1С:ПарольПользователя1С@АдресСервера/ИмяПубликации/hs/telegramapi/action"}

5

5. Нажать кнопку «Send». В результате, если все было сделано верно, должно появиться подобное сообщение. Вебхук Telegram установлен.

6

Вариант 2. Настройка Telegram-бота с использованием сервиса Heroku

Зарегистрируйтесь на сервисе Heroku: https://signup.heroku.com/. Заполните все необходимы поля, нажмите кнопку «СREATE FREE ACCOUNT».

Регистрация

07-07_06

На почту, которая была указана при регистрации, придет письмо с ссылкой подтверждения.

Подтверждение регистрации

07-07_07

Перейдите по ссылке, указанной в письме, создайте пароль.

Важно!
Пароль должен содержать минимум 8 символов (буквы, цифры и символы).

После того как пароль подтвержден и введен корректно, необходимо нажать кнопку «SET PASSWORD AND LOG IN».

Создание пароля

07-07_08

Перейдите по ссылке. Следующим шагом будет создание приложения. Необходимо заполнить поле «Имя приложения», выбрать «регион», нажать кнопку «Deploy app».

Создание нового приложения

07-07_09

После того как приложение успешно развернуто, для перехода на следующий шаг необходимо нажать кнопку «Manage APP».

Приложение успешно развернуто

07-07_10

Далее перейти на вкладку «Settings» и в группе Config Vars следует нажать кнопку «Reveal Config Vars».

Вкладка «Settings» в группе Config Vars

07-07_11

Здесь необходимо добавить ключи и заполнить обязательные реквизиты

Key Value
AddressApiItilium Адрес опубликованного Http-сервиса http://<serverNameOrIp>/<NameBase>/hs/ telegramapi/action
LoginItilium Логин для доступа к Итилиум (латиница)
PasswordItilium
Пароль для доступа к Итилиум
AuthKey Токен созданного бота

 

Добавление ключей и значений

07-07_12

После добавления ключей и заполнения значения необходимо нажать кнопку «More» в верхней части окна, в открывшемся списке выбрать «Restart all dynos».

Кнопка «More» и «Restart all dynos»

07-07_13

Согласиться на появившееся предупреждение и нажать кнопку «Restart all dynos».

Далее для активации созданного приложения на вкладке «Settings» необходимо нажать по ссылке, находящейся в группе «Domains».

Активация приложения

07-07_14

Далее нужно установить вебхук, для этого перейти по ссылке: «Ссылка из предыдущего пункта» + «/setWebHook». В результате если все было сделано верно должно появиться подобное сообщение.

Активация приложения

07-07_15