> 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

Ця інструкція допоможе вам самостійно підключити номер телефону в Telegram, Viber або WhatsApp щоб писати першим свої кл

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

Системи месенджерів (особливо 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="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2Fp7mMGFN0QZrSnyBfML0b%2F%7BD0F475C9-A98D-494C-ADE9-D51A508786AA%7D.png?alt=media&amp;token=61ba6af7-74b1-403b-8034-0f27bf32a146" alt=""><figcaption></figcaption></figure>
2. Натисніть **"Sign Up"** / **"Реєстрація"**
3. Заповніть форму реєстрації (email, пароль) і підтвердіть реєстрацію\ <br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FgKBNvx2dDpcEAnIxmAsH%2F%7B99F2A9F3-29AD-4187-850E-F3B9293C9C59%7D.png?alt=media&amp;token=641dcc31-397b-4891-83b5-5c4f02d38a57" alt=""><figcaption></figcaption></figure>
4. Увійдіть до свого особистого кабінету&#x20;

***

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

***

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

### <img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FNKgDFf4gPxyh9gYFCu8E%2Fimage.png?alt=media&amp;token=8871257d-1195-40ab-9563-d8307755e524" alt="" data-size="line"> **TELEGRAM**

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FIJJ60u8hO7Sco5udk65J%2Fimage.png?alt=media&amp;token=368caa38-3f05-49b0-a1f6-8aa62e0654c4" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні з'явиться вибір CRM — оскільки готового пункту "JediDesk" у списку **немає**, обираємо загальний варіант (**API** / **Інше**); номер у JediDesk буде підключений пізніше через API-ключ (крок 7)<br>
3. Натисніть **"Підключити номер"**<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FsQeKPGEhUzr4jbDS9Bv0%2Fimage.png?alt=media&amp;token=a2fce93d-074d-4649-9641-9c854907aaef" alt=""><figcaption></figcaption></figure>
4. Підготуйте телефон з Telegram і натисніть **"Генерувати QR"**
5. Зачекайте, поки згенерується QR-код (зазвичай до 2 хвилин)<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F0TvjW1U3vQciw14gwoZs%2F%7B9DD17AC6-AA3A-40B6-B113-CE65F7934C44%7D.png?alt=media&amp;token=9a394b95-e44e-40cb-b1d8-ddb2e7866682" alt=""><figcaption></figcaption></figure>
6. Активуйте номер:

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FNbUFR8ifZYGJayCXpOZ9%2Fimage.png?alt=media&amp;token=913a942a-fdd7-41e0-8aed-1562cbd09fa5" alt="" width="375"><figcaption></figcaption></figure>

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

     <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FhoJbLKBkbzNleLFnB4bF%2Fimage.png?alt=media&amp;token=bcaea68a-5a1e-4520-bda2-29e96ee8e08d" alt="" width="375"><figcaption></figcaption></figure>
   * відскануйте QR-код, що відображається в E-chat
   * якщо в Telegram увімкнено хмарний пароль — введіть його протягом хвилини<br>

     <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FTRcu5tjGO1uMlgvIhO3K%2Fimage.png?alt=media&amp;token=1df74899-0680-4625-83ff-4980a38f3b21" alt=""><figcaption></figcaption></figure>
7. Якщо все пройшло успішно — в кабінеті E-chat з'явиться повідомлення про успішну активацію, і відкриється вкладка з інструкцією з підключення до CRM<br>

***

### <img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FjRHO14J7OgtN4hFhrB4x%2Fimage.png?alt=media&amp;token=c52339d2-6fb7-4f1c-8c1e-f9f7a8c00b09" alt="" data-size="line"> **VIBER**

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FtrLcAQvp9WbZqrBcBK65%2Fimage.png?alt=media&amp;token=d9c5f8a0-28a4-4210-922c-c128f9e3278f" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні оберіть API  та введіть номер у **міжнародному форматі** (наприклад, +380...)\ <br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F9FxyGPSVFxd122nSKYQ1%2Fimage.png?alt=media&amp;token=c1726c9a-b310-474a-85a0-6a4ede5296e1" alt=""><figcaption></figcaption></figure>
3. Натисніть **"Генерувати QR"** і зачекайте (зазвичай 20 секунд, максимум 2 хвилини)<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F2CGpQAzxZKh2kRNESWz4%2Fimage.png?alt=media&amp;token=7bc229fd-8257-41de-82c4-24758ccea9ce" alt=""><figcaption></figcaption></figure>
4. Активуйте номер одним із двох способів:
   * **Через камеру:** відкрийте Viber на телефоні → вкладка **"Ще"** (три риски/крапки) → іконка сканера QR у верхньому правому куті → відскануйте код<br>

     <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FKxzRYqm0cCmqiVmwrON5%2Fimage.png?alt=media&amp;token=16541e4b-7b12-4f54-8b04-00b4478e81e6" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F9te2qbJHViGWgqJWEmat%2Fimage.png?alt=media&amp;token=53ad4406-1483-4de4-84da-40eb48cca72f" alt=""><figcaption></figcaption></figure>

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

***

### <img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F7BZw8bxcdEZFtslw6BYH%2Fimage.png?alt=media&amp;token=a9013208-6eb7-454c-a30e-74a3b7391e81" alt="" data-size="line">  WHATSAPP

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FUaBsuW9T71k7d2VrkrL4%2Fimage.png?alt=media&amp;token=9b5bca5c-ccb5-48a6-b710-2e6cbbb0eec7" alt=""><figcaption></figcaption></figure>
2. У спливаючому вікні оберіть API  та введіть номер у міжнародному форматі<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F45DFiCucgWa1qoT5TFKj%2Fimage.png?alt=media&amp;token=74a3757a-28f0-4c12-be74-cf07334f4aff" alt=""><figcaption></figcaption></figure>
3. Натисніть **"Генерувати QR"**<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FR4DHdCLpg38RCJxvAMl9%2Fimage.png?alt=media&amp;token=0a6b55fc-a7b5-49a4-ad8a-ae342eb0c144" alt=""><figcaption></figcaption></figure>
4. Відкрийте WhatsApp на телефоні → відскануйте QR-код (через WhatsApp Web / Пов'язані пристрої)

<div><figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FzN1Y3rYZN0hw3pd1BoUn%2Fphoto_2026-06-29_15-59-26.jpg?alt=media&amp;token=f392c5c8-77f8-4ebe-865c-8574b2996671" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FzxUNVCm96JoGxFKhLwh3%2Fphoto_2026-06-29_15-59-30.jpg?alt=media&amp;token=04384ea0-be86-460a-9b44-455a5fb6bb0c" alt="" width="375"><figcaption></figcaption></figure></div>

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

***

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

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F8hi3c3OsNLrBuL5zagRh%2Fimage.png?alt=media&amp;token=1b735379-12ee-486c-87d8-43cac743cf03" alt=""><figcaption></figcaption></figure>
2. Скопіюйте цей ключ — він знадобиться на наступному кроці

***

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

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F2HsYQAm5y3pcwUCctRNd%2Fimage.png?alt=media&amp;token=cd341abf-5ca9-4218-a3d5-9efe2954eaf8" alt=""><figcaption></figcaption></figure>
4. Натисніть **"Налаштування інтеграції"**
5. Відкриється сторінка **E-chat** з таблицею підключених каналів (поки що порожня — "Підключень ще немає") та кнопкою **"+ Додати канал"** у верхньому правому куті<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FnudtEpYygL0ilN6kZczs%2Fimage.png?alt=media&amp;token=772060e1-0cc9-4307-9619-d7979c46ee7b" alt=""><figcaption></figcaption></figure>
6. Натисніть **"+ Додати канал"** — з'явиться спливаюче вікно з полями:<br>

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FWx8mbC5lZ9NVC72C3El3%2F%7BC70FFF1E-7712-4FC9-97DA-4444F901B60C%7D.png?alt=media&amp;token=13928633-d633-4677-83e3-70220627c888" alt=""><figcaption></figcaption></figure>
7. Натисніть **"Зберегти"**
8. Канал з'явиться в таблиці зі статусом підключення

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

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F1XvwsKqHP7q6AkCtwPwb%2Fimage.png?alt=media&amp;token=07a7ffe9-bcdb-4d7d-b99c-94491fc2afaa" alt=""><figcaption></figcaption></figure>
2. Повертаємось у Е-Chat та натискаємо біля номеру "НАЛАШТУВАННЯ" - "ДОДАТИ ВЕБХУК"<br>

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FfExhmo0tQ4dGKOaQ27kA%2Fimage.png?alt=media&amp;token=7a417480-625a-443f-9eac-3b86e53f07dd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FTicE6aguDSw4ajVH2ix2%2Fimage.png?alt=media&amp;token=90d470dc-98a7-4d5b-8152-5b5617eb828f" alt="" width="563"><figcaption></figcaption></figure>

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FwNDrdqMxWjgdvAL6KLRz%2F%7B75CA0B34-0249-44EB-BE13-F05BD49C5DF9%7D.png?alt=media&amp;token=f90aba56-1046-4a60-acd9-4c2dc70f8b5b" alt=""><figcaption></figcaption></figure>

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

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2Fc8NUxH1T5tRsTW3zW83K%2Fimage.png?alt=media&amp;token=3abefc6a-10fe-42e9-a4fa-5dd3690af6d1" alt=""><figcaption></figcaption></figure>
2. У відкритому вікні обираємо:

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

  <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FYSNN5B8R2Tjl2DwHUx6c%2F%7B92D9C231-574C-452D-8263-02B3864DC79D%7D.png?alt=media&amp;token=ed62d2e1-1872-4831-b611-c654e64e66c4" alt=""><figcaption></figcaption></figure>

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

   <figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2FHoeZmTSwrEy6Pgtz2APq%2F%7BDE2772F8-4C74-445D-8475-7A256C420626%7D.png?alt=media&amp;token=a64a0327-b37c-4253-b176-0eae2edf8af4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4292724302-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXkehX3Ue2D5LVuBJjMnb%2Fuploads%2F9F8xFdUqrzunSU0hlJMy%2Fimage.png?alt=media&amp;token=c414ef2f-5832-462e-b205-f138de9ad900" alt="" width="375"><figcaption></figcaption></figure>