Erro 131005 do WhatsApp: acesso negado, permissão ausente
O erro 131005 indica que o token de acesso não tem uma permissão exigida pelo endpoint do WhatsApp, porque ela nunca foi concedida ou foi removida depois. A descrição da Meta é "Permission is either not granted or has been removed." Para corrigir, inspecione o token com o depurador de token de acesso e conceda a permissão ausente ou troque por 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 usuários do WhatsApp.
business_management, whatsapp_business_management e whatsapp_business_messaging, atribuídas ao gerar um token de usuário do sistema.
O que significa o erro 131005 do WhatsApp?
Isso significa que o token é aceito como legítimo, mas não tem a permissão verificada pelo endpoint.
A referência da Cloud API da Meta lista o 131005 com o texto detalhado "Permission is either not granted or has been removed." O erro 10 da Graph API traz a mesma frase. A diferença está apenas na faixa: 10 é um código genérico da Graph API, enquanto 131005 pertence aos códigos do WhatsApp que começam com 131.
Como as palavras são iguais, o diagnóstico também é. Para ambos, a Meta recomenda usar o depurador de token de acesso e confirmar que o app tem as permissões exigidas pelo endpoint.
Qual permissão geralmente está faltando?
Geralmente, uma das duas permissões do WhatsApp. Qual delas depende do que a chamada faz.
O guia de permissões da Meta separa as permissões por função. whatsapp_business_messaging é necessária para enviar qualquer tipo de mensagem e receber webhooks de mensagens e status. whatsapp_business_management é necessária para metadados da conta, gerenciamento de templates, listagem de números de telefone, análises e webhooks da conta.
Um token gerado apenas com a permissão de gerenciamento pode ler a conta e listar templates, mas falha assim que tenta enviar uma mensagem. Ao gerar um token de usuário do sistema, o guia de token de acesso da Meta orienta atribuir business_management, whatsapp_business_management e whatsapp_business_messaging em conjunto.
Como corrigir o erro 131005?
Leia o token primeiro e altere apenas o que estiver faltando.
Chame o endpoint debug_token ou cole o token no depurador de token 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 uma permissão estiver ausente, gere um novo token que a inclua ou peça ao proprietário da empresa para concedê-la novamente, caso o token venha de um fluxo de parceiro. Se todas as permissões estiverem presentes e o erro continuar, verifique se o usuário do sistema por trás do token recebeu acesso à conta específica do WhatsApp Business. Um token pode ter todos os escopos necessários e ainda não estar atribuído a esse ativo.
Erros comuns
- Presumir que o token expirou. A expiração retorna 190 ou 0. Este código significa que o token funciona, mas não tem uma permissão.
- Gerar um token apenas com a permissão de gerenciamento e usá-lo para enviar mensagens. O envio exige whatsapp_business_messaging.
- Verificar os escopos e parar por aí. Um usuário do sistema também precisa receber acesso à conta específica do WhatsApp Business.
A EasyCoexistence integra cada número pelo Embedded Signup da Meta, no qual a empresa concede as permissões ao app. Seu conector MCP informa a saúde do número para o assistente verificar antes do envio.
Perguntas frequentes
O 131005 é o mesmo erro que o 10?
Eles têm a mesma descrição na referência da Meta. O 131005 pertence à faixa do WhatsApp, e o 10, à faixa da Graph API.
Uma permissão pode ser removida depois da configuração?
Sim. A descrição da Meta cobre explicitamente permissões removidas, não apenas as que nunca foram concedidas.
O erro 131005 afeta o app do WhatsApp Business no celular?
Não. Ele diz respeito ao token da API. O app no celular continua funcionando normalmente.
Devo repetir a requisição após o erro 131005?
Não. Repetir com o mesmo token produz o mesmo resultado. Corrija a permissão primeiro.
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