Чат боти поступово стають невід'ємною частиною автоматизації бізнесу.
Сценаріїв використання безліч, серед деяких з них:
- організація інтернет магазинів з можливістю перегляду каталогу товарів та формування замовлень
- надання оперативної управлінської звітності
- організація вузькоспеціалізованих інтерфейсів для співробітників, яким не потрібен повноцінний клієнт облікової системи (наприклад, комірникам для комплектації замовлень)
- створення опитувань та розсилання оповіщень
Способи інтеграції 1С (BAS) та чат бота Telegram
Взаємодія чат бота Telegram та будь-якої інформаційної системи зводиться до простого алгоритму: надсилання повідомлення чат боту — отримання відповіді. Складність виникає у тому, як саме отримувати відповідь. Можна створити регламентне завдання, яке періодично опитуватиме сервер Telegram, а можна налаштувати чат бота так, щоб він сам за вказаною адресою відразу надсилав відповідь, як тільки користувач його введе.
Перший спосіб виконується методом "getUpdates" і його ми розглядати не будемо, так як він досить простий у реалізації.
Другий метод більш складний, і передбачає використання Webhooks — вказівку Telegram адреси, на який він повинен моментально надсилати повідомлення. Ось про нього і хотілося б поговорити, оскільки він складніший у налаштуванні, але забезпечує більш якісну взаємодію з користувачем.
Суть цієї технології в тому, що чат боту повідомляється захищений статичний https:// адресу, після чого Telegram відправляє на нього повідомлення в JSON-форматі. Можна по-різному організувати обробку повідомлень чат бота, наприклад, через власний веб-сервер або перенаправлення на localhost командою ngrok (ngrok http 5000). Розглянемо обробку повідомлень за допомогою http-сервісу платформи BAF (1С Підприємство) на веб-сервері IIS.
Підготовка серверу
Спочатку нам потрібен безпосередньо сам сервер зі статичною адресою. На ньому необхідно встановити IIS і зв’язати його з обробниками 1С (BAS), процес детально описаний, наприклад, у цій статті, тому докладно не будемо зупинятися.
Публікація http-сервісу
Створюємо користувача та пароль для доступу до http-сервісу. Наприклад, логін hs, пароль 12 345.
Далі потрібно створити та опублікувати http-сервіс у конфігураторі BAF.
Текст методу TelegramPOST може бути таким:
Функція TelegramPOST (Запит Сервісу)
TelegramСервер.ОбробитиЗапитСервісуІВідправитиВідповідь (ЗапитСервісу);
Відповідь = Новий HTTPСервісВідповідь (200);
Повернення Відповідь;
КінецьФункції
Функція повинна повертати код 200. Відповідь чату виконується в тілі процедури TelegramСервер.
HTTPЗ'єднання = Новий HTTPЗ'єднання ("api.telegram.org", 443,15,Новий ЗахищенеЗ'єднанняOpenSSL ());
HTTP З'єднання.
Після цього публікуємо веб-сервіс.
Створення самописного сертифікатау та встановлення взаємозв'язку http-сервісу та чат боту.
Оскільки Telegram використовує захищене з'єднання, необхідно встановити сертифікат безпеки. Можна або придбати, або створити власний самописний. Відмінність у тому, що самопідписаний не буде вважатися довіреним, але для чат робота його достатньо.
Розглянемо процес створення. Оригінал взято звідси.
Качаємо та встановлюємо OpenSSL. Генеруємо файли ключа та сертифіката
"C:\Program Files\OpenSSL-Win64\bin\openssl.exe" req -newkey rsa:2048 -sha256 -nodes -keyout webhook. key -x509 -days 9999 -out webhook. cer -subj "/C=US/ ST=State/L=Cyti/O=You Company/CN=IP_Адреса_сервера"
-days 9999 — термін дії сертифіката
-out webhook. cer — ім'я файлу сертифіката
You Company — ім'я компанії
У результаті отримаємо два файли webhook. key (приватний ключ) та webhook. cer (власне сертифікат).
2. Шукаємо в інтернеті утиліту pvk. exe авторства Dr Stephen N Henson. Конвертуємо приватний ключ у формат PVK та встановлюємо пароль на ключ. Наприклад 12 345 678
"C:\Program Files\pvktool\pvk.exe" -in D:\ webhook. key -out D:\ webhook. pvk -topvk pass: 12 345 678
3. Створюємо з файлу сертифіката та файлу PVK сертифікат PFX.
"C:\Program Files\pvk2pfx\pvk2pfx.exe" -pvk D:\ webhook. pvk -spc D:\ webhook. cer -pfx D:\ webhook. pfx -pi 12 345 678 -po
4. Цей сертифікат можна імпортувати до IIS та зв’язати з ним порт SSL (443).
Потім - сайти - змінити прив'язки.
Встановлюємо прив'язку до 443 порту
5. Прив’язку сертифіката до чату зручно зробити за допомогою простої html-сторінки
<html>
<body>
<form action="https://api.telegram.org/token_чатбота/setwebhook" method="post" enctype="multipart/form-data">
Select Certificate to upload (*.сer):
<input type="file" name="certificate" id="fileToUpload">
URL: <input type="text" name="url" value="https://hs:123 456 789@255.255.255.255/MyBase/hs/telegram/post_message/"><br>
<input type="submit" value="Upload Certificate" name="submit">
</form>
</body>
</html>
Де
token_чата — токен чат-бота
hs:123 456 789 — логін пароль користувача BAF з доступу до http сервісу
255.255.255.255- ip адреса бази BAF
MyBase — ім'я бази
В інтерфейсі сторінки потрібно вибрати файл сертифіката
6. Перевірка прив’язки чат боту
Після цього можна перевірити прив’язку командою
https://api.telegram.org/token_чатбота/getWebhookInfo
Висновок
На закінчення хочеться сказати, що подібним чином можна організувати інтеграцію з чат ботом Viber і Facebook messaging. Програмну логіку відповідей чат боту краще організовувати з використанням механізму завдань та бізнес-процесів.
Якщо Вам потрібна інтеграція 1С (BAS) та чат боту, залиште заявку.
