"Seu app não tem as permissões necessárias da Graph API para o pareamento de companhia da Cloud API"
Esta mensagem significa que a plataforma que iniciou o cadastro não tem as permissões do WhatsApp exigidas pela Meta, no nível de acesso exigido, para conectar um número do app do WhatsApp Business à Cloud API. A Meta só permite que uma empresa conceda permissões para as quais a plataforma tenha Advanced access. A empresa não pode corrigir isso; a plataforma precisa fazê-lo.
O que um parceiro precisa ter para cada permissão antes que seus clientes possam concedê-la pelo Embedded Signup.
As chamadas da API retornam o erro quando whatsapp_business_management é usado sem Advanced access em contas que o app não possui.
whatsapp_business_management e whatsapp_business_messaging, as duas permissões que a Meta diz que as integrações do WhatsApp geralmente precisam.
A Meta exige que a plataforma já seja Solution Partner ou Tech Provider para cadastrar usuários do app do WhatsApp Business.
O que essa mensagem significa?
O texto completo é: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." As referências públicas de erros da Meta não listam exatamente essa redação, mas cada parte corresponde a algo que a Meta documenta.
"Seu app" é o app da Meta da plataforma que executa o cadastro, não o app do WhatsApp Business no telefone. A Meta não define publicamente o pareamento de companhia; pelo contexto, ele descreve a Cloud API conectando-se a um número que continua registrado no app do WhatsApp Business, que é a configuração de Coexistência. E as permissões "advanced" do WhatsApp Business referem-se ao Advanced access, o nível concedido pela Meta por meio da análise do app.
Quais permissões estão envolvidas?
A documentação de permissões da Meta cita duas que as integrações do WhatsApp geralmente precisam. whatsapp_business_management abrange metadados da conta, templates, números de telefone, análises e webhooks da conta. whatsapp_business_messaging abrange o envio de mensagens e o recebimento de webhooks de mensagens e status.
Para um parceiro cujos clientes usam seu app, a Meta exige análise do app e Advanced access para cada permissão necessária. A Meta declara diretamente a consequência: sem Advanced access para uma permissão, os clientes não podem concedê-la ao app pelo Embedded Signup. Chamadas feitas com whatsapp_business_management em contas que o app não possui, sem Advanced access, retornam o erro 200.
Uma plataforma pode verificar o que uma empresa realmente concedeu inspecionando o token com o endpoint debug_token da Meta, que lista as permissões concedidas em scopes.
O que a empresa pode fazer?
Muito pouco do próprio lado, e ela não deve tentar alterar as configurações da Meta para resolver isso. A correção depende da plataforma: ela precisa ser Tech Provider ou Solution Partner, requisito que a Meta lista para cadastrar usuários do app do WhatsApp Business, e precisa ter Advanced access aprovado para as permissões do WhatsApp.
A empresa pode informar a mensagem exata à plataforma e repetir o processo quando a plataforma confirmar seu acesso, ou usar uma plataforma que já tenha esse status. Repetir o mesmo fluxo na mesma plataforma antes disso produz o mesmo resultado e não afeta o app do WhatsApp Business no telefone.
Erros comuns
- Conceder mais permissões nas próprias configurações da Meta da empresa. O acesso ausente pertence ao app da plataforma.
- Hospedar uma ferramenta por conta própria em um app de desenvolvedor sem análise do app. Sem Advanced access, as empresas não podem conceder as permissões necessárias.
- Repetir várias vezes na mesma plataforma. O resultado só muda quando o acesso dessa plataforma muda.
A EasyCoexistence é uma Tech Provider independente da Meta, com seu próprio app da Meta, e executa o Embedded Signup v4 para Coexistência. Assim, as empresas conectam seu número por uma plataforma que já tem o acesso exigido pela Meta.
Perguntas frequentes
Há algum problema com meu app do WhatsApp Business?
Não. A mensagem se refere ao app da Meta da plataforma, não ao app no seu telefone, que continua funcionando.
Posso conceder a permissão por conta própria?
Somente as permissões para as quais a plataforma tem Advanced access aparecem para você conceder. Primeiro, o acesso ausente precisa ser aprovado para a plataforma.
Como uma plataforma obtém Advanced access?
Por meio da análise do app pela Meta para cada permissão necessária ao app, como parceira cujos clientes usam o app.
A empresa precisa passar pela análise do app?
Não. A Meta diz que um desenvolvedor que acessa diretamente apenas os próprios dados comerciais não precisa de análise do app nem de Advanced access.
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