Erro 131005 do WhatsApp: acesso negado, permissão em falta
O erro 131005 significa que o token de acesso não tem uma permissão exigida pelo endpoint do WhatsApp, porque nunca foi concedida ou foi removida entretanto. A descrição da Meta é "Permission is either not granted or has been removed." Para o resolver, inspecione o token com o depurador de tokens de acesso e conceda a permissão em falta ou passe a usar um token que a tenha.
Código da Meta para "Permission is either not granted or has been removed."
A permissão necessária para enviar qualquer tipo de mensagem a utilizadores do WhatsApp.
business_management, whatsapp_business_management e whatsapp_business_messaging, atribuídas ao gerar um token de utilizador do sistema.
O que significa o erro 131005 do WhatsApp?
Significa que o token é aceite como autêntico, mas não tem a permissão que o endpoint verifica.
A referência da Cloud API da Meta lista o 131005 com o texto de detalhe "Permission is either not granted or has been removed." O erro 10 da Graph API tem exatamente a mesma frase. A diferença está apenas na gama: o 10 é um código genérico da Graph API, enquanto o 131005 pertence aos códigos do WhatsApp que começam por 131.
Como as palavras são as mesmas, o diagnóstico é o mesmo. A solução que a Meta indica para ambos é usar o depurador de tokens de acesso e confirmar que a app tem as permissões exigidas pelo endpoint.
Que permissão costuma estar em falta?
Normalmente uma das duas permissões do WhatsApp, e qual delas depende do que a chamada faz.
O guia de permissões da Meta divide-as por função. A whatsapp_business_messaging é necessária para enviar qualquer tipo de mensagem e para receber webhooks de mensagens e de estado. A whatsapp_business_management é necessária para os metadados da conta, a gestão de templates, a listagem de números de telefone, as estatísticas e os webhooks da conta.
Um token gerado apenas com a permissão de gestão consegue ler a conta e listar templates, mas falha no momento em que tenta enviar. Ao gerar um token de utilizador do sistema, o guia de tokens de acesso da Meta indica que se atribuam em conjunto business_management, whatsapp_business_management e whatsapp_business_messaging.
Como se resolve o erro 131005?
Leia primeiro o token e altere só o que falta.
Chame o endpoint debug_token ou cole o token no depurador de tokens de acesso. A propriedade `scopes` lista todas as permissões concedidas. Compare-a com a página de referência do endpoint que falhou.
Se faltar uma permissão, gere um novo token que a inclua ou peça ao proprietário da empresa que a conceda de novo, caso o token venha de um fluxo de parceiro. Se todas as permissões estiverem presentes e o erro persistir, verifique se o utilizador do sistema associado ao token tem acesso à conta WhatsApp Business específica, pois um token pode ter todos os âmbitos e, mesmo assim, não estar atribuído a esse ativo.
Erros comuns
- Presumir que o token expirou. A expiração devolve 190 ou 0. Este código indica que o token funciona, mas não tem uma permissão.
- Gerar um token apenas com a permissão de gestão e usá-lo para enviar. O envio exige whatsapp_business_messaging.
- Verificar os âmbitos e ficar por aí. O utilizador do sistema também precisa de ter acesso concedido a essa conta WhatsApp Business específica.
A EasyCoexistence regista cada número através do Embedded Signup da Meta, onde a empresa concede à app as suas permissões, e o seu conector MCP indica o estado de um número para que um assistente possa verificar antes de enviar.
Perguntas frequentes
O 131005 é o mesmo erro que o 10?
Têm a mesma descrição na referência da Meta. O 131005 pertence à gama do WhatsApp e o 10 à gama da Graph API.
Uma permissão pode ser removida depois da configuração?
Sim. A descrição da Meta abrange expressamente as permissões que foram removidas, e não só as que nunca foram concedidas.
O erro 131005 afeta a app WhatsApp Business no telemóvel?
Não. Diz respeito ao token da API. A app no telemóvel continua a funcionar como antes.
Devo voltar a tentar depois do erro 131005?
Não. Voltar a tentar com o mesmo token produz o mesmo resultado. Corrija primeiro a permissão.
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