WhatsApp + Битрикс24 не работает: что проверить
Что делать, если интеграция WhatsApp с Битрикс24 перестала работать: частые причины сбоя и пошаговое решение, как восстановить переписку. Radist.Online.
Коротко. Сообщения не идут — первым делом закройте WhatsApp Web и десктопное приложение (частая причина: WhatsApp разрывает сессию при открытии переписки в другом месте). Затем три быстрые проверки: (1) пересохранить интеграцию в RadistWeb → «Интеграции» → WhatsApp+Bitrix24; (2) проверить статус номера в «Подключениях» (должно быть «Подключено»); (3) обновить данные подключения в Битрикс24 по ссылке-вебхуку. Если не помогло — найдите свой случай ниже: два одинаковых канала в одной линии, слетевшие настройки, неактивная линия, зависшая отправка, ошибка номера, бан WhatsApp.
Сообщения перестали приходить или отправляться — почти всегда это лечится за пару минут. Сначала три быстрые проверки, а если не помогло — переходите к разделу под ваш случай.
С чего начать
Пересохраните интеграцию в личном кабинете
Помогает при большинстве сбоев. Личный кабинет → раздел «Интеграции» → интеграция WhatsApp+Bitrix24 в категории «Доступные». Выполните только второй шаг — заново укажите ссылку на ваш домен Битрикс24.
Подробно, со скриншотами — в инструкции «Как переустановить интеграцию WhatsApp + Битрикс24».
Проверьте статус номера
Личный кабинет → раздел «Подключения». «Подключено» — связь есть, дело не в номере. Любой другой статус уже объясняет причину.
Что означает каждый статус и что с ним делать — в инструкции «Статусы подключения WhatsApp». Там же — проверка памяти телефона.
Обновите данные подключения в Битрикс24
Данные подключения могли устареть. С аккаунта администратора перейдите по ссылке, подставив в конце свой домен Битрикс24:
https://bitrix24.webhooks.radist.online/bitrix24/oauth/redirect/radist.radist_online/ДОМЕНБ24
Если всё прошло успешно, появится ответ: {"message": "Authenticated", "success": true}. После этого проверьте переписку.
Найдите свой случай
| Что вы видите | Куда смотреть |
|---|---|
| К открытой линии подключён ещё один сервис WhatsApp, кроме нашего | Два одинаковых канала в одной линии |
| Линия на вид настроена верно, но переписки нет | Настройки канала слетели |
| В списке открытых линий у линии красный крестик | Линия не активна |
| Рядом с отправленным сообщением крутится кружок | Сообщение зависло при отправке |
| Номер в личном кабинете отвалился или горит ошибкой | Статусы подключения WhatsApp |
| Номер заблокировали в WhatsApp | Аккаунт попал в бан |
Два одинаковых канала в одной линии
К одной открытой линии нельзя подключать два одинаковых канала — например, Radist.Online и сторонний сервис WhatsApp одновременно.
Чтобы подключить наш канал, сначала отключите от линии сторонний сервис: внутри его виджета нажмите «Отключить». На плитке в Контакт-центре не должно остаться галочки.
Настройки канала слетели
Нужно пересохранить настройки канала — в большинстве случаев это помогает. В Контакт-центре откройте наше приложение и нажмите «Изменить» у нужного канала.
Проверьте, что в блоке «Настройки открытой линии и прав доступа» выбрана та самая линия, и сохраните настройки. Сам виджет настраивается в личном кабинете Radist.Online — ссылка на него есть прямо в карточке канала.
Линия не активна
В выпадающем списке открытых линий у неактивной линии стоит красный крестик.
Кликните по такой линии ещё раз — откроется окно с предложением активировать её. Нажмите «Активировать».
Если окно не появляется, а линия выбрана, включите её вручную:
- Откройте настройки линии — кнопка «Настроить» справа от выпадающего списка.
- Перейдите на вкладку «Прочее».
- Включите галочку «Линия активна».
- Нажмите «Сохранить» в самом низу окна.
Сообщение зависло при отправке
Если рядом с сообщением крутится кружок — открытые линии Битрикс24 перегружены. Нужно просто подождать, сообщение отправится.
Проверить, всё ли в порядке на стороне Битрикс24, можно на status.bitrix24.ru — там пишут о значительных сбоях в работе системы.
Почему интеграция слетает
Чтобы это не повторялось, полезно знать причины. Чаще всего сессия рвётся, если:
- открыли WhatsApp Web или десктопное приложение;
- запустили WhatsApp на другом телефоне или сменили телефон;
- обновился WhatsApp;
- перезагрузился телефон;
- номер заблокировали — это отдельная история, см. «Аккаунт попал в бан».
Ничего не помогло
Частые вопросы
Почему WhatsApp Web ломает интеграцию?
Наша интеграция работает по тому же протоколу, что и WhatsApp Web — «связанные устройства». WhatsApp разрешает только одно активное подключение через этот протокол на аккаунт. Открыли переписку в браузере или десктопе — наша сессия автоматически разрывается. Решение: не пользоваться WhatsApp Web/десктопом на подключённом к интеграции номере. Отвязать в приложении на телефоне: «Настройки» → «Связанные устройства» → выйти из ненужных.
Пересохранил интеграцию — а канал всё равно не работает. Что дальше?
Проверьте по порядку три вещи: (1) в «Настройках канала слетели» ниже — правильная ли открытая линия выбрана в карточке канала; (2) в списке линий — нет ли красного крестика у нужной линии, если есть — активируйте; (3) на плитке нашего канала в Контакт-центре Битрикс24 не должно быть галочки у стороннего сервиса WhatsApp (два одинаковых канала конфликтуют).
Как понять, что дело в самом Битрикс24, а не в нашей интеграции?
Откройте status.bitrix24.ru — там пишут о значительных сбоях. Если у Битрикс24 всё зелёное, но переписка не идёт — проблема на стороне номера или настроек, идите по чек-листу выше. Если у Битрикс24 сбой — просто ждём, чинить бесполезно.
Что делать, если один и тот же номер подключён к нескольким Битрикс24-порталам?
Так делать нельзя — один номер = один портал. WhatsApp считает второе подключение атакой и отвязывает номер. Решение: определитесь, в каком портале номер основной, из остальных удалите виджет нашей интеграции.
Помогает ли перезагрузка телефона?
Иногда да, но чаще — наоборот вредит: перезагрузка телефона может выкинуть аккаунт из «связанных устройств» и сессия разорвётся. Если решили перезагрузить — после включения телефона откройте WhatsApp, дождитесь синхронизации, потом заходите в RadistWeb и проверяйте статус подключения.
Логи хранятся сколько дней? Успею ли я написать в поддержку через неделю?
Технические логи по WhatsApp-сообщениям хранятся 5–6 дней — если сбой был раньше, восстановить не получится. Поэтому в поддержку пишите сразу, как заметили. Что приложить к обращению.