Настройка интеграции с чат-ботом Telegram
1. На web-сервере «1С:Предприятия» должен быть открыт порт 80 или 443 для приема сообщений из сервиса heroku (он транслирует обращения в Итилиум из Telegram) для входящих соединений.
2. Должен быть доступен ресурс api.telegram.org c каждого сервера кластера серверов «1С:Предприятия».
Для регистрации телеграм-бота необходимо в Telegram зайти на канал @BotFather и написать "/newbot". После этого BotFather предложит ввести название бота и имя пользователя для аккаунта бота. Название будет отображаться в окне диалога с ботом, а имя пользователя будет использоваться для ссылки на бота. После ввода названия и имени пользователя BotFather вернет token, его необходимо скопировать и сохранить для дальнейшей настройки.
Создание чат-бота
![07-07_01](/uploads/media/1728x/07/887-07-07_01.jpg?v=1-0)
Далее необходимо развернуть web-приложение чат-бота Telegram. Для этого необходимо опубликовать информационную базу на веб-сервере, на вкладке «HTTP сервисы» установить флаг «TelegramAPI».
Публикация на веб-сервере
![07-07_02](/uploads/media/1728x/08/888-07-07_02.png?v=1-0)
На следующем шаге необходимо в опубликованной информационной базе в разделе «Администрирование и настройки» выбрать «Параметры системы», в настройках ИБ указать полученный код в строке активации и дату окончания лицензии для Telegram.
Настройка в параметрах системы
![05](/uploads/media/1728x/05/1045-05.png?v=1-0)
Далее в параметрах системы во вкладке «Прочие настройки» необходимо нажать на кнопку «Настройка Telegram-бота». В открывшемся окне необходимо вставить токен Telegram-бота, полученный на этапе регистрации бота.
Листайте скриншоты: настройка Telegram-бота (рис. 1), токен Telegram-бота (рис. 2)
![07-07_04](/uploads/media/1728x/01/891-07-07_04.png?v=1-0)
![07-07_05](/uploads/media/1728x/00/890-07-07_05.png?v=1-0)
Для распознания чат-ботом пользователя с ролью «Потребитель услуг», у него необходимо сгенерировать идентификатор подписчика для мессенджера. Для этого необходимо в справочнике «Пользователи информационной базы нажать кнопку «Сгенерировать».
Справочник «Пользователи ИБ»
![07-07_16](/uploads/media/1728x/02/902-07-07_16.png?v=1-0)
Для массовой генерации идентификаторов подписчиков можно воспользоваться обработкой «Универсальный подбор и обработка объектов», которая доступна в меню «Функции для технического специалиста».
![1 (1)](/uploads/media/1728x/03/1143-1%20%281%29.png?v=1-0)
![1 (2)](/uploads/media/1728x/04/1144-1%20%282%29.png?v=1-0)
Шаг 1. Необходимо выбрать справочник «Пользователи ИБ» и нажать «Вперед».
![03](/uploads/media/1728x/09/1139-03.png?v=1-0)
Шаг 2. Необходимо отобрать пользователей, для которых нужно сгенерировать идентификатор подписчика, и нажать «Вперед».
![04](/uploads/media/1728x/00/1140-04.png?v=1-0)
Шаг 3. Необходимо добавить действие «Установка реквизитов» и в параметрах этого действия для реквизита «Идентификатор подписчика для мессенджеров» выбрать значение «Создать»
![05](/uploads/media/1728x/01/1141-05.png?v=1-0)
После этого нужно нажать на кнопку «Выполнить» в обработке и идентификаторы подписчиков будут созданы для всех отобранных на шаге 2 пользователей.
После этого при помощи механизма массовой рассылки можно разослать сгенерированные идентификаторы пользователям, выбрав в шаблоне сообщения тег: %идентификатор_подписчика_для_месенджеров%.
![06](/uploads/media/1728x/02/1142-06.png?v=1-0)
Вариант 1. Настройка чат-бота с помощью сервиса Postman
Скачайте программу Postman по ссылке: https://www.postman.com/. После установки можно либо создать аккаунт, либо пропустить его создание.
![1](/uploads/media/1728x/04/1054-1.png?v=1-0)
Затем на вкладке «Overview» в разделе «Get started» нажмите «Create a request».
![2](/uploads/media/1728x/06/1056-2.png?v=1-0)
Следующим шагом будет отправка POST-запроса через Postman.
Для этого нужно выполнить следующие шаги.
Шаг 1. Выбрать вид запроса «POST».
Шаг 2. Ввести адрес запроса.
Например:
![3](/uploads/media/1728x/07/1057-3.png?v=1-0)
Шаг 3. На вкладке «Headers» задать для параметра «Content-Type» значение application/json.
![4](/uploads/media/1728x/08/1058-4.png?v=1-0)
4. На вкладке «Body» установить переключатель в значение raw и указать строку:
{"url":"https://ЛогинПользователя1С:ПарольПользователя1С@АдресСервера/ИмяПубликации/hs/telegramapi/action"}
![5](/uploads/media/1728x/09/1059-5.png?v=1-0)
5. Нажать кнопку «Send». В результате, если все было сделано верно, должно появиться подобное сообщение. Вебхук Telegram установлен.
![6](/uploads/media/1728x/05/1055-6.png?v=1-0)
Вариант 2. Настройка Telegram-бота с использованием сервиса Heroku
Зарегистрируйтесь на сервисе Heroku: https://signup.heroku.com/. Заполните все необходимы поля, нажмите кнопку «СREATE FREE ACCOUNT».
Регистрация
![07-07_06](/uploads/media/1728x/02/892-07-07_06.png?v=1-0)
На почту, которая была указана при регистрации, придет письмо с ссылкой подтверждения.
Подтверждение регистрации
![07-07_07](/uploads/media/1728x/03/893-07-07_07.png?v=1-0)
Перейдите по ссылке, указанной в письме, создайте пароль.
После того как пароль подтвержден и введен корректно, необходимо нажать кнопку «SET PASSWORD AND LOG IN».
Создание пароля
![07-07_08](/uploads/media/1728x/04/894-07-07_08.png?v=1-0)
Перейдите по ссылке. Следующим шагом будет создание приложения. Необходимо заполнить поле «Имя приложения», выбрать «регион», нажать кнопку «Deploy app».
Создание нового приложения
![07-07_09](/uploads/media/1728x/05/895-07-07_09.png?v=1-0)
После того как приложение успешно развернуто, для перехода на следующий шаг необходимо нажать кнопку «Manage APP».
Приложение успешно развернуто
![07-07_10](/uploads/media/1728x/06/896-07-07_10.png?v=1-0)
Далее перейти на вкладку «Settings» и в группе Config Vars следует нажать кнопку «Reveal Config Vars».
Вкладка «Settings» в группе Config Vars
![07-07_11](/uploads/media/1728x/07/897-07-07_11.png?v=1-0)
Здесь необходимо добавить ключи и заполнить обязательные реквизиты
Key | Value |
---|---|
AddressApiItilium | Адрес опубликованного Http-сервиса http://<serverNameOrIp>/<NameBase>/hs/ telegramapi/action |
LoginItilium | Логин для доступа к Итилиум (латиница) |
PasswordItilium |
Пароль для доступа к Итилиум
|
AuthKey | Токен созданного бота |
Добавление ключей и значений
![07-07_12](/uploads/media/1728x/08/898-07-07_12.png?v=1-0)
После добавления ключей и заполнения значения необходимо нажать кнопку «More» в верхней части окна, в открывшемся списке выбрать «Restart all dynos».
Кнопка «More» и «Restart all dynos»
![07-07_13](/uploads/media/1728x/09/899-07-07_13.png?v=1-0)
Согласиться на появившееся предупреждение и нажать кнопку «Restart all dynos».
Далее для активации созданного приложения на вкладке «Settings» необходимо нажать по ссылке, находящейся в группе «Domains».
Активация приложения
![07-07_14](/uploads/media/1728x/00/900-07-07_14.png?v=1-0)
Далее нужно установить вебхук, для этого перейти по ссылке: «Ссылка из предыдущего пункта» + «/setWebHook». В результате если все было сделано верно должно появиться подобное сообщение.
Активация приложения
![07-07_15](/uploads/media/1728x/01/901-07-07_15.png?v=1-0)