# Errore WhatsApp 200: accesso negato (200-299) — soluzione

URL: https://wa.genuka.com/it/docs/errors/200
Language: Italian

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#authorization-errors)):

| 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#business-asset-access)).
La Graph API chiama questo intervallo "API Permission"
([Meta, Graph API error handling](https://developers.facebook.com/docs/graph-api/guides/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_management`
  restituisce 200, per esempio
  ([Meta, Registration](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)).
* **La richiesta non ha alcun token**, tipicamente un `GET` sul 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/account_update)),
  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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)).
Genuka riceve il `PARTNER_REMOVED`, segna la connessione come `disconnected` e inoltra l'evento
`account_update` ai tuoi [webhook](https://wa.genuka.com/it/docs/webhooks). La stessa situazione può anche tornare come
codice 100 con sottocodice 33, "… cannot be loaded due to missing permissions", vedi
[errore 100](https://wa.genuka.com/it/docs/errors/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](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)).
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

1. **Controlla lo stato del numero.**

   ```bash title="GET /api/v1/connections"
   curl "https://wa.genuka.com/api/v1/connections?companyId=cmp_123" \
     -H "Authorization: Bearer $GENUKA_WA_API_KEY"
   ```

   ```json title="Risposta (estratto)"
   { "data": [ { "id": "con_1", "companyId": "cmp_123", "displayPhoneNumber": "+237 6 90 …",
                 "qualityRating": "GREEN", "status": "disconnected" } ] }
   ```

2. **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](https://wa.genuka.com/it/docs/onboarding)). Un numero rilasciato ha di nuovo bisogno di uno slot
   libero. Un account eliminato, o disattivato da Meta ([errore 368](https://wa.genuka.com/it/docs/errors/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](https://wa.genuka.com/it/docs/guides/coexistence).

3. **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

1. **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](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#business-asset-access)).
2. **Controlla le autorizzazioni del token** nel
   [debugger dei token di accesso](https://developers.facebook.com/tools/debug/accesstoken/):
   `whatsapp_business_management` e `whatsapp_business_messaging`, più `business_management` se
   gestisci le risorse del portfolio.
3. **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`.** Un `PARTNER_REMOVED` ti 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](https://wa.genuka.com/it/docs/errors/190): il token è scaduto o è stato invalidato.
* [10](https://wa.genuka.com/it/docs/errors/10): autorizzazione non concessa o rimossa, compresi i modelli OTP per
  un'azienda non verificata.
* [3](https://wa.genuka.com/it/docs/errors/3): capacità o autorizzazione mancante per questo endpoint.
* [0](https://wa.genuka.com/it/docs/errors/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

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Access tokens, business asset access](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#business-asset-access)
* [Meta — Register a business phone number](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration)
* [Meta — account\_update webhook](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/account_update)
* [Meta — Onboarding WhatsApp Business app users (coexistence)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)
* [Meta — Graph API, Handling errors](https://developers.facebook.com/docs/graph-api/guides/error-handling)
