Erros de autorização
Erros de autorização do WhatsApp na solução de API do WhatsApp
Erros de autorização significam que a conexão entre Chakra e sua conta do WhatsApp perdeu o acesso — o token de acesso expirou, uma permissão foi removida ou o número não foi totalmente registrado. A maioria dos casos é resolvida reconectando o número no Chakra.
Erro 0 - Não foi possível autenticar o usuário do app
O que é afetado: Conta inteira · Tentar novamente ajuda? Após a correção · Onde corrigir: Chakra (reconectar), Meta Business Suite
O que você vê: As solicitações falham com o erro 0, informando que não foi possível autenticar o usuário do app.
Diagnóstico simples: O token de acesso usado pela conexão expirou ou foi revogado — por exemplo, o usuário que conectou o WhatsApp mudou a senha do Facebook, perdeu o acesso de administrador ou o app foi removido da empresa.
Solução 1 – Abordagem sugerida
1. Reconecte o número do WhatsApp no Chakra com uma conta de administrador do portfólio empresarial. Isso cria um novo token.
2. Confira se o Chakra ainda está listado em Meta Business Suite > Configurações > Integrações / Parceiros.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver, abra um chamado com o suporte do Chakra.
Erro 3 - Problema de capacidade ou permissões
O que é afetado: O recurso em uso · Tentar novamente ajuda? Após a correção · Onde corrigir: suporte do Chakra
O que você vê: Uma solicitação falha com o erro 3, indicando um problema de capacidade ou permissões.
Diagnóstico simples: A conexão não tem permissão para usar o recurso em questão.
Solução 1 – Abordagem sugerida
1. Reconecte o número no Chakra e aceite todas as permissões na janela da Meta.
2. Ainda falhando? Abra um chamado com o suporte do Chakra — geralmente, é preciso corrigir isso na plataforma.
Para quem usa a API: Confira o token no Access Token Debugger da Meta para whatsapp_business_messaging e whatsapp_business_management.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver, abra um chamado com o suporte do Chakra.
Erro 10 - Permissão negada
O que é afetado: Este número · Tentar novamente ajuda? Após a correção · Onde corrigir: WhatsApp Manager, Chakra (reconectar)
O que você vê: As mensagens falham com o erro 10, indicando permissão negada.
Diagnóstico simples: Na maioria das vezes, o número aparece como “Pendente” no WhatsApp Manager porque o registro não foi concluído. Também pode significar que uma permissão foi removida ou que o recurso não está disponível para esta conta.
Solução 1 – Abordagem sugerida
1. Confira o status do número em WhatsApp Manager > Números de telefone.
2. Se aparecer como Pendente: reinicie a conexão no Chakra e conclua a etapa do código de verificação; se continuar Pendente, exclua o número no WhatsApp Manager e reconecte.
3. Se aparecer como Conectado: reconecte no Chakra e aceite todas as permissões.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver, abra um chamado com o suporte do Chakra.
Erro 190 - Token de acesso expirado
O que é afetado: Conta inteira · Tentar novamente ajuda? Após a correção · Onde corrigir: Chakra (reconectar)
O que você vê: As solicitações falham com o erro 190, informando que o token de acesso expirou.
Diagnóstico simples: O token que o Chakra usa para sua conta do WhatsApp não é mais válido.
Solução 1 – Abordagem sugerida
1. Reconecte o número no Chakra pela janela de cadastro da Meta para autorizar novamente.
2. Use uma conta que continuará sendo administradora do portfólio empresarial.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver, abra um chamado com o suporte do Chakra.
Erro 200 - Nenhum token de acesso fornecido
O que é afetado: Esta solicitação · Tentar novamente ajuda? Após a correção · Onde corrigir: Sua integração de API
O que você vê: Uma solicitação falha com o erro 200, solicitando um ID de app válido.
Diagnóstico simples: A solicitação foi enviada sem nenhum token de acesso. É diferente do erro 190, em que um token é enviado, mas já expirou.
Solução 1 – Abordagem sugerida
1. Se você chama a API diretamente, confira se todas as solicitações incluem um token de acesso válido.
2. Se isso aparecer dentro do Chakra, abra um chamado.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver, abra um chamado com o suporte do Chakra.
Erro 200-299 - Permissão da API não concedida ou removida
O que é afetado: O recurso em uso · Tentar novamente ajuda? Após a correção · Onde corrigir: Chakra (reconectar)
O que você vê: Uma solicitação falha com um código de erro entre 200 e 299 relacionado a uma permissão ausente.
Diagnóstico simples: Uma permissão necessária para esta ação nunca foi concedida ou foi removida. A Meta documenta esse intervalo como um único grupo.
Solução 1 – Abordagem sugerida
1. Reconecte o número no Chakra e aceite todas as permissões na janela da Meta.
2. Para quem usa a API: confira o token no Access Token Debugger da Meta e solicite novamente a permissão que está faltando.
Solução 2 – Verificada pelo Chakra: Verificação em andamento. Se a Solução 1 não resolver, abra um chamado com o suporte do Chakra.
Ainda não conseguiu resolver?
Abra um chamado com o suporte do Chakra e informe seu número de telefone, o código de erro exato e quando o problema começou. Referência da Meta: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes