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