Номерные 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-ключ, проект
- Статус канала — «Подключено»
- Владелец и доступ команды настроены
- Автоответ и распределение включены при необходимости
- Тестовое сообщение прошло в обе стороны