Errore 3 di WhatsApp: problema di capacità o permessi
Il codice di errore 3 indica che all'app che chiama l'endpoint manca una capacità o un permesso richiesto da quell'endpoint. La descrizione di Meta è "Capability or permissions issue." La Graph API lo chiama API Method. La soluzione è ispezionare i permessi concessi al token con l'access token debugger e aggiungere quello che serve all'endpoint.
Il codice di Meta per "Capability or permissions issue."
Il nome che la guida alla gestione degli errori della Graph API dà al codice 3.
whatsapp_business_management e whatsapp_business_messaging, i due permessi che servono alla maggior parte degli endpoint WhatsApp.
Cosa significa il codice di errore 3 di WhatsApp?
Significa che la richiesta è stata autenticata, ma l'app non ha il permesso di fare ciò che ha chiesto.
Meta elenca il codice 3 tra gli errori di autorizzazione nel riferimento della Cloud API, con il testo di dettaglio "Capability or permissions issue." La guida alla gestione degli errori della Graph API, che la Cloud API eredita, chiama lo stesso codice API Method e dice di verificare che l'app abbia la capacità o i permessi necessari per la chiamata.
Quindi il token funziona. Il problema non è l'identità, ed è questo che distingue il caso dai codici 0 e 190. Il problema è a cosa il token può accedere.
Come si controllano i permessi di un token?
Con l'access token debugger, oppure con l'endpoint debug_token, che restituisce le stesse informazioni.
La risposta elenca i permessi concessi nella proprietà scopes. Confronta quell'elenco con la pagina di riferimento dell'endpoint che ha fallito, perché ogni riferimento indica i permessi che richiede.
Per WhatsApp bastano due permessi per quasi tutto. whatsapp_business_management serve per i metadati dell'account, i template, l'elenco dei numeri di telefono, le statistiche e i webhook dell'account. whatsapp_business_messaging serve per inviare qualsiasi messaggio e per ricevere i webhook dei messaggi e degli stati. Un token che ha solo uno dei due fallisce nelle chiamate che richiedono l'altro.
Perché un'app partner vede l'errore 3 mentre uno sviluppatore diretto no?
Perché i partner che servono altre aziende hanno un controllo in più.
La guida ai permessi di Meta dice che un partner i cui clienti usano la sua app per accedere ai propri dati deve superare l'App Review e ottenere l'accesso Advanced per ogni permesso di cui l'app ha bisogno. Uno sviluppatore diretto che lavora solo con i dati della propria azienda non ha bisogno di App Review né dell'accesso Advanced.
Lo stesso codice può quindi funzionare senza problemi sull'account dello sviluppatore e fallire su quello di un cliente. Quando succede, la domanda non è quale permesso manchi al token, ma se l'app sia stata approvata per usare quel permesso su risorse che non le appartengono.
Errori comuni
- Generare un nuovo token con gli stessi scope. Un token nuovo con gli stessi permessi fallisce nello stesso punto.
- Controllare il nome del permesso nelle impostazioni dell'app invece che sul token. Conta ciò che è stato concesso al token.
- Testare solo sul tuo account. Le app partner hanno bisogno dell'accesso Advanced prima che gli account dei clienti accettino la chiamata.
EasyCoexistence collega ogni numero attraverso il flusso Embedded Signup di Meta, così l'azienda concede i permessi durante l'onboarding e lo stato della connessione resta visibile dalla dashboard in seguito.
Domande frequenti
L'errore 3 dipende dal mio numero di telefono?
No. Riguarda ciò che il token dell'app può fare. Il numero non viene controllato prima che la richiesta venga rifiutata.
Qual è la differenza tra l'errore 3 e l'errore 10?
Il codice 3 è un problema di capacità o permessi. Il codice 10 indica che un permesso non è stato concesso o è stato revocato. Entrambi si risolvono controllando gli scope del token.
Quale permesso serve per inviare messaggi?
whatsapp_business_messaging. La guida ai permessi di Meta dice che è richiesto per inviare qualsiasi tipo di messaggio.
Riprovare serve a qualcosa?
No. I permessi del token non cambiano da un tentativo all'altro, quindi il risultato è lo stesso.
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