ChakraHQChakraHQ

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

Nesta página