Errore WhatsApp 131005: accesso negato, permesso mancante
L'errore 131005 significa che il token di accesso non ha un permesso richiesto dall'endpoint di WhatsApp, perché non è mai stato concesso o è stato rimosso in seguito. La descrizione di Meta è "Permission is either not granted or has been removed." La soluzione è ispezionare il token con l'access token debugger, poi concedere il permesso mancante o passare a un token che lo include.
Il codice di Meta per "Permission is either not granted or has been removed."
Il permesso necessario per inviare qualsiasi tipo di messaggio agli utenti WhatsApp.
business_management, whatsapp_business_management e whatsapp_business_messaging, assegnati quando generi un token di utente di sistema.
Cosa significa l'errore WhatsApp 131005?
Significa che il token è riconosciuto come autentico, ma non ha il permesso che l'endpoint controlla.
La documentazione della Cloud API di Meta elenca 131005 con il testo di dettaglio "Permission is either not granted or has been removed." L'errore 10 della Graph API riporta la stessa identica frase. La differenza sta solo nell'intervallo: 10 è un codice generico della Graph API, mentre 131005 fa parte dei codici di WhatsApp che iniziano con 131.
Poiché le parole sono le stesse, la diagnosi è la stessa. Il rimedio di Meta per entrambi è usare l'access token debugger e verificare che l'app abbia i permessi richiesti dall'endpoint.
Quale permesso manca di solito?
Di solito uno dei due permessi di WhatsApp, e quale dipende da ciò che fa la chiamata.
La guida ai permessi di Meta li divide per funzione. whatsapp_business_messaging serve per inviare qualsiasi tipo di messaggio e per ricevere i webhook di messaggi e stati. whatsapp_business_management serve per i metadati dell'account, la gestione dei template, l'elenco dei numeri di telefono, le analisi e i webhook dell'account.
Un token generato solo con il permesso di gestione può leggere l'account ed elencare i template, ma fallisce non appena prova a inviare. Quando generi un token di utente di sistema, la guida ai token di accesso di Meta ti fa assegnare insieme business_management, whatsapp_business_management e whatsapp_business_messaging.
Come si risolve l'errore 131005?
Leggi prima il token, poi cambia solo ciò che manca.
Chiama l'endpoint debug_token, oppure incolla il token nell'access token debugger. La proprietà scopes elenca ogni permesso concesso. Confrontala con la pagina di riferimento dell'endpoint che ha fallito.
Se un permesso è assente, genera un nuovo token che lo includa, oppure chiedi al titolare dell'azienda di concederlo di nuovo se il token arriva da un flusso partner. Se tutti i permessi ci sono e l'errore persiste, controlla che l'utente di sistema dietro al token abbia accesso allo specifico WhatsApp Business Account, perché un token può avere tutti gli scope e non essere comunque assegnato a quella risorsa.
Errori comuni
- Pensare che il token sia scaduto. La scadenza restituisce 190 o 0. Questo codice indica che il token funziona ma manca un permesso.
- Generare un token con il solo permesso di gestione e usarlo per inviare. L'invio richiede whatsapp_business_messaging.
- Controllare gli scope e fermarsi lì. Un utente di sistema ha bisogno anche dell'accesso concesso a quello specifico WhatsApp Business Account.
EasyCoexistence collega ogni numero tramite l'Embedded Signup di Meta, dove l'azienda concede all'app i suoi permessi, e il suo connettore MCP segnala lo stato di salute di un numero, così un assistente può controllare prima di inviare.
Domande frequenti
131005 è lo stesso errore del 10?
Hanno la stessa descrizione nella documentazione di Meta. 131005 appartiene all'intervallo di WhatsApp e 10 a quello della Graph API.
Un permesso può essere rimosso dopo la configurazione?
Sì. La descrizione di Meta copre esplicitamente i permessi che sono stati rimossi, non solo quelli mai concessi.
L'errore 131005 riguarda l'app WhatsApp Business sul telefono?
No. Riguarda il token dell'API. L'app sul telefono continua a funzionare come prima.
Devo riprovare dopo l'errore 131005?
No. Riprovare con lo stesso token dà lo stesso risultato. Correggi prima il permesso.
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