"Your app is missing required Graph API permissions for Cloud API companion pairing"
Esta mensagem significa que a plataforma que iniciou o registo não tem as permissões do WhatsApp que a Meta exige, ao nível de acesso que a Meta exige, para ligar à Cloud API o número de uma app WhatsApp Business. A Meta só permite que uma empresa conceda permissões para as quais a plataforma tenha acesso Advanced. A empresa não o consegue corrigir; tem de ser a plataforma.
O que um parceiro precisa de ter para cada permissão antes de os seus clientes a poderem conceder através do Embedded Signup.
O erro que as chamadas à API devolvem quando whatsapp_business_management é usada sem acesso Advanced em contas que a app não possui.
whatsapp_business_management e whatsapp_business_messaging, as duas que, segundo a Meta, as integrações com o WhatsApp geralmente exigem.
A Meta exige que a plataforma já seja Solution Partner ou Tech Provider para integrar utilizadores da app WhatsApp Business.
O que significa a mensagem?
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 esta formulação exata, mas cada parte dela corresponde a algo que a Meta documenta.
"Your app" é a app Meta da plataforma que executa o registo, não a app WhatsApp Business que está no telemóvel. A Meta não define publicamente companion pairing; lido em contexto, descreve a Cloud API a juntar-se a um número que continua registado na app WhatsApp Business, que é o modelo da Coexistence. E as permissões "advanced" do WhatsApp Business referem-se ao acesso Advanced, o nível que a Meta concede através da App Review.
Que permissões estão envolvidas?
A documentação de permissões da Meta indica duas que as integrações com o WhatsApp geralmente exigem. A whatsapp_business_management abrange metadados da conta, templates, números de telefone, análises e webhooks da conta. A whatsapp_business_messaging abrange o envio de mensagens e a receção de webhooks de mensagens e de estado.
Para um parceiro cujos clientes usam a sua app, a Meta exige App Review e acesso Advanced para cada permissão de que a app precisa. A Meta indica a consequência de forma direta: sem acesso Advanced para uma permissão, os clientes não a podem conceder à app através do Embedded Signup. As chamadas feitas com whatsapp_business_management em contas que a app não possui, sem acesso Advanced, devolvem o erro 200.
Uma plataforma pode verificar o que a empresa concedeu realmente, inspecionando o token com o endpoint debug_token da Meta, que lista as permissões concedidas em scopes.
O que pode a empresa fazer?
Muito pouco do seu lado, e não deve tentar alterar as definições da Meta para resolver isto. A solução está na plataforma: tem de ser Tech Provider ou Solution Partner, o que a Meta indica como requisito para integrar utilizadores da app WhatsApp Business, e tem de ter o acesso Advanced aprovado para as permissões do WhatsApp.
O que a empresa pode fazer é comunicar a mensagem exata à plataforma, voltar a tentar quando a plataforma confirmar o seu acesso, ou usar uma plataforma que já tenha esse estatuto. Repetir o mesmo fluxo na mesma plataforma antes disso produz o mesmo resultado e não afeta a app WhatsApp Business no telemóvel.
Erros comuns
- Conceder mais permissões nas definições Meta da própria empresa. O acesso em falta pertence à app da plataforma.
- Alojar uma ferramenta própria numa app de programador sem App Review. Sem acesso Advanced, as empresas não podem conceder as permissões necessárias.
- Voltar a tentar repetidamente na mesma plataforma. O resultado só muda quando o acesso dessa plataforma mudar.
A EasyCoexistence é um Meta Tech Provider independente, com a sua própria app Meta, e executa o Embedded Signup v4 para a Coexistence, pelo que as empresas ligam o seu número através de uma plataforma que já tem o acesso que a Meta exige.
Perguntas frequentes
Há algum problema com a minha app WhatsApp Business?
Não. A mensagem refere-se à app Meta da plataforma, não à app que tem no telemóvel, que continua a funcionar.
Posso conceder a permissão eu próprio?
Só aparecem para conceder as permissões para as quais a plataforma tem acesso Advanced. O acesso em falta tem de ser primeiro aprovado para a plataforma.
Como obtém uma plataforma o acesso Advanced?
Através da Meta App Review, para cada permissão de que a sua app precisa, enquanto parceiro cujos clientes usam a app.
A empresa precisa de App Review?
Não. A Meta indica que um programador direto que acede apenas aos dados da sua própria empresa não precisa de App Review nem de acesso Advanced.
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