Genuka WA docs

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?

SituazioneCosa vediChi 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_messagingLo stesso messaggio, su qualsiasi endpointIl proprietario del token
Funzionalità riservata agli account idoneiCodice 10 sull'endpoint di quella funzionalitàDipende dai requisiti di Meta per quell'API
WhatsApp Flows con un endpoint, numero non nella lista consentitaCodice 10 durante l'impostazione della chiave pubblicaIl proprietario dell'app
Invio da un numero spostato su un altro account WhatsApp Business"Viewer cannot access the provided Paid Message Account …" a ogni invioIl 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 AUTHENTICATION fallisce con "Application does not have permission for this action" quando l'azienda non ha superato la verifica dell'azienda di Meta;
  • i modelli MARKETING e UTILITY sullo 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 1559700625642290

Il 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.

CanaleCosa ricevi
POST /api/v1/templates403, "error": "meta_rejected", meta.code: 10
POST /api/v1/messages409, "error": "send_config", meta.code: 10; "reason": "waba_moved" quando il numero ha cambiato account
GET /api/v1/numbers/{id}/healthgenukaStatus: "disconnected", setupIssue: "waba_moved", currentWabaId: l'account in cui si trova il numero
Campagna MARKETINGSe 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
403 — POST /api/v1/templates (categoria AUTHENTICATION)
{
  "error": "meta_rejected",
  "message": "Application does not have permission for this action",
  "meta": {
    "errorClass": "config",
    "retryable": false,
    "code": 10,
    "traceId": "AbC…"
  }
}
409 — POST /api/v1/messages (numero spostato su un altro account)
{
  "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_management e whatsapp_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-id e il meta.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

In questa pagina