Публикация

WhatsApp, Chatwoot и Битрикс24: как связать переписку с открытой линией

Рабочий интерфейс ответов, область данных, журнал и проверка доставки. Кейс текстового обмена между WhatsApp, Chatwoot и Битрикс24.

CRM и клиентские коммуникации 4 мин
Рабочий интерфейс, журнал и контроль доставки

У компании уже есть WhatsApp-канал в Chatwoot, а менеджеры работают в Битрикс24. Передача сообщений полезна только тогда, когда понятно, откуда отвечать и какую историю видит каждый интерфейс.

В сентябрьском внедрении KMVSG связал существующий канал с отдельной открытой линией. Рассмотрим подтверждённый текстовый сценарий и функции, которым нужна отдельная проверка.

CRM и клиентские коммуникации

Переписка в открытой линии

  1. 01WhatsApp
  2. 02Chatwoot
  3. 03Линия
  4. 04Доставка
  • Команда отвечает из согласованного рабочего окна. Направления переноса истории определены заранее.
  • Передача ограничивается нужным аккаунтом, inbox и линией; приватные заметки не пересылаются.
  • Сообщения и попытки фиксируются; неопределённая отправка требует сверки, а не слепого повтора.

Выберите один рабочий интерфейс ответа

Определите, где оператор ведёт диалог и что должно попадать в другой интерфейс. Симметричность истории нельзя предполагать из наличия двух приложений: для каждого направления нужен явный сценарий.

В нашем кейсе менеджеры отвечают из открытой линии Битрикс24. Входящий WhatsApp проходит через Chatwoot, а ответ линии уходит в обратную сторону. Прямые ответы из Chatwoot не копируются в историю линии; это ограничение сохранено в приёмке.

Ограничьте передаваемые события

Назначьте конкретный портал, линию, аккаунт и inbox. Отдельно проверьте приватные заметки и подлинность входящих событий. Событие чужой области не должно запускать отправку.

Внедрение ограничено одним WhatsApp-inbox и отдельной линией; прежняя общая линия не менялась. Приватные заметки исключены из передачи. Позднее в тот же день дополнительно защищён общий callback приложения, закрыта публичная установка; HTTP-проверки положительных и отрицательных случаев прошли.

Храните связь сообщений и состояние попытки

Webhook может повториться, а сетевой ответ потеряться после отправки. Постоянный журнал должен связывать сообщения двух сторон и показывать, какой шаг выполнен, а какой результат ещё неизвестен.

В этой интеграции неопределённая отправка в Битрикс24 переходила в uncertain без автоматического повтора: требовалась сверка истории. Пропущенные события Chatwoot дополнялись опросом. Это конкретный механизм внедрения, а не гарантия безошибочной доставки любого сообщения.

Статус доставки проверяйте отдельно

Ответ API о создании записи, появление сообщения в интерфейсе и delivered/read в WhatsApp описывают разные этапы. Для контрольного диалога фиксируйте всю цепочку, включая авторство оператора.

14 сентября входящие сообщения переданы в линию, операторские ответы прошли через Chatwoot в WhatsApp и получили delivered/read. На контрольной точке шесть заданий done, ошибок и повторных отправок нет. Этот живой тест был до позднего защитного фикса; после него проверены callback и отсутствие новых ошибок, новый диалог не инициировали.

Файлы, шаблоны и закрытие не выводятся из текстового теста

Для вложений нужны реальные форматы, допустимые адреса и размер; для шаблонов — отдельный интерфейс и актуальные правила канала. Проверка текста не закрывает эти сценарии.

Вложения поддержаны кодом и проверены на моделях, но живой обмен ими на дату кейса не подтверждён. Закрытие и переоткрытие между интерфейсами не синхронизируются. Создание лидов не включено; настройки WhatsApp-шаблонов требуют отдельного этапа.

Определите порядок сопровождения

Счётчики, журнал и действия при неопределённой отправке должны быть доступны ответственной команде. Автоматическое назначение оператора также требует проверки доступности сотрудника, а не только списка участников.

В соседней сентябрьской настройке почтового inbox политика назначения была включена, но доступных операторов не оказалось и фактических назначений было ноль. Её не используем как доказательство распределённых обращений. Для нового проекта принимаем конкретный поток и наблюдаемый результат, включая ограничения мониторинга.

Короткий чек-лист

  • Выбрать рабочий интерфейс ответов
  • Зафиксировать портал, inbox и линию
  • Проверить приватные заметки и источник событий
  • Сохранить связи и состояния сообщений
  • Подтвердить текстовый обмен и доставку
  • Проверить вложения и закрытие отдельными сценариями

Ссылки и исходный код