Номер перестал работать: как выяснить причину
Когда подключённый номер перестаёт работать, причина почти никогда не в коде. Проверяйте по частоте: истёкший токен, потерянное после повторного подключения переопределение вебхука, отключение после четырнадцати дней бездействия, падение рейтинга качества и ограничение аккаунта.
Причины, которые объясняют почти каждый тихий сбой.
Ошибка истёкшего токена, которая выглядит как исчезнувший номер.
Событие, однозначно сообщающее об отключении.
Почему в телефоне всё выглядит нормально?
Потому что приложение WhatsApp Business и API работают независимо друг от друга, используя один номер, и почти каждый сбой затрагивает только одну из этих сторон.
Токен истекает, а приложение продолжает работать. Переопределение вебхука удаляется, а приложение продолжает работать. Рейтинг качества снижается, а приложение продолжает работать. Во всех случаях компания продолжает отвечать клиентам, видит обычное поведение и не находит причины сообщать о проблеме.
Именно поэтому нужен мониторинг, а не панель управления, которую кто-то время от времени проверяет. Сбои реальны и незаметны, а люди, которые ближе всего к номеру, с наименьшей вероятностью их заметят.
В каком порядке всё проверять?
Начните с токена: это самая частая причина, и её дешевле всего устранить. Истёкшие или отозванные учётные данные заставляют каждый вызов завершаться одинаково, поэтому кажется, будто номер удалён. Проверка с помощью второго токена для того же аккаунта позволяет отличить эти случаи.
Затем проверьте переопределение вебхука. Если было повторное подключение, адрес назначения удалился вместе с приложением. Отправка и мониторинг работают, но доставка на ваш сервер незаметно прекращается.
Затем проверьте отключение: событие account_update с PARTNER_REMOVED и причиной. PRIMARY_INACTIVITY означает, что приложение не открывали около четырнадцати дней, и повторное подключение исправляет проблему.
Далее проверьте рейтинг качества, который получают через опрос, а не отправляют автоматически. В последнюю очередь проверьте ограничение аккаунта: это мера на уровне аккаунта, которую ни один провайдер не может снять.
Что почти никогда не является причиной?
Ваш код, если вчера он работал и после этого ничего не разворачивали.
Cloud API стабилен, а структура его запросов не меняется сама по себе. Если интеграция, работавшая месяцами, останавливается, почти наверняка причина в учётных данных, изменении маршрутизации или событии на уровне аккаунта. Всё это может произойти без изменений в репозитории.
Стоит отдельно упомянуть шаблон, который кто-то отредактировал. Изменение числа переменных в шаблоне меняет условия для каждого отправителя и происходит незаметно. Это похоже на сбой кода, хотя на самом деле является изменением содержимого в WhatsApp Manager, которое внёс кто-то другой.
Распространённые ошибки
- Сначала повторно подключать номер. Если истёк токен, владелец компании выполнит ненужную работу.
- Считать, что сломался код. Стабильный API и отсутствие развёртываний указывают на другую причину.
- Искать симптомы в телефоне. Приложение продолжает работать почти при всех этих сбоях.
EasyCoexistence непрерывно проверяет все пять причин и записывает каждую в историю подключения. Поэтому диагностика начинается с события с датой, а не с догадки.
Часто задаваемые вопросы
Номер работает в телефоне, но ничего не отправляется. С чего начать?
С токена доступа. Это самая частая причина и та, что сильнее всего похожа на удалённый номер.
Я повторно подключил номер, но сообщения по-прежнему не доходят до моего сервера.
Переопределение вебхука удалилось вместе с приложением. Его нужно применить заново, а мы делаем это автоматически.
Как понять, что сработало правило четырнадцати дней?
Отключение приходит с причиной PRIMARY_INACTIVITY в событии account_update.
Может ли изменение шаблона нарушить отправку сообщений?
Да. Это единственная причина, похожая на сбой кода. Изменение числа переменных меняет условия для каждого отправителя.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на