Інтеграція E-chat: відмінності між версіями
Немає опису редагування |
|||
| (Не показано 5 проміжних версій цього користувача) | |||
| Рядок 9: | Рядок 9: | ||
'''Примітка:''' локальна адреса сервісу зберігається у файлі <code>appsettings.json</code>. | '''Примітка:''' локальна адреса сервісу зберігається у файлі <code>appsettings.json</code>. | ||
[[File: | [[File:Ечат11.png|1000px]] | ||
=== 2. Перевірка доступності webhook === | === 2. Перевірка доступності webhook === | ||
| Рядок 21: | Рядок 21: | ||
Якщо у відповідь відображається JSON — сервіс працює коректно. | Якщо у відповідь відображається JSON — сервіс працює коректно. | ||
[[File:Webhook11.png|800px]] | |||
=== 3. Налаштування webhook в особистому кабінеті E-Chat === | === 3. Налаштування webhook в особистому кабінеті E-Chat === | ||
| Рядок 27: | Рядок 27: | ||
# Увійти в особистий кабінет E-Chat. | # Увійти в особистий кабінет E-Chat. | ||
# Натиснути на "Підключити номер" | # Натиснути на "Підключити номер" | ||
# Ввести номер телефону | |||
# Обрати необхідний месенджер та обрати інтеграцію "API" | # Обрати необхідний месенджер та обрати інтеграцію "API" | ||
# Натиснути "Додати номер" | # Натиснути "Додати номер" | ||
[[File:Add number.png|1000px]] | |||
Після додавання номеру перейти у вкладку інтеграції | Після додавання номеру перейти у вкладку інтеграції | ||
Перейти в налаштування '''Webhook'''. | Перейти в налаштування '''Webhook'''. | ||
[[File:Вебхук.png|1000px]] | |||
Заповнити поля наступним чином: | Заповнити поля наступним чином: | ||
| Рядок 47: | Рядок 48: | ||
<pre> https://ваша_зовнішня_адреса/api/echat/webhook/outgoing-status </pre> | <pre> https://ваша_зовнішня_адреса/api/echat/webhook/outgoing-status </pre> | ||
[[File:Вебхук url.png|1000px]] | |||
=== 4. Налаштування в HMS === | === 4. Налаштування в HMS === | ||
| Рядок 58: | Рядок 59: | ||
Зберегти запис. | Зберегти запис. | ||
[[File:API key.png|1000px]] | |||
[[File:Crm echat.png|1000px]] | |||
=== 5. Перевірка роботи === | === 5. Перевірка роботи === | ||
Поточна версія на 09:39, 25 лютого 2026
Налаштування E-Chat
1. Отримання зовнішньої адреси HMS Service
Першим кроком необхідно отримати зовнішню адресу для HMS Service. Це можна зробити одним із способів:
через Cloudflare (необхідно звернутись до Костянтина Білецького) шляхом відкриття порту на роутері;
Примітка: локальна адреса сервісу зберігається у файлі appsettings.json.
2. Перевірка доступності webhook
Після отримання зовнішньої адреси необхідно перевірити її працездатність.
Відкрити браузер. Перейти за адресою:
https://ваша_зовнішня_адреса/api/echat/webhook
Якщо у відповідь відображається JSON — сервіс працює коректно.
3. Налаштування webhook в особистому кабінеті E-Chat
- Увійти в особистий кабінет E-Chat.
- Натиснути на "Підключити номер"
- Ввести номер телефону
- Обрати необхідний месенджер та обрати інтеграцію "API"
- Натиснути "Додати номер"
Після додавання номеру перейти у вкладку інтеграції Перейти в налаштування Webhook.
Заповнити поля наступним чином:
INCOMING: Адреса вебхука для вхідних повідомлень
https://ваша_зовнішня_адреса/api/echat/webhook/incoming
OUTGOING: Адреса вебхука для статусу надісланих повідомлень
https://ваша_зовнішня_адреса/api/echat/webhook/outgoing-status
4. Налаштування в HMS
Увійти в HMS. Перейти: CRM → Типи комунікацій → E-Chat-акаунти Натиснути Додати. Заповнити необхідні поля. У полі API-ключ вказати відповідний ключ (з особистого кабінету E-Chat). Зберегти запис.
5. Перевірка роботи
Після успішного додавання акаунта:
Надіслати тестове повідомлення. Переконатися, що повідомлення коректно обробляється системою.
Якщо повідомлення надсилається та відображається в системі — налаштування виконано успішно.