Errore WhatsApp 10: autorizzazione negata — causa e soluzione
Errore WhatsApp 10: un'autorizzazione mancante, un modello OTP su un'azienda non verificata, oppure "Paid Message Account" quando il numero è passato a un altro account WhatsApp Business.
L'errore WhatsApp 10 significa che un'autorizzazione necessaria alla chiamata non è mai stata
concessa o è stata rimossa. Sulla Cloud API, il caso più frequente inganna tutti: creare un modello
AUTHENTICATION (OTP) per un'azienda che Meta non ha verificato restituisce "Application does not
have permission for this action". Il problema è l'azienda, non l'applicazione. Su un invio, il codice
10 ha un altro volto: "Viewer cannot access the provided Paid Message Account" significa che il
numero è stato spostato su un altro account WhatsApp Business e va ricollegato.
Cosa significa l'errore 10?
Meta lo elenca tra gli errori di autorizzazione:
"Permission is either not granted or has been removed." — Meta, Cloud API error codes
La soluzione suggerita da Meta copre tre piste: verificare nel debugger dei token di accesso che all'app siano state concesse le autorizzazioni richieste dall'endpoint; per i WhatsApp Flows con un endpoint, verificare che il numero di telefono usato per impostare la chiave pubblica dell'azienda sia nella lista consentita; e verificare i requisiti di idoneità dell'API che stai chiamando, perché un account non idoneo riceve proprio questo codice. La documentazione generale della Graph API chiama il codice 10 "API Permission Denied" (Meta, Graph API error handling).
Quando si verifica l'errore 10?
| Situazione | Cosa vedi | Chi può risolverlo |
|---|---|---|
Creazione di un modello AUTHENTICATION per un'azienda non verificata | "Application does not have permission for this action" | L'azienda: verifica dell'azienda presso Meta, poi un limite di messaggistica portato a 2.000 |
Token senza whatsapp_business_management o whatsapp_business_messaging | Lo stesso messaggio, su qualsiasi endpoint | Il proprietario del token |
| Funzionalità riservata agli account idonei | Codice 10 sull'endpoint di quella funzionalità | Dipende dai requisiti di Meta per quell'API |
| WhatsApp Flows con un endpoint, numero non nella lista consentita | Codice 10 durante l'impostazione della chiave pubblica | Il proprietario dell'app |
| Invio da un numero spostato su un altro account WhatsApp Business | "Viewer cannot access the provided Paid Message Account …" a ogni invio | Il proprietario del numero: ricollegarlo |
Il caso del modello OTP
È quello che fa perdere ore. Sugli account collegati a Genuka WA, vediamo che:
- la creazione di un modello
AUTHENTICATIONfallisce con "Application does not have permission for this action" quando l'azienda non ha superato la verifica dell'azienda di Meta; - i modelli
MARKETINGeUTILITYsullo stesso account vengono creati normalmente; - lo stato di salute dell'account riporta l'errore 141010, "The Business has not passed business verification".
Uno sviluppatore ha segnalato la stessa risposta sul forum di Meta, con error_subcode: 2388185 e il
messaggio utente "This WhatsApp Business account does not have permission to create message
template"
(forum degli sviluppatori Meta).
Il messaggio dà la colpa all'applicazione. Nessuna impostazione di token o di autorizzazioni cambia
qualcosa.
Non puoi aggirarlo nemmeno con un modello di utilità: quando un'app offre agli utenti password monouso o codici di verifica su WhatsApp, Meta richiede un modello di autenticazione (Meta, Authentication templates).
Il numero che ha cambiato account
Meta consente di spostare un numero di telefono da un account WhatsApp Business (WABA) a un altro, per esempio quando il commerciante riorganizza il suo portfolio Meta. Nessun webhook lo comunica all'applicazione che inviava per suo conto. Meta fattura ogni messaggio alla WABA del numero: l'invio indica il vecchio account, che non è più condiviso con Genuka WA, e ogni messaggio torna indietro con:
(#10) Viewer cannot access the provided Paid Message Account 1559700625642290Il numero è l'id della vecchia WABA. Il token, le autorizzazioni e il modello non sono il problema, e riprovare non cambia nulla.
Genuka WA lo intercetta in due modi. Al primo invio rifiutato, leggiamo
GET /{PHONE_NUMBER_ID}?fields=health_status: l'entità WABA nella risposta è l'account in cui il
numero si trova oggi (Meta, Health status).
GET /api/v1/numbers/{id}/health esegue la stessa lettura su richiesta. Se quell'account non è
quello che conosciamo, il numero passa a disconnected con setupIssue: "waba_moved", e la
dashboard lo mostra come "Ricollegamento necessario".
Dove lo vedi in Genuka WA?
Genuka WA colloca il codice 10 nella classe config: token, autorizzazione o registrazione, niente
che un nuovo tentativo possa risolvere.
| Canale | Cosa ricevi |
|---|---|
POST /api/v1/templates | 403, "error": "meta_rejected", meta.code: 10 |
POST /api/v1/messages | 409, "error": "send_config", meta.code: 10; "reason": "waba_moved" quando il numero ha cambiato account |
GET /api/v1/numbers/{id}/health | genukaStatus: "disconnected", setupIssue: "waba_moved", currentWabaId: l'account in cui si trova il numero |
Campagna MARKETING | Se la Marketing Messages API rifiuta con questo codice, Genuka invia di nuovo il messaggio tramite l'endpoint /messages standard; se rifiuta anche quello, il destinatario passa a failed |
{
"error": "meta_rejected",
"message": "Application does not have permission for this action",
"meta": {
"errorClass": "config",
"retryable": false,
"code": 10,
"traceId": "AbC…"
}
}{
"error": "send_config",
"message": "This number changed WhatsApp Business account. It now belongs to WhatsApp Business account 2222464398692076, not 1559700625642290, and the new account is not shared with Genuka WA. Reconnect the number (Embedded Signup) to share its new account, then send again. Meta's wording: \"(#10) Viewer cannot access the provided Paid Message Account 1559700625642290\".",
"meta": {
"errorClass": "config",
"retryable": false,
"code": 10,
"traceId": "AbC…"
},
"reason": "waba_moved",
"wabaId": "1559700625642290",
"currentWabaId": "2222464398692076",
"docUrl": "https://wa.genuka.com/en/docs/errors/10"
}Come risolvo l'errore 10?
Su un numero che ha cambiato account
Conferma lo spostamento. GET /api/v1/numbers/{id}/health restituisce
setupIssue: "waba_moved" e currentWabaId. Il messaggio di errore dell'invio riporta entrambi gli
id.
Ricollega il numero. Esegui di nuovo l'Embedded Signup con questo numero e scegli il suo nuovo account WhatsApp Business: da Numeri > Aggiungi un numero se il numero è tuo, oppure inviando il tuo link di connessione al cliente. In questo modo il nuovo account viene condiviso con Genuka WA e il numero viene aggiornato. Non si perde nulla: messaggi, statistiche e impostazioni restano associati al numero.
Controlla i modelli. Un modello appartiene a una WABA. I modelli del vecchio account non seguono il numero: sincronizza i modelli e ricrea quelli mancanti nel nuovo account.
Su un modello di autenticazione
Conferma la causa. In Meta Business Suite, Centro per la sicurezza > Verifica dell'azienda mostra lo
stato di verifica del portfolio che possiede l'account WhatsApp. Se chiami tu stesso la Graph API,
GET /{WABA_ID}?fields=business_verification_status,health_status risponde in una sola richiesta:
business_verification_status è descritto nel
riferimento del WhatsApp Business Account,
health_status in Health status.
Fai verificare l'azienda. Si parte da Meta Business Suite, sul portfolio che possiede l'account WhatsApp (Meta, Verify your business). I dettagli sono nella pagina dell'errore 141010.
Ricrea il modello una volta che l'azienda è verificata e il limite è passato a 2.000
(WhatsApp Manager, Account tools > Messaging limits). Lo stesso POST /api/v1/templates, con
"category": "AUTHENTICATION" — vedi la guida
codici OTP da Node.js.
Su un'autorizzazione mancante
- Se il token è tuo: aprilo nel
debugger dei token di accesso,
controlla
whatsapp_business_managementewhatsapp_business_messaging, e rigeneralo con entrambe se ne manca una (Meta, WhatsApp support). - Se passi da Genuka WA: non hai nessun token Meta da correggere. Un codice 10 al di fuori di un
modello di autenticazione e al di fuori di "Paid Message Account" è compito di Genuka: contatta il
supporto con l'header
x-request-ide ilmeta.traceId.
Come prevengo l'errore 10?
- Fai verificare l'azienda prima di pianificare gli OTP su WhatsApp. È un prerequisito di Meta, non un'opzione di Genuka.
- Testa il flusso di autenticazione su un account verificato prima di annunciare la funzionalità: un account di test non verificato fallirà sempre.
- Mantieni entrambe le autorizzazioni WhatsApp su ogni token che generi tu stesso.
Codici di errore correlati
- 141010: l'azienda non ha superato la verifica dell'azienda di Meta.
- 200: il token non ha accesso all'account, oppure manca un'autorizzazione (da 200 a 299).
- 3: capacità o autorizzazione mancante per questo endpoint.
- 190: il token è scaduto.
FAQ
Perché Meta dà la colpa all'applicazione quando il mio token va bene?
Perché il messaggio è generico. Su un modello AUTHENTICATION lo vediamo quando l'azienda non è
verificata, mentre il token e le sue autorizzazioni sono corretti: i modelli di marketing e di
utilità sullo stesso account passano.
Nel frattempo posso inviare codici OTP con un modello di utilità?
No. Meta richiede un modello di autenticazione per i codici monouso. Finché la verifica non è completata, invia i tuoi codici tramite un altro canale, SMS o email.
Devo rigenerare la mia chiave API Genuka?
No. La tua chiave Genuka non ha alcun ruolo nelle autorizzazioni di Meta. Un problema di chiave
produce un 401 di Genuka, mai un codice 10.
Il codice 10 blocca anche i miei invii?
Non nel caso del modello OTP: viene rifiutata solo la creazione di modelli AUTHENTICATION. I tuoi
modelli di marketing e di utilità approvati continuano a partire. "Paid Message Account", invece,
blocca ogni invio dal numero finché non viene ricollegato.
Perché il mio numero è passato a "disconnected" se non ho fatto nulla?
Perché il numero ha lasciato l'account WhatsApp Business con cui era collegato. Meta non avvisa
nessuno dello spostamento: lo vediamo al primo invio rifiutato o alla lettura della salute del
numero. Ricollegare il numero lo riporta a connected.
Fonti
- Meta — Error codes
- Meta — Graph API, Handling errors
- Meta — Authentication templates
- Meta — Health status
- Meta — WhatsApp Business Account API
- Meta — Messaging limits
- Meta — WhatsApp support, errori di autenticazione e autorizzazione
- Meta — Verify your business in Meta Business Suite
- Forum degli sviluppatori Meta — errore 10 su un modello di autenticazione
Errore WhatsApp 3: capacità o autorizzazione mancante
Errore 3 della WhatsApp Cloud API (Capability or permissions issue): in cosa si distingue dagli errori 0, 10, 190 e 200, e come risolverlo.
Errore WhatsApp 190: token di accesso scaduto — causa e soluzione
Errore 190 della WhatsApp Cloud API (token di accesso scaduto): quale token è scaduto, come sostituirlo una volta per tutte, e perché chi usa Genuka WA non gestisce mai token Meta.