Ошибка WhatsApp 190: токен доступа истёк
Ошибка 190 означает, что токен доступа для запроса истёк или был отозван. Каждый вызов завершается одинаково, поэтому кажется, будто номер исчез. Но он на месте: проблема в учётных данных, а сам номер обычно исправен.
Код Meta для истёкшего или отозванного токена доступа.
Код Meta для того же состояния, отображаемого как ошибка аутентификации.
EasyCoexistence хранит учётные данные для каждого подключения, поэтому причину отказа можно определить.
Почему истёкший токен выглядит как пропавший номер?
Потому что каждый запрос завершается ошибкой, причём одинаково.
Чтение номера, проверка его состояния, список шаблонов и отправка сообщения одновременно перестают работать. Со стороны это неотличимо от удаления номера из аккаунта, а интеграция с одними учётными данными не может различить эти два случая. Многие решают, что подключение потеряно, хотя ничего подобного не произошло.
Разница важна, потому что действия в этих случаях противоположны. Сломанные учётные данные заменяют. Удалённый номер подключают заново, а для этого нужны владелец бизнеса и телефон.
Как отличить эти случаи?
Нужно иметь вторые учётные данные, которые могут прочитать тот же аккаунт.
EasyCoexistence хранит токен клиента и собственный токен System User для каждого подключения. Когда один токен отклонён, второй читает WhatsApp Business Account и показывает, что именно сломалось. Если токен клиента отклонён, а второй токен работает, значит, учётные данные истекли, а номер исправен. Если не работают оба, проблема, вероятно, связана с самим номером.
Без второго средства чтения отличить эти случаи можно только попросив владельца бизнеса проверить всё вручную. Именно такие перерывы мониторинг и должен предотвращать.
Как токены становятся недействительными?
Есть несколько причин, и большинство из них не связано с намеренными действиями.
У токенов есть срок действия, после которого они истекают. Смена пароля аккаунта Meta делает их недействительными. То же происходит, если кто-то удаляет доступ приложения в Business Settings или Meta отзывает токен, посчитав его скомпрометированным. Ни одна из этих причин не сопровождается предварительным оповещением, и их нельзя увидеть в приложении WhatsApp Business на телефоне.
Поэтому проверка токена должна быть частью мониторинга, а не обработчика ошибок. Когда обработчик замечает проблему, отправка сообщений уже завершилась ошибкой.
Распространённые ошибки
- Подключать номер заново. Если проблема в токене, владелец бизнеса выполнит ненужную работу.
- Считать проблему временной и повторять попытку. Отозванный токен сам по себе не восстановится.
- Полагаться на одни учётные данные. С одним токеном нельзя отличить ошибку учётных данных от потери номера.
EasyCoexistence хранит два токена для каждого подключения, поэтому отклонённые учётные данные определяются, а не угадываются. Сломанный токен понижается в статусе, а номер не отключается.
Часто задаваемые вопросы
Номер всё ещё работает?
Обычно да. Приложение WhatsApp Business продолжает работать, и сам номер не повреждён. Прекратился только доступ через API.
Ошибка 0 означает то же самое?
По сути, да. Meta сообщает об этом состоянии с помощью обоих кодов, в зависимости от эндпоинта.
Поможет ли повторное подключение?
Да, но это слишком сложное решение для простой проблемы. Оно требует участия владельца бизнеса и телефона, хотя достаточно создать новые учётные данные.
Можно сделать так, чтобы токены не истекали?
Токены System User могут иметь длительный срок действия. Поэтому полезно хранить второй токен.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на