Erro 3 do WhatsApp: problema de capacidade ou permissões
O código de erro 3 indica que o app que chama o endpoint não tem uma capacidade ou permissão exigida por esse endpoint. A descrição da Meta é "Capability or permissions issue." A Graph API o chama de API Method. A correção é verificar as permissões concedidas ao token com o depurador de access token e adicionar a que o endpoint exige.
O código da Meta para "Capability or permissions issue."
O nome dado ao código 3 pelo guia de tratamento de erros da Graph API.
whatsapp_business_management e whatsapp_business_messaging, exigidas pela maioria dos endpoints do WhatsApp.
O que significa o código de erro 3 do WhatsApp?
Isso significa que a requisição foi autenticada, mas o app não tem autorização para fazer o que solicitou.
A Meta lista o código 3 entre os erros de autorização na referência da Cloud API, com o texto de detalhes "Capability or permissions issue." O guia de tratamento de erros da Graph API, herdado pela Cloud API, chama o mesmo código de API Method e orienta verificar se o app tem a capacidade ou as permissões necessárias para a chamada.
Portanto, o token funciona. A identidade não é o problema, e isso diferencia o erro dos códigos 0 e 190. O problema está no que o token está autorizado a acessar.
Como verificar quais permissões um token tem?
Use o depurador de access token ou o endpoint debug_token, que retorna as mesmas informações.
A resposta lista as permissões concedidas na propriedade scopes. Compare essa lista com a página de referência do endpoint que falhou, pois cada referência informa as permissões exigidas.
No WhatsApp, duas permissões cobrem quase tudo. whatsapp_business_management é necessária para metadados da conta, templates, listagens de números, análises e webhooks da conta. whatsapp_business_messaging é necessária para enviar qualquer mensagem e receber webhooks de mensagens e status. Um token que tenha apenas uma delas falha nas chamadas que exigem a outra.
Por que um app parceiro pode ver o erro 3 quando um desenvolvedor direto não vê?
Porque parceiros que atendem outras empresas passam por uma etapa adicional.
O guia de permissões da Meta informa que um parceiro cujos clientes usam seu app para acessar os próprios dados precisa passar pela App Review e ter Advanced access para cada permissão exigida pelo app. Um desenvolvedor direto que trabalha apenas com os dados da própria empresa não precisa de App Review nem de Advanced access.
Assim, o mesmo código pode funcionar na conta do próprio desenvolvedor e falhar na conta de um cliente. Quando isso acontece, a questão não é qual permissão falta no token, mas se o app foi aprovado para usar essa permissão em ativos que não pertencem a ele.
Erros comuns
- Gerar um novo token com os mesmos escopos. Um token novo com as mesmas permissões falha no mesmo ponto.
- Verificar o nome da permissão nas configurações do app em vez de conferir o token. O que importa é o que foi concedido ao token.
- Testar apenas na própria conta. Apps parceiros precisam de Advanced access antes que contas de clientes aceitem a chamada.
A EasyCoexistence conecta cada número pelo próprio fluxo Embedded Signup da Meta. Assim, a empresa concede as permissões durante o onboarding, e a saúde da conexão permanece visível no painel depois.
Perguntas frequentes
O erro 3 é um problema com meu número?
Não. Ele diz respeito ao que o token do app está autorizado a fazer. O número não é verificado antes de a requisição ser recusada.
Qual é a diferença entre o erro 3 e o erro 10?
O código 3 indica um problema de capacidade ou permissões. O código 10 informa que uma permissão não foi concedida ou foi removida. Ambos são resolvidos verificando os escopos do token.
Qual permissão preciso para enviar mensagens?
whatsapp_business_messaging. O guia de permissões da Meta informa que ela é necessária para enviar qualquer tipo de mensagem.
Repetir a requisição ajuda?
Não. As permissões do token não mudam entre as tentativas, então o resultado é o mesmo.
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