Errore WhatsApp 200: accesso negato (200-299) — soluzione
Errore 200 della WhatsApp Cloud API: token mancante, autorizzazione revocata o un utente di sistema senza accesso all'account. Come diagnosticarlo e risolverlo.
L'errore WhatsApp 200, come tutto l'intervallo da 200 a 299, significa che alla chiamata mancano i diritti necessari: nessun token, un'autorizzazione mai concessa o rimossa in seguito, oppure un utente di sistema senza accesso all'account WhatsApp di destinazione. Non ha nulla a che vedere con lo stato HTTP 200. Si risolve ripristinando l'accesso, non riprovando.
Cosa significa l'errore 200?
Meta elenca due voci tra i suoi errori di autorizzazione (Meta, Cloud API error codes):
| Codice | details secondo Meta | Cosa raccomanda Meta |
|---|---|---|
200 | "No access token was provided." L'API risponde allora "Provide valid app ID", su alcuni endpoint GET come whatsapp_business_profile; altri endpoint restituiscono invece 190 o 104 | "Ensure your request includes a valid access token." Meta precisa che è distinto dal 190 |
Da 200 a 299 | "Permission is either not granted or has been removed." | Verificare nel debugger dei token di accesso che l'app abbia le autorizzazioni richieste dall'endpoint |
La guida ai token di Meta aggiunge il caso più frequente in produzione: la maggior parte degli endpoint verifica che l'utente dietro il token abbia accesso alla risorsa richiesta, e altrimenti rifiuta con il codice di errore 200, "not to be confused with HTTP status code 200" (Meta, Access tokens). La Graph API chiama questo intervallo "API Permission" (Meta, Graph API error handling).
Quando si verifica l'errore 200?
- L'utente di sistema non è assegnato all'account. Un utente di sistema "employee" ha bisogno di un accesso parziale o completo all'account WhatsApp e all'account di messaggistica: l'accesso a quest'ultimo da solo non basta (stessa pagina).
- Al token manca un'autorizzazione. Deregistrare un numero senza
whatsapp_business_managementrestituisce 200, per esempio (Meta, Registration). - La richiesta non ha alcun token, tipicamente un
GETsul profilo aziendale. - L'azienda ha smesso di condividere il suo account con il partner. Meta emette allora un
evento
PARTNER_REMOVED(Meta, account_update webhook), e l'utente di sistema del partner perde l'accesso all'account.
Dove lo vedi in Genuka WA?
Con Genuka WA, l'ultimo caso è frequente: il tuo cliente ha rimosso l'accesso di Genuka al suo
account WhatsApp, nel suo Business Manager oppure, per un numero in coesistenza, dall'app WhatsApp
Business (Meta, coexistence).
Genuka riceve il PARTNER_REMOVED, segna la connessione come disconnected e inoltra l'evento
account_update ai tuoi webhook. La stessa situazione può anche tornare come
codice 100 con sottocodice 33, "… cannot be loaded due to missing permissions", vedi
errore 100.
Genuka non colloca i codici da 200 a 299 in una classe dedicata: la classe segue lo stato HTTP
restituito da Meta, config su un 401 o un 403, unknown negli altri casi. In ogni caso, il rifiuto
non è ritentabile.
| Canale | Cosa ricevi |
|---|---|
POST /api/v1/messages | 409 send_config oppure 400 send_unknown, con meta.code: 200 |
POST /api/v1/templates | 403 oppure 422, "error": "meta_rejected" |
GET /api/v1/connections | "status": "disconnected" sul numero interessato |
Un numero in coesistenza può anche passare a offboarded: Meta ha segnalato che non è più collegato
all'API, per esempio dopo un cambio di dispositivo seguito da una nuova registrazione
(Meta, coexistence).
Genuka rifiuta allora gli invii da sé, prima di chiamare Meta: 409 send_config, con un messaggio
che nomina l'offboarding ("was offboarded by the merchant…") e nessun meta.code. Un numero che hai
rilasciato dal tuo piano viene rifiutato allo stesso modo, come 409 number_released.
Come risolvo l'errore 200?
Se passi da Genuka WA
Controlla lo stato del numero.
curl "https://wa.genuka.com/api/v1/connections?companyId=cmp_123" \
-H "Authorization: Bearer $GENUKA_WA_API_KEY"{ "data": [ { "id": "con_1", "companyId": "cmp_123", "displayPhoneNumber": "+237 6 90 …",
"qualityRating": "GREEN", "status": "disconnected" } ] }Se è disconnected, scopri perché prima di chiedere un ricollegamento. Lo stato significa che
Meta ha segnalato l'account come non più condiviso con Genuka, oppure eliminato, oppure che hai
rilasciato tu stesso il numero. Un cliente che ha rimosso l'accesso ripassa dallo stesso link
/connect/{your-slug}: l'accesso torna sullo stesso record, con messaggi, modelli e statistiche
conservati e nessun nuovo slot occupato nel tuo piano
(Collegare un numero). Un numero rilasciato ha di nuovo bisogno di uno slot
libero. Un account eliminato, o disattivato da Meta (errore 368), non si
ripristina ricollegandosi: l'evento account_update inoltrato ai tuoi webhook ti dice di quale caso
si tratta. Se è offboarded, segui la guida alla coesistenza.
Se risulta ancora connected, contatta il supporto Genuka con l'header x-request-id della
risposta e il meta.traceId. Lo stato riflette gli ultimi eventi ricevuti da Meta: non dimostra che
l'accesso sia intatto.
Se chiami la Cloud API con il tuo token
Assegna l'utente di sistema a entrambi gli account. In Meta Business Suite: impostazioni del portfolio, Accounts > WhatsApp accounts, scegli l'account, scheda Persone (in inglese, People), +Add people, poi l'utente di sistema e il suo livello di accesso. Ripeti in Accounts > Messaging accounts (Meta, Access tokens).
Controlla le autorizzazioni del token nel
debugger dei token di accesso:
whatsapp_business_management e whatsapp_business_messaging, più business_management se
gestisci le risorse del portfolio.
Non fare affidamento sulla cascata dell'API. Un accesso concesso tramite l'API sull'account di messaggistica vale anche per l'account WhatsApp collegato, ma Meta definisce questo comportamento provvisorio, e Meta Business Suite non lo fa. Assegna esplicitamente entrambi gli account (stessa pagina).
Come prevengo l'errore 200?
- Iscrivi un endpoint a
account_update. UnPARTNER_REMOVEDti avvisa nel momento in cui un cliente rimuove l'accesso, prima che i tuoi invii comincino a fallire. - Spiega ai tuoi clienti cosa comporta la rimozione. Rimuovere Genuka dal loro Business Manager interrompe l'API su tutti i numeri di quell'account WhatsApp.
- Se gestisci i tuoi token, Meta dice che un utente di sistema admin ha accesso per impostazione predefinita a ogni account WhatsApp posseduto da o condiviso con il tuo portfolio; un utente di sistema employee va assegnato account per account.
Codici di errore correlati
- 190: il token è scaduto o è stato invalidato.
- 10: autorizzazione non concessa o rimossa, compresi i modelli OTP per un'azienda non verificata.
- 3: capacità o autorizzazione mancante per questo endpoint.
- 0: Meta non è riuscita ad autenticare l'utente dell'app.
FAQ
L'errore 200 è legato allo stato HTTP 200?
Per niente. È un codice di errore di Meta, restituito nel campo code di una risposta fallita. Meta
lo sottolinea nella sua stessa documentazione.
Il mio cliente ha rimosso Genuka per sbaglio: cosa deve fare?
Ripassare dal tuo link di connessione. Il numero torna sullo stesso record, con la sua cronologia, e senza occupare uno slot in più.
Perché l'errore colpisce solo alcuni dei miei numeri?
Perché l'accesso viene concesso per account WhatsApp. I numeri di un cliente che ha rimosso l'accesso falliscono; quelli degli altri tuoi clienti continuano a funzionare.
Devo riprovare?
No. Finché l'accesso non viene ripristinato, ogni nuova chiamata produrrà lo stesso errore.
Fonti
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.
Errore WhatsApp 4: limite di frequenza dell'app raggiunto — soluzione
Errore WhatsApp 4 (API Too Many Calls): l'app ha raggiunto il suo limite di frequenza delle chiamate all'API di Meta. In cosa si distingue da 80007 e 130429, e come riprovare in sicurezza.