Erro 0 do WhatsApp: não foi possível autenticar o usuário do app
O código de erro 0 significa que a Meta não conseguiu autenticar o usuário do app por trás do token de acesso. A descrição da Meta diz: "We were unable to authenticate the app user." O token expirou, foi invalidado ou o usuário bloqueou todos os apps de acessar os próprios dados. A correção é obter um novo token de acesso, não repetir a requisição.
Código da Meta para "We were unable to authenticate the app user."
Token expirado, token invalidado ou usuário alterou uma configuração que bloqueia todos os apps.
O código separado que a Meta lista para um token de acesso expirado.
O que significa o código de erro 0 do WhatsApp?
Isso significa que a plataforma recebeu uma requisição, mas não conseguiu associá-la a um usuário do app em que confia.
A Meta classifica o código 0 entre os erros de autorização na referência de erros da Cloud API, com o texto de detalhes "We were unable to authenticate the app user." Os possíveis motivos estão todos relacionados ao token: ele expirou, foi invalidado ou a pessoa que o autorizou alterou uma configuração que impede todos os apps de acessar os dados dela.
Nada nessa lista diz respeito ao número de telefone, à conta do WhatsApp Business ou à mensagem enviada. A requisição não avançou o suficiente para verificar nenhum desses itens.
Como corrigir o erro 0?
Obtenha um novo token de acesso. Esse é o recurso indicado pela Meta e o único que funciona.
Antes de substituí-lo, descubra qual das três causas se aplicou, pois cada uma voltará a ocorrer se for ignorada. Um token de usuário com validade curta expirará novamente no prazo previsto. Um token invalidado continuará falhando até que alguém conceda acesso outra vez. Um usuário que desativou completamente o acesso dos apps precisa reativá-lo antes que qualquer token desse usuário funcione.
Para envios de servidor para servidor, o guia de tokens de acesso da Meta recomenda tokens de System User, descritos como de longa duração e adequados a serviços automatizados que não exigem interação do usuário.
O erro 0 é igual ao erro 190?
Na prática, eles se sobrepõem e são listados separadamente pela Meta.
O erro 190 traz o texto de detalhes "Your access token has expired." O erro 0 é mais amplo: abrange um token expirado, um token invalidado e um usuário que bloqueou completamente o acesso dos apps. Ambos aparecem na mesma tabela de autorização e, nos dois casos, a solução é obter um novo token.
A diferença prática está no diagnóstico. O erro 190 informa que o token perdeu a validade. O erro 0 informa que a autenticação falhou e exige que você descubra o motivo. Vale fazer isso antes de emitir uma substituição que falhe exatamente da mesma forma uma hora depois.
Erros comuns
- Repetir a mesma requisição. Um token não autenticado continua não autenticado, então toda repetição retorna o código 0 novamente.
- Reconectar o número. O número nunca foi verificado, portanto cadastrá-lo outra vez apenas dá trabalho ao responsável pela empresa sem mudar nada.
- Emitir um novo token de usuário de curta duração para uma tarefa de backend. Ele expirará no prazo previsto e o erro voltará.
A EasyCoexistence mantém um segundo token para cada conexão. Assim, quando uma credencial é rejeitada, a outra ainda pode ler a conta e mostrar se o próprio número está funcionando.
Perguntas frequentes
O erro 0 significa que meu número foi desconectado?
Não. Os motivos indicados pela Meta para o código 0 estão todos relacionados ao token de acesso. O número e o app do WhatsApp Business no telefone não estão envolvidos.
Onde o erro 0 está documentado?
Na tabela de erros de autorização da referência de códigos de erro da Cloud API da Meta. A Cloud API é baseada na Graph API, que usa o mesmo formato de erro.
Esperar fará o erro 0 desaparecer?
Não. Um token expirado ou invalidado não se recupera sozinho. É necessário obter um novo token.
Como verifico o que um token pode fazer?
Use o depurador de tokens de acesso da Meta ou o endpoint debug_token. Ambos mostram se o token é válido, quando expira e quais permissões ele possui.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em