Erro 10 do WhatsApp: permissão não concedida ou removida
O código de erro 10 significa que o token da app não tem uma permissão de que o endpoint precisa, ou porque nunca foi concedida ou porque foi removida. A descrição da Meta é "Permission is either not granted or has been removed." A Meta indica ainda duas causas específicas do WhatsApp: um número que não consta da lista de permissões nos Flows com 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 que o guia de tratamento de erros da Graph API dá ao código 10.
O que uma app de parceiro precisa para cada permissão que usa em contas de clientes.
O que significa o código de erro 10 do WhatsApp?
Significa que o token chegou à Meta e foi reconhecido, mas a permissão exigida pela chamada não consta dele.
A referência da Cloud API da Meta atribui ao código 10 o texto de detalhes "Permission is either not granted or has been removed." O guia de tratamento de erros da Graph API chama-lhe API Permission Denied e indica que se deve tratar a permissão em falta.
A palavra removida é importante. Uma permissão pode ser concedida na configuração inicial e retirada mais tarde, por exemplo quando alguém revoga o acesso da app nas Definições da empresa, pelo que uma integração que funcionou durante meses pode começar a devolver o erro 10 sem qualquer alteração ao seu próprio código.
Que outras causas indica a Meta para o erro 10?
Duas que são específicas do WhatsApp, e ambas passam facilmente despercebidas porque nada têm que ver com permissões.
Nos WhatsApp Flows com Endpoint, a Meta indica que se deve confirmar que o número de telefone usado para definir a chave pública da empresa consta da lista de permissões. Um número fora dessa lista origina este código mesmo que o token tenha todas as permissões.
A Meta refere também que uma conta que não cumpra os requisitos de elegibilidade da API que está a chamar recebe este código. Nesse caso, nenhuma alteração ao token resolve, porque o obstáculo é a elegibilidade da conta e não a credencial.
Como se corrige o erro 10?
Comece pelo depurador de tokens de acesso, que a Meta indica como primeira verificação.
Se a lista de permissões do token não incluir a que o endpoint exige, peça à empresa que a conceda de novo. Numa app de parceiro, isso implica também confirmar o Acesso avançado para essa permissão, uma vez que o guia de permissões da Meta o exige para contas de clientes.
Se as permissões parecerem completas, passe às duas causas específicas do WhatsApp. Numa chamada de Flows, verifique a lista de permissões para o número que definiu a chave pública. Em qualquer outro caso, leia os requisitos de elegibilidade da API que está a chamar e confirme que a conta os cumpre antes de alterar qualquer credencial.
Erros comuns
- Presumir que a integração falhou por causa de uma publicação. Uma permissão removida nas Definições da empresa produz este código sem qualquer alteração ao código.
- Refazer o token quando a causa é a elegibilidade. Uma credencial não torna elegível uma conta que não o é.
- Ignorar a lista de permissões dos Flows. Nos Flows com Endpoint, um número que não conste dela devolve o erro 10 mesmo com todas as permissões.
A EasyCoexistence continua a vigiar cada número ligado após o onboarding, pelo que uma ligação que perde o acesso aparece no painel em vez de se manifestar primeiro como envios falhados.
Perguntas frequentes
O erro 10 é o mesmo que o erro 131005?
Partilham a mesma descrição na referência da Meta. O código 10 é o código da Graph API e o 131005 pertence à gama do WhatsApp. Ambos se verificam da mesma forma.
O erro 10 pode surgir num número que funcionava ontem?
Sim. A descrição da Meta inclui permissões que foram removidas, pelo que um acesso concedido anteriormente pode ser retirado mais tarde.
O erro 10 significa que o meu token expirou?
Não. Um token expirado devolve o código 190 ou 0. O código 10 significa que o token é válido, mas não tem uma permissão.
Como vejo que permissões foram concedidas?
Chame debug_token ou abra o depurador de tokens de acesso. A propriedade scopes lista todas as permissões do token.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em