Номерні Viber, WhatsApp і Telegram через E-chat
Підключення номера компанії в E-chat і в X10 CRM: API-ключ, канал, доступ команди, правила обробки й перевірка.
E-chat підключає до CRM звичайний номер телефону компанії у Viber, WhatsApp і Telegram — без бота. Клієнт пише на знайомий номер і бачить відповідь з того самого номера, а менеджер відповідає з X10 CRM: листування лежить поруч із заявкою, дзвінками й SMS клієнта. Ця сторінка — про те, що зробити в кабінеті E-chat, що — в CRM, і як перевірити, що все працює.
#Як це влаштовано
- 01
Номер у E-chat
Номер компанії активується в кабінеті E-chat у потрібному месенджері, E-chat видає API-ключ.
- 02
Канал у CRM
Адміністратор додає номер і ключ у X10 CRM і натискає «Підключити канал» — CRM сама передає E-chat адресу, куди слати повідомлення.
- 03
Повідомлення в CRM
Вхідні, ваші відповіді з телефона, статуси доставки й дзвінки приходять у CRM за секунди.
- 04
Відповідь із CRM
Менеджер пише в чаті CRM або з картки заявки — клієнт отримує повідомлення з номера компанії.
| Viber | Telegram | ||
|---|---|---|---|
| Чим ідентифікується клієнт | Номер телефону | Номер телефону | Акаунт Telegram (номер — якщо клієнт поділився) |
| Написати першим | Так | Так | Лише тим, хто вже писав |
| Текст, фото, файли | Так | Так | Так |
| Статус «доставлено» | Так | Так | Так |
| Заявка за номером клієнта | Так | Так | Коли відомий номер |
#Що знадобиться
- Номер телефону компанії, на якому працює потрібний месенджер (Viber, WhatsApp або Telegram), і доступ до цього телефона на час активації
- Акаунт у кабінеті E-chat з активним тарифом для цього месенджера
- Користувач X10 CRM з правом на налаштування соцмереж (адміністратор або роль із доступом до «Соцмереж»)
- Список менеджерів, які мають бачити листування з цього номера
#Крок 1. Номер і API-ключ у кабінеті E-chat
- Зареєструйтесь у кабінеті E-chat і оберіть тариф для потрібного месенджера. Інтеграцію з X10 CRM вказувати окремо не треба — E-chat упізнає її сама.
- Додайте номер компанії й пройдіть активацію в месенджері так, як просить кабінет E-chat (зазвичай — підтвердження на телефоні з цим номером).
- Дочекайтеся, поки номер у кабінеті стане активним.
- Скопіюйте API-ключ E-chat. Тримайте його як пароль — він дає доступ до листування з номера.


#Крок 2. Канал у X10 CRM
- CRM → Налаштування → Соцмережі → E-chat.
- Оберіть вкладку месенджера: Viber, WhatsApp або Telegram.
- Назва каналу — як канал підписуватиметься в чатах, наприклад «Viber Продажі».
- Номер — у міжнародному форматі без «+», наприклад
380671234567. - API-ключ E-chat — вставте ключ із кроку 1. Після збереження CRM його не показує: щоб змінити, впишіть новий.
- Проєкт CRM — у якому проєкті з'являтимуться заявки й розмови з цього номера.
- Натисніть «Зберегти», потім «Підключити канал».


Після «Підключити канал» біля номера має з'явитися статус «Підключено». Якщо замість нього помилка — її текст пояснює причину: неправильний ключ, неоплачений тариф або неактивований номер (див. Якщо щось не працює).

