"Your app is missing required Graph API permissions for Cloud API companion pairing"
Questo messaggio significa che la piattaforma che ha avviato la registrazione non ha i permessi WhatsApp richiesti da Meta, al livello di accesso richiesto da Meta, per collegare a Cloud API il numero di un'app WhatsApp Business. Meta consente a un'azienda di concedere solo i permessi per cui la piattaforma ha l'Advanced access. L'azienda non può risolverlo: deve farlo la piattaforma.
Cosa serve a un partner per ogni permesso prima che i suoi clienti possano concederlo tramite Embedded Signup.
L'errore che le chiamate API restituiscono quando whatsapp_business_management viene usato senza Advanced access su account che l'app non possiede.
whatsapp_business_management e whatsapp_business_messaging, i due permessi che secondo Meta servono in genere alle integrazioni WhatsApp.
Meta richiede che la piattaforma sia già Solution Partner o Tech Provider per fare l'onboarding degli utenti dell'app WhatsApp Business.
Cosa significa il messaggio?
Il testo 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." I riferimenti pubblici di Meta sugli errori non riportano questa formulazione esatta, ma ogni sua parte corrisponde a qualcosa che Meta documenta.
"Your app" è l'app Meta della piattaforma che gestisce la registrazione, non l'app WhatsApp Business sul telefono. Meta non definisce pubblicamente il companion pairing; letto nel contesto, descrive Cloud API che si collega a un numero che resta registrato nell'app WhatsApp Business, ed è proprio la configurazione di Coexistence. Infine, i permessi WhatsApp Business "advanced" indicano l'Advanced access, il livello che Meta concede tramite App Review.
Quali permessi sono coinvolti?
La documentazione di Meta sui permessi ne indica due che le integrazioni WhatsApp richiedono in genere. whatsapp_business_management copre i metadati dell'account, i template, i numeri di telefono, le analisi e i webhook dell'account. whatsapp_business_messaging copre l'invio dei messaggi e la ricezione dei webhook di messaggi e stato.
Per un partner i cui clienti usano la sua app, Meta richiede App Review e Advanced access per ogni permesso di cui l'app ha bisogno. Meta ne dichiara la conseguenza in modo diretto: senza Advanced access per un permesso, i clienti non possono concederlo all'app tramite Embedded Signup. Le chiamate fatte con whatsapp_business_management su account che l'app non possiede, senza Advanced access, restituiscono l'errore 200.
Una piattaforma può verificare cosa ha concesso davvero l'azienda ispezionando il token con l'endpoint debug_token di Meta, che elenca i permessi concessi sotto scopes.
Cosa può fare l'azienda?
Molto poco da parte sua, e non dovrebbe provare a cambiare le proprie impostazioni Meta per risolvere il problema. La soluzione sta nella piattaforma: deve essere un Tech Provider o un Solution Partner, requisito che Meta indica per l'onboarding degli utenti dell'app WhatsApp Business, e deve avere l'Advanced access approvato per i permessi WhatsApp.
L'azienda può segnalare alla piattaforma il testo esatto del messaggio, poi riprovare quando la piattaforma conferma il proprio accesso, oppure scegliere una piattaforma che ha già quello status. Riprovare lo stesso flusso sulla stessa piattaforma prima di allora dà lo stesso risultato e non ha effetto sull'app WhatsApp Business sul telefono.
Errori comuni
- Concedere più permessi nelle impostazioni Meta dell'azienda. L'accesso mancante appartiene all'app della piattaforma.
- Ospitare in autonomia uno strumento su un'app sviluppatore senza App Review. Senza Advanced access, le aziende non possono concedere i permessi necessari.
- Riprovare di continuo sulla stessa piattaforma. Il risultato cambia solo quando cambia l'accesso di quella piattaforma.
EasyCoexistence è un Meta Tech Provider indipendente con una propria app Meta e usa Embedded Signup v4 per Coexistence, così le aziende collegano il numero tramite una piattaforma che ha già l'accesso richiesto da Meta.
Domande frequenti
C'è qualcosa che non va nella mia app WhatsApp Business?
No. Il messaggio si riferisce all'app Meta della piattaforma, non all'app sul tuo telefono, che continua a funzionare.
Posso concedere io il permesso?
Puoi concedere solo i permessi per cui la piattaforma ha l'Advanced access. L'accesso mancante deve prima essere approvato per la piattaforma.
Come ottiene l'Advanced access una piattaforma?
Tramite la Meta App Review, per ogni permesso di cui la sua app ha bisogno, come partner i cui clienti usano l'app.
All'azienda serve l'App Review?
No. Meta dice che uno sviluppatore diretto che accede solo ai dati della propria azienda non ha bisogno né di App Review né di Advanced access.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il