> For the complete documentation index, see [llms.txt](https://docs.jedidesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jedidesk.com/integraciyi/integraciya-z-e-chat.md).

# Інтеграція з E-Chat

## ⚠️ Перед підключенням: чи "прогрітий" ваш номер?

Системи месенджерів (особливо WhatsApp та Viber) автоматично відстежують підозрілу активність на номері й можуть **заблокувати номер**, якщо побачать ознаки спам-розсилки. Підключення через E-chat одразу після того, як номер активно почав писати новим людям, — одна з найчастіших причин блокування.

**Це особливо критично, якщо номер:**

* щойно зареєстрований у месенджері (Telegram/Viber/WhatsApp), **або**
* раніше не використовувався активно для спілкування з людьми, **або**
* ви плануєте одразу після підключення почати масово писати новим контактам першими

#### Що робити: "прогрів" номера перед підключенням

Якщо номер новий або ви не впевнені в його репутації — **перед підключенням до E-chat / #jedidesk**:

1. **Протягом 3–5 днів** користуйтеся номером **вручну, з мобільного додатку** (не через сервіс)
2. Робіть **по 3–6 ініціацій діалогів на добу** (тобто пишете першими 3–6 новим людям на день, не більше)
3. Паралельно ведіть переписку у вже **існуючих чатах** — відповідайте, листуйтеся, як зазвичай
4. Лише **після 3–5 днів** такого "прогріву" підключайте номер до E-chat і #jedidesk

Якщо номер уже підключений і ви помітили проблеми (повідомлення не доходять, акаунт обмежено) — **тимчасово відключіть номер від інтеграції** і протягом найближчих **3 днів** користуйтеся ним тільки вручну з мобільного додатку, без сервісу. Після цього спробуйте підключити знову.

📌 **Це не вимога E-chat чи #jedidesk** — це обмеження самих месенджерів. Ні E-chat, ні #jedidesk не можуть гарантувати розблокування номера, якщо месенджер вирішив, що це спам.

## Крок 1. Реєстрація в E-chat

1. Перейдіть на сайт 👉 <https://e-chat.tech/profile/registration?ref=39256f4b-3d43-47be-98ba-77949a248b24><br>

   <figure><img src="/files/CzltNE6uhRESDBLt6Tp7" alt=""><figcaption></figcaption></figure>
2. Натисніть **"Sign Up"** / **"Реєстрація"**
3. Заповніть форму реєстрації (email, пароль) і підтвердіть реєстрацію\ <br>

   <figure><img src="/files/BdCJVEFUb02Mhkn2ETpW" alt=""><figcaption></figcaption></figure>
4. Увійдіть до свого особистого кабінету&#x20;

***

> E-chat надає **безкоштовний тестовий період**: 7 днів для першого підключеного номера кожного месенджера, і 3 дні для кожного наступного номера. Оплата на цьому етапі не потрібна.\
> \
> На сканування QR-коду буде відведено від 2 до 9 хвилин залежно від месенджера — підготуйте телефон із потрібним додатком заздалегідь.

***

## Крок 2. Підключення номера

### <img src="/files/GfM78sDqJVaPYVNxK0Si" alt="" data-size="line"> **TELEGRAM**

1. У лівому верхньому куті оберіть месенджер **Telegram** та натисніть **"Підключити номер Telegram"**<br>

   <figure><img src="/files/ZOTRvo6z4rEfMq1Vy5bJ" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні з'явиться вибір CRM — оскільки готового пункту "JediDesk" у списку **немає**, обираємо загальний варіант (**API** / **Інше**); номер у JediDesk буде підключений пізніше через API-ключ (крок 7)<br>
3. Натисніть **"Підключити номер"**<br>

   <figure><img src="/files/yGxjHfdCezSnX3VhNRYe" alt=""><figcaption></figcaption></figure>
4. Підготуйте телефон з Telegram і натисніть **"Генерувати QR"**
5. Зачекайте, поки згенерується QR-код (зазвичай до 2 хвилин)<br>

   <figure><img src="/files/c2G1lcvVJ2VaA9sJHl6R" alt=""><figcaption></figcaption></figure>
6. Активуйте номер:

   * візьміть телефон з Telegram
   * відкрийте **Налаштування → Пристрої** (або іконка пристроїв у верхньому правому куті списку чатів)

   <figure><img src="/files/rNS8KhxofswMvCOMy0jF" alt="" width="375"><figcaption></figcaption></figure>

   * натисніть **"Скан QR"** / **"Підключити пристрій"**\ <br>

     <figure><img src="/files/v2LhBPd0I6TcDhNPGrhx" alt="" width="375"><figcaption></figcaption></figure>
   * відскануйте QR-код, що відображається в E-chat
   * якщо в Telegram увімкнено хмарний пароль — введіть його протягом хвилини<br>

     <figure><img src="/files/U2YYmQJB5pzM8VB5jQtq" alt=""><figcaption></figcaption></figure>
7. Якщо все пройшло успішно — в кабінеті E-chat з'явиться повідомлення про успішну активацію, і відкриється вкладка з інструкцією з підключення до CRM<br>

***

### <img src="/files/SpeKIr5V9hqLqtysRi5A" alt="" data-size="line"> **VIBER**

1. У лівому верхньому куті натисніть **"Підключити номер Viber"**<br>

   <figure><img src="/files/kTRoX7nQIqRb3CDVuZRR" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні оберіть API  та введіть номер у **міжнародному форматі** (наприклад, +380...)\ <br>

   <figure><img src="/files/7kpqe17Sep0rfQT94uMA" alt=""><figcaption></figcaption></figure>
3. Натисніть **"Генерувати QR"** і зачекайте (зазвичай 20 секунд, максимум 2 хвилини)<br>

   <figure><img src="/files/Jedegbt8q7M24CcYYEuq" alt=""><figcaption></figcaption></figure>
4. Активуйте номер одним із двох способів:
   * **Через камеру:** відкрийте Viber на телефоні → вкладка **"Ще"** (три риски/крапки) → іконка сканера QR у верхньому правому куті → відскануйте код<br>

     <figure><img src="/files/viRRKE939czUSsXticWo" alt="" width="375"><figcaption></figcaption></figure>

* **Якщо камера не працює:** натисніть "Не працює камера?" → скопіюйте унікальне посилання → відкрийте його в браузері на телефоні → підтвердьте авторизацію в застосунку Viber

<figure><img src="/files/QUahaH2ksxfiOI3viIYh" alt=""><figcaption></figcaption></figure>

5. На телефон прийде системне повідомлення Viber про новий вхід з нового пристрою — **не видаляйте** цей пристрій із налаштувань, інакше інтеграція перестане працювати
6. В кабінеті E-chat з'явиться підтвердження успішної активації

***

### <img src="/files/Tct6SHvIk2xLY9bCDJw4" alt="" data-size="line">  WHATSAPP

1. У лівому верхньому куті натисніть **"Підключити номер WhatsApp"**<br>

   <figure><img src="/files/vYTBN5Gdln1BTgBE8jbY" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні оберіть API  та введіть номер у міжнародному форматі<br>

   <figure><img src="/files/iqTLTo1QoL8ZhXixMhlQ" alt=""><figcaption></figcaption></figure>
3. Натисніть **"Генерувати QR"**<br>

   <figure><img src="/files/JvCUeZUC4cz8kmUDp5wP" alt=""><figcaption></figcaption></figure>
4. Відкрийте WhatsApp на телефоні → відскануйте QR-код (через WhatsApp Web / Пов'язані пристрої)

<div><figure><img src="/files/Y3BdjjNxKkTUqLYzoUmH" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/89xFX5T9nA2JMAifeu6y" alt="" width="375"><figcaption></figcaption></figure></div>

5. Дочекайтесь підтвердження успішної активації в кабінеті E-chat

***

## Крок 2. Отримання API-ключа для підключеного номера

1. Знайдіть **API-ключ** для щойно підключеного номера (відображається в таблиці підключених номерів на головній сторінці кабінету, у колонці **"API key"**)<br>

   <figure><img src="/files/QLc0OqaBcbBuXyLH6Hez" alt=""><figcaption></figcaption></figure>
2. Скопіюйте цей ключ — він знадобиться на наступному кроці

***

## Крок 3. Підключення каналу в #jedidesk

1. У бічному меню перейдіть у розділ **Інтеграції**
2. Відкрийте вкладку **"Канали"**
3. Знайдіть картку **"Інтеграція з E-chat"** <br>

   <figure><img src="/files/uz8yCN3SzsCvLOuCnSKH" alt=""><figcaption></figcaption></figure>
4. Натисніть **"Налаштування інтеграції"**
5. Відкриється сторінка **E-chat** з таблицею підключених каналів (поки що порожня — "Підключень ще немає") та кнопкою **"+ Додати канал"** у верхньому правому куті<br>

   <figure><img src="/files/jeytwHbc8kkCzdu6AojH" alt=""><figcaption></figcaption></figure>
6. Натисніть **"+ Додати канал"** — з'явиться спливаюче вікно з полями:<br>

   * **Канал** — оберіть з випадного списку потрібний месенджер (Telegram / Viber / WhatsApp)
   * **Номер** — введіть номер у форматі 098... або 380... (той самий, що активували в E-chat)
   * **API key** — вставте ключ, скопійований на кроці 6
   * **Назва** — довільна назва для зручності (наприклад, "Telegram — основний номер")

   <figure><img src="/files/6oTP7hx5u3OBgKu0zOcm" alt=""><figcaption></figcaption></figure>
7. Натисніть **"Зберегти"**
8. Канал з'явиться в таблиці зі статусом підключення

## Крок 4. Додати зв'язати JediDesk та E-chat через Webhook

1. У вікні, що з'явилося, натисніть кнопку "СКОПІЮВАТИ"<br>

   <figure><img src="/files/A8I6Y6FbqSn9aIvphI2L" alt=""><figcaption></figcaption></figure>
2. Повертаємось у Е-Chat та натискаємо біля номеру "НАЛАШТУВАННЯ" - "ДОДАТИ ВЕБХУК"<br>

   <figure><img src="/files/pWI6eL4Azbv4DjGbPiMW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/e48NSF0Ac3bLQlX2Cj2S" alt="" width="563"><figcaption></figcaption></figure>

3. Вставляємо в обидва поля скопійоване посилання - після натиснути "Додати"\ <br>

   <figure><img src="/files/D7YbDEBhGM3kE3ra2EH1" alt=""><figcaption></figcaption></figure>

\
Крок 5. Як писати першим?
-------------------------

1. Відкриваємо LiveChat у JediDesk і біля фільтру знаходимо іконку олівця з папером<br>

   <figure><img src="/files/EcfTafzLZMFGazIspqtf" alt=""><figcaption></figcaption></figure>
2. У відкритому вікні обираємо:

* Від кого - канал з якого буде відправлене повідомлення (телеграм, вайбер, вацап)
* Кому - нікнейм або через номер телефону користувача якому хочемо написати
* І'мя - ім'я користувача, як діалог буде відображатись у LiveChat (необов'язкове поле)
* Повідомлення - текст який буде відправлено користувачу<br>

  <figure><img src="/files/t0l5fyCqn0Q2g3O57ewq" alt=""><figcaption></figcaption></figure>

3. Натиснути відправити. Створено чат, відправленно повідомлення з власного акаунту телеграм та є фіолетова цяточка біля позначки каналу для ідентифікації каналу спілкування.\
   &#x20;<br>

   <figure><img src="/files/uJNnjTmFFyO336kMEdTV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/M5CF0aHxO4gdWwYHh8JR" alt="" width="375"><figcaption></figcaption></figure>