#Крок 3. Хто бачить листування
Номер компанії часто ділить кілька людей, тож доступ до каналу задається окремо від ролей:
| Поле | Що робить |
|---|---|
| Власник каналу | Головний відповідальний за номер. Бачить усі розмови каналу. |
| Хто бачить канал | «Усі з доступом до соцмереж» — спільна лінія; «Власник і вибрані користувачі» — особистий або закритий номер. |
| Додатковий доступ | Керівники й колеги, які бачать канал у режимі «Власник і вибрані користувачі». |
#Крок 4. Правила обробки
- Автовідповідь на перше повідомлення — клієнт одразу отримує текст на кшталт «Дякуємо, менеджер відповість за кілька хвилин». Іде один раз на розмову й позначається в чаті міткою «автовідповідь».
- Автопризначення — нова розмова по черзі дістається менеджерам каналу.
- Автозакриття — розмова без нових повідомлень закривається через заданий час; новий лист клієнта відкриває її знову.
- AI-консультант — за бажанням може відповідати першим, уночі або коли менеджер не встиг. Налаштовується окремо: Соцмережі → AI-консультант.

#Як із цим працює менеджер
- Усі розмови — у розділі Соцмережі в CRM, з іконкою месенджера біля кожної.
- Розмова прив'язується до заявки клієнта за номером телефону. Новий номер — нова заявка; відомий — його наявна заявка.
- З картки заявки — кнопка «Написати у Viber» (і так само для WhatsApp): CRM сама бере номер клієнта, навіть якщо менеджеру номер у картці прихований.
- Відповідь, надіслана з телефона з цим номером, теж з'являється в CRM — історія не розривається.
- Біля кожного вашого повідомлення — статус доставки; якщо номер клієнта не користується месенджером, CRM покаже помилку доставки.


#Крок 5. Перевірка
- З особистого телефона напишіть на номер компанії в месенджері. За кілька секунд розмова з'являється в CRM, а якщо номер новий — разом із заявкою.
- Дайте відповідь із CRM — вона приходить на ваш телефон від номера компанії, а в CRM біля неї стає «доставлено».
- Напишіть відповідь із телефона компанії — вона теж з'являється в розмові в CRM.
- Відкрийте картку будь-якої заявки з номером і натисніть «Написати у Viber» — повідомлення доходить клієнту.
#Адреса вебхука
Під час «Підключити канал» CRM сама передає E-chat адресу, на яку надходять повідомлення, дзвінки й статуси, — копіювати нічого не треба. Адреса показана в налаштуваннях каналу в блоці «Налаштування та webhook» для діагностики: там же видно час останньої події й кількість помилок за добу.

#Якщо щось не працює
| Що бачите | Причина | Що зробити |
|---|---|---|
| Помилка ключа при «Підключити канал» | API-ключ неправильний або відкликаний | Скопіюйте ключ у кабінеті E-chat ще раз і впишіть у поле «API-ключ» |
| Помилка оплати | Тариф E-chat не оплачено | Оплатіть тариф і натисніть «Підключити канал» ще раз |
| Номер не активований | Номер не пройшов активацію в месенджері | Завершіть активацію в кабінеті E-chat |
| Повідомлення клієнтів не приходять | E-chat не знає адреси вебхука | «Підключити канал» ще раз; якщо не допомогло — вставте адресу вручну (див. вище) |
| «Не доставлено» біля відповіді | Номер клієнта не використовує месенджер або заблокував вас | Зв'яжіться з клієнтом іншим каналом — дзвінком чи SMS |
| Менеджер не бачить канал | Канал закритий, а менеджера немає в доступі | Додайте його в «Додатковий доступ» або змініть «Хто бачить канал» |
CRM щогодини сама перевіряє канал: якщо E-chat перестав його обслуговувати (ключ, оплата, активація), адміністратори отримують сповіщення в CRM із причиною.
#Підсумковий чек-лист
- Номер активний у кабінеті E-chat, тариф оплачено
- Канал доданий у CRM: номер, API-ключ, проєкт
- Статус каналу — «Підключено»
- Власник і доступ команди налаштовані
- Автовідповідь і розподіл увімкнені за потреби
- Тестове повідомлення пройшло в обидва боки