Errore WhatsApp 10: permesso non concesso o rimosso
Il codice di errore 10 significa che il token dell'app non ha un permesso richiesto dall'endpoint, perché non è mai stato concesso o perché è stato rimosso. La descrizione di Meta è "Permission is either not granted or has been removed." Meta indica anche due cause legate a WhatsApp: un numero non in allowlist su Flows con Endpoint e il mancato rispetto dei requisiti di eleggibilità di un'API.
Il codice di Meta per "Permission is either not granted or has been removed."
Il nome che la guida alla gestione degli errori della Graph API dà al codice 10.
Ciò che serve a un'app partner per ogni permesso usato sugli account dei clienti.
Che cosa significa il codice di errore 10 di WhatsApp?
Significa che il token è arrivato a Meta ed è stato riconosciuto, ma il permesso richiesto dalla chiamata non è presente.
Il riferimento della Cloud API di Meta associa al codice 10 il testo di dettaglio "Permission is either not granted or has been removed." La guida alla gestione degli errori della Graph API lo chiama API Permission Denied e indica di gestire il permesso mancante.
La parola rimosso conta. Un permesso può essere concesso in fase di configurazione e revocato più tardi, per esempio quando qualcuno toglie l'accesso all'app dalle impostazioni dell'azienda in Meta. Così un'integrazione che funzionava da mesi può iniziare a restituire 10 senza alcuna modifica al proprio codice.
Quali altre cause elenca Meta per l'errore 10?
Due, specifiche di WhatsApp, e facili da perdere perché non riguardano affatto gli scope.
Per WhatsApp Flows con Endpoint, Meta dice di verificare che il numero di telefono usato per impostare la chiave pubblica dell'azienda sia in allowlist. Un numero fuori dall'allowlist produce questo codice anche quando il token ha tutti i permessi.
Meta precisa inoltre che un account che non soddisfa i requisiti di eleggibilità per l'API che sta chiamando riceve questo codice. In quel caso nessuna modifica al token aiuta, perché il blocco dipende dall'eleggibilità dell'account e non dalla credenziale.
Come si risolve l'errore 10?
Parti dal debugger dei token di accesso, che Meta indica come primo controllo.
Se nell'elenco degli scope manca il permesso richiesto dall'endpoint, fai concedere di nuovo il permesso all'azienda. Per un'app partner significa anche confermare l'accesso avanzato per quel permesso, perché la guida ai permessi di Meta lo richiede per gli account dei clienti.
Se gli scope sembrano completi, passa alle due cause legate a WhatsApp. Su una chiamata Flows, controlla l'allowlist per il numero che ha impostato la chiave pubblica. In tutti gli altri casi, leggi i requisiti di eleggibilità dell'API che stai chiamando e verifica che l'account li soddisfi prima di toccare qualsiasi credenziale.
Errori comuni
- Pensare che l'integrazione si sia rotta per un deploy. Un permesso rimosso dalle impostazioni dell'azienda produce questo codice senza nessuna modifica al codice.
- Rigenerare il token quando la causa è l'eleggibilità. Una credenziale non può rendere idoneo un account che non lo è.
- Ignorare l'allowlist di Flows. Su Flows con Endpoint, un numero fuori dall'allowlist restituisce 10 anche con tutti gli scope.
EasyCoexistence continua a monitorare ogni numero connesso dopo l'onboarding, così una connessione che perde l'accesso compare nella dashboard invece di emergere solo come invii falliti.
Domande frequenti
L'errore 10 è lo stesso del 131005?
Hanno la stessa descrizione nel riferimento di Meta. Il codice 10 è quello della Graph API, mentre 131005 rientra nell'intervallo di WhatsApp. Si controllano entrambi allo stesso modo.
L'errore 10 può comparire su un numero che ieri funzionava?
Sì. La descrizione di Meta include i permessi rimossi, quindi un accesso concesso in precedenza può essere ritirato in seguito.
L'errore 10 significa che il mio token è scaduto?
No. Un token scaduto dà il codice 190 oppure 0. Il codice 10 indica che il token è valido ma manca un permesso.
Come vedo quali permessi sono stati concessi?
Chiama debug_token oppure apri il debugger dei token di accesso. La proprietà scopes elenca tutti i permessi del token.
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