Erro 0 do WhatsApp: não foi possível autenticar o utilizador da app
O código de erro 0 indica que a Meta não conseguiu autenticar o utilizador da app associado ao token de acesso. A descrição da Meta diz: "We were unable to authenticate the app user." O token expirou, foi invalidado, ou o utilizador bloqueou o acesso de todas as apps aos seus dados. A solução é um novo token de acesso, não repetir o pedido.
O código da Meta para "We were unable to authenticate the app user."
Token expirado, token invalidado, ou o utilizador alterou uma definição que bloqueia todas as apps.
O código separado que a Meta lista para um token de acesso que expirou.
O que significa o código de erro 0 do WhatsApp?
Significa que a plataforma recebeu um pedido e não o conseguiu associar a um utilizador da app em que confie.
A Meta classifica o código 0 nos erros de autorização da referência de erros da Cloud API, com o texto de detalhes "We were unable to authenticate the app user." Os motivos possíveis que indica dizem todos respeito ao token: expirou, foi invalidado, ou a pessoa que o concedeu alterou uma definição que impede todas as apps de aceder aos seus dados.
Nada nessa lista diz respeito ao número de telefone, à conta WhatsApp Business ou à mensagem que se envia. O pedido nunca chegou suficientemente longe para que algum desses elementos fosse verificado.
Como se corrige o erro 0?
Obtenha um novo token de acesso. É o remédio que a Meta indica e é o único que funciona.
Antes de o substituir, apure qual das três causas se aplicou, porque cada uma volta a surgir se for ignorada. Um token de utilizador com curta duração voltará a expirar na data prevista. Um token invalidado continuará a falhar até alguém conceder novamente o acesso. Um utilizador que desativou por completo o acesso das apps tem de o reativar antes de qualquer token desse utilizador poder funcionar.
Para envios de servidor para servidor, o guia de tokens de acesso da Meta recomenda tokens de System User, que descreve como de longa duração e adequados a serviços automatizados que não precisam de intervenção do utilizador.
O erro 0 é o mesmo que o erro 190?
Sobrepõem-se na prática, mas a Meta lista-os em separado.
O erro 190 traz o texto de detalhes "Your access token has expired." O erro 0 é mais abrangente: cobre um token expirado, um token invalidado e um utilizador que bloqueou por completo o acesso das apps. Ambos constam da mesma tabela de autorização e ambos se resolvem com um novo token.
A diferença prática está no diagnóstico. Um 190 indica que o token expirou. Um 0 indica que a autenticação falhou e deixa a si a tarefa de apurar o motivo, o que vale a pena fazer antes de emitir um substituto que falhe exatamente da mesma forma uma hora depois.
Erros comuns
- Repetir o mesmo pedido. Um token não autenticado continua não autenticado, por isso cada nova tentativa devolve novamente o código 0.
- Voltar a ligar o número. O número nunca chegou a ser verificado, pelo que voltar a integrá-lo pede ao titular da empresa um trabalho que não altera nada.
- Emitir um novo token de utilizador de curta duração para uma tarefa de backend. Vai expirar na data prevista e o erro regressa.
A EasyCoexistence guarda um segundo token por cada ligação, pelo que, quando uma credencial é rejeitada, a outra continua a poder ler a conta e mostrar se o número em si está bem.
Perguntas frequentes
O erro 0 significa que o meu número foi desligado?
Não. Os motivos da Meta para o código 0 dizem todos respeito ao token de acesso. O número e a app do WhatsApp Business no telemóvel não estão envolvidos.
Onde está documentado o erro 0?
Na tabela de erros de autorização da referência de códigos de erro da Cloud API da Meta. A Cloud API assenta na Graph API, que usa o mesmo formato de erro.
Esperar faz o erro 0 desaparecer?
Não. Um token expirado ou invalidado não se recupera por si. É necessário um novo token.
Como verifico o que um token pode fazer?
Utilize o depurador de tokens de acesso da Meta ou o endpoint debug_token. Ambos mostram se o token é válido, quando expira e que permissões inclui.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em