Інтеграція E-chat: відмінності між версіями

Матеріал з expertsolution
Перейти до навігації Перейти до пошуку
(Створена сторінка: == Налаштування E-Chat == === 1. Отримання зовнішньої адреси HMS Service === Першим кроком необхідно отримати зовнішню адресу для HMS Service. Це можна зробити одним із способів: через Cloudflare (необхідно звернутись до Костянтина Білецького) шляхом відкриття порту на роу...)
 
Немає опису редагування
Рядок 25: Рядок 25:
=== 3. Налаштування webhook в особистому кабінеті E-Chat ===
=== 3. Налаштування webhook в особистому кабінеті E-Chat ===


Увійти в особистий кабінет E-Chat.
* Увійти в особистий кабінет E-Chat.
Вказати необхідні номери телефонів.
* Натиснути на "Підключити номер"
* Обрати необхідний месенджер та обрати інтеграцію "API"
* Натиснути "Додати номер"
 
фото
 
Після додавання номеру перейти у вкладку інтеграції
Перейти в налаштування '''Webhook'''.
Перейти в налаштування '''Webhook'''.
фото
Заповнити поля наступним чином:
Заповнити поля наступним чином:


'''INCOMING:'''
'''INCOMING:''' Адреса вебхука для вхідних повідомлень


<pre> https://ваша_зовнішня_адреса/api/echat/webhook/incoming </pre>
<pre> https://ваша_зовнішня_адреса/api/echat/webhook/incoming </pre>


'''OUTGOING:'''
'''OUTGOING:''' Адреса вебхука для статусу надісланих повідомлень


<pre> https://ваша_зовнішня_адреса/api/echat/webhook/outgoing-status </pre>
<pre> https://ваша_зовнішня_адреса/api/echat/webhook/outgoing-status </pre>
Рядок 46: Рядок 55:
Натиснути '''Додати'''.
Натиснути '''Додати'''.
Заповнити необхідні поля.
Заповнити необхідні поля.
У полі '''API-ключ''' вказати відповідний ключ (з особистого кабінету E-Chat, залежно від типу акаунта).
У полі '''API-ключ''' вказати відповідний ключ (з особистого кабінету E-Chat).
Зберегти запис.
Зберегти запис.



Версія за 12:31, 17 лютого 2026

Налаштування E-Chat

1. Отримання зовнішньої адреси HMS Service

Першим кроком необхідно отримати зовнішню адресу для HMS Service. Це можна зробити одним із способів:

через Cloudflare (необхідно звернутись до Костянтина Білецького) шляхом відкриття порту на роутері;

Примітка: локальна адреса сервісу зберігається у файлі appsettings.json.

фото1

2. Перевірка доступності webhook

Після отримання зовнішньої адреси необхідно перевірити її працездатність.

Відкрити браузер. Перейти за адресою:

 https://ваша_зовнішня_адреса/api/echat/webhook 

Якщо у відповідь відображається JSON — сервіс працює коректно.

фото 2

3. Налаштування webhook в особистому кабінеті E-Chat

  • Увійти в особистий кабінет E-Chat.
  • Натиснути на "Підключити номер"
  • Обрати необхідний месенджер та обрати інтеграцію "API"
  • Натиснути "Додати номер"

фото

Після додавання номеру перейти у вкладку інтеграції Перейти в налаштування Webhook.

фото

Заповнити поля наступним чином:

INCOMING: Адреса вебхука для вхідних повідомлень

 https://ваша_зовнішня_адреса/api/echat/webhook/incoming 

OUTGOING: Адреса вебхука для статусу надісланих повідомлень

 https://ваша_зовнішня_адреса/api/echat/webhook/outgoing-status 

фото3

4. Налаштування в HMS

Увійти в HMS. Перейти: CRM → Типи комунікацій → E-Chat-акаунти Натиснути Додати. Заповнити необхідні поля. У полі API-ключ вказати відповідний ключ (з особистого кабінету E-Chat). Зберегти запис.

фото 4 5

5. Перевірка роботи

Після успішного додавання акаунта:

Надіслати тестове повідомлення. Переконатися, що повідомлення коректно обробляється системою.

Якщо повідомлення надсилається та відображається в системі — налаштування виконано успішно.