Erro 10 do WhatsApp: permissão não concedida ou removida
O código de erro 10 significa que o token do app não tem uma permissão necessária para o endpoint, porque ela nunca foi concedida ou foi removida. A descrição da Meta é "Permission is either not granted or has been removed." A Meta também lista duas causas no WhatsApp: um número fora da lista de permissão em Flows with Endpoint e o não cumprimento dos requisitos de elegibilidade de uma API.
O código da Meta para "Permission is either not granted or has been removed."
O nome dado ao código 10 no guia de tratamento de erros da Graph API.
O que um app parceiro precisa para cada permissão usada nas contas dos clientes.
O que significa o código de erro 10 do WhatsApp?
Isso significa que o token chegou à Meta e foi reconhecido, mas não contém a permissão exigida pela chamada.
A referência da Cloud API do WhatsApp atribui ao código 10 o texto detalhado "Permission is either not granted or has been removed." O guia de tratamento de erros da Graph API o chama de API Permission Denied e orienta tratar a permissão ausente.
A palavra removida é importante. Uma permissão pode ser concedida na configuração e retirada depois, por exemplo quando alguém revoga o acesso do app nas Configurações do Negócio. Assim, uma integração que funcionou por meses pode começar a retornar 10 sem nenhuma mudança no próprio código.
Quais outras causas a Meta lista para o erro 10?
Há duas causas específicas do WhatsApp, e ambas passam facilmente despercebidas porque não têm relação com escopos.
Para Flows with Endpoint do WhatsApp, a Meta orienta verificar se o número de telefone usado para configurar a chave pública do negócio está na lista de permissão. Um número fora dessa lista produz esse código mesmo quando o token contém todas as permissões.
A Meta também informa que uma conta que não cumpre os requisitos de elegibilidade da API chamada recebe esse código. Nesse caso, nenhuma alteração no token ajudará, porque a barreira é a elegibilidade da conta, e não a credencial.
Como corrigir o erro 10?
Comece pelo depurador de token de acesso, que a Meta indica como primeira verificação.
Se a lista de escopos não tiver a permissão exigida pelo endpoint, peça ao negócio que a conceda novamente. Para um app parceiro, isso também significa confirmar o acesso avançado à permissão, pois o guia de permissões da Meta o exige para contas de clientes.
Se os escopos estiverem completos, verifique as duas causas específicas do WhatsApp. Em uma chamada de Flows, confira a lista de permissão do número que configurou a chave pública. Em qualquer outro caso, leia os requisitos de elegibilidade da API chamada e confirme se a conta os cumpre antes de alterar qualquer credencial.
Erros comuns
- Supor que a integração parou por causa de uma implantação. Uma permissão removida nas Configurações do Negócio produz esse código sem nenhuma alteração no código.
- Recriar o token quando a causa é a elegibilidade. Uma credencial não pode tornar elegível uma conta inelegível.
- Ignorar a lista de permissão de Flows. Em Flows with Endpoint, um número fora dela retorna 10 mesmo com todos os escopos.
A EasyCoexistence continua monitorando cada número conectado após a integração. Assim, uma conexão que perde acesso aparece no painel, em vez de surgir primeiro como envio falho.
Perguntas frequentes
O erro 10 é igual ao erro 131005?
Eles compartilham a mesma descrição na referência da Meta. O código 10 é o código da Graph API, enquanto 131005 pertence à faixa do WhatsApp. Ambos são verificados da mesma forma.
O erro 10 pode aparecer em um número que funcionou ontem?
Sim. A descrição da Meta inclui permissões removidas, então um acesso concedido anteriormente pode ser retirado depois.
O erro 10 significa que meu token expirou?
Não. Um token expirado corresponde ao código 190 ou 0. O código 10 significa que o token é válido, mas não tem uma permissão.
Como vejo quais permissões foram concedidas?
Chame debug_token ou abra o depurador de token de acesso. A propriedade scopes lista todas as permissões presentes no token.
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