# Errore WhatsApp 0: impossibile autenticare — soluzione

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

> Errore WhatsApp 0 "We were unable to authenticate the app user": token scaduto o invalidato, oppure accesso revocato. Come risolverlo, e il caso di Genuka WA.

L'errore WhatsApp 0 significa che Meta non è riuscita ad autenticare l'utente dietro il token di
accesso. In pratica il token è scaduto, è stato invalidato, oppure il suo proprietario ha impedito
alle app di accedere ai suoi dati. Si risolve come l'errore 190: con un nuovo token, idealmente un
token di utente di sistema che non dipende da nessuna persona.

## Cosa significa l'errore 0?

È la prima riga degli errori di autorizzazione della Cloud API:

> "We were unable to authenticate the app user."
> — [Meta, Cloud API error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#authorization-errors)

Meta spiega: "Typically this means the included access token has expired, been invalidated, or the
app user has changed a setting to prevent all apps from accessing their data." La soluzione
suggerita è ottenere un nuovo token di accesso, indicando i token di utente di sistema. La
documentazione generale della Graph API descrive lo stesso sintomo per gli errori `OAuthException`
senza sottocodice: lo stato di accesso o il token è scaduto, è stato revocato o non è comunque
valido
([Meta, Graph API error handling](https://developers.facebook.com/docs/graph-api/guides/error-handling)).

### Errore 0 o errore 190?

|                      | Errore 0                                         | Errore 190                       |
| -------------------- | ------------------------------------------------ | -------------------------------- |
| Formulazione di Meta | "We were unable to authenticate the app user."   | "Your access token has expired." |
| Cosa non va          | L'utente dietro il token, oppure il token stesso | Il token, scaduto o invalidato   |
| Rimedio di Meta      | Un nuovo token di accesso                        | Un nuovo token di accesso        |

In entrambi i casi, la stessa richiesta con lo stesso token fallirà sempre.

## Quando si verifica l'errore 0?

* **Il token è scaduto o è stato invalidato**, per esempio un token utente generato dalla pagina
  API Setup della App Dashboard, che Meta fa scadere nel giro di qualche ora
  ([Meta, Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#user-access-tokens)).
* **Il token dipende da una persona che ha cambiato le sue impostazioni.** Un token utente è legato
  all'account Facebook di chi l'ha generato: se quella persona revoca alle app l'accesso ai suoi
  dati, il token smette di funzionare.
* **Il token è stato revocato** dal lato di Meta.

### Dove lo vedi in Genuka WA?

Genuka WA colloca l'errore 0 nella classe `config` e lo tratta come una credenziale morta: in una
campagna `MARKETING` non fa scattare il ripiego dalla Marketing Messages API a `/messages`, che non
farebbe altro che raddoppiare il fallimento e nascondere la vera causa.

```json title="409 — POST /api/v1/messages"
{
  "error": "send_config",
  "message": "We were unable to authenticate the app user.",
  "meta": {
    "errorClass": "config",
    "retryable": false,
    "code": 0,
    "traceId": "AbC…"
  }
}
```

Su `POST /api/v1/templates`, lo stesso errore torna come `403 meta_rejected`.

## Come risolvo l'errore 0?

### Se passi da Genuka WA

Non hai nessun token Meta da rinnovare: ogni chiamata sul tuo numero parte con il token di utente di
sistema di Genuka, che non dipende da nessuna persona e non ha data di scadenza. Un errore 0 è
quindi compito di Genuka.

1. **Smetti di riprovare.** `retryable: false`: non cambia nulla finché non cambia il token.
2. **Contatta il supporto Genuka** con l'header `x-request-id` e il `meta.traceId`.
3. **Controlla il numero** con `GET /api/v1/connections`. `disconnected` 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 lo ripristina tramite il
   [link di connessione](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 in questo modo. L'evento `account_update` inoltrato ai tuoi webhook ti dice di quale
   caso si tratta.

### Se chiami la Cloud API con il tuo token

1. **Passa il token nel debugger.** Il
   [debugger dei token di accesso](https://developers.facebook.com/tools/debug/accesstoken/) mostra se
   è ancora valido, a chi appartiene e quali autorizzazioni porta.
2. **Sostituiscilo con un token di utente di sistema.** Meta li descrive come token di lunga durata,
   capaci di rappresentare un servizio automatizzato senza intervento di un utente, a differenza dei
   token utente
   ([Meta, Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens)).
   Generalo con `business_management`, `whatsapp_business_management` e
   `whatsapp_business_messaging`.
3. **Assegnagli gli account.** Senza accesso all'account WhatsApp e all'account di messaggistica, il
   nuovo token riceve un [errore 200](https://wa.genuka.com/it/docs/errors/200) invece dello 0.

## Come prevengo l'errore 0?

* **Nessun token personale in produzione.** Un dipendente che se ne va, una password cambiata o
  un'impostazione di privacy non devono poter fermare i tuoi invii.
* **Tieni d'occhio la classe `config`.** In Genuka WA, un aumento improvviso di risposte
  `meta.errorClass: "config"` su più numeri contemporaneamente indica un problema di credenziali,
  non di contenuto.
* **Conserva il `traceId`.** È quello che chiede il supporto Meta, e la documentazione della Graph
  API dice che l'ID scade a breve.

## Codici di errore correlati

* [190](https://wa.genuka.com/it/docs/errors/190): il token è scaduto.
* [200](https://wa.genuka.com/it/docs/errors/200): il token è valido ma non ha accesso all'account o l'autorizzazione.
* [10](https://wa.genuka.com/it/docs/errors/10): autorizzazione non concessa o rimossa.
* [3](https://wa.genuka.com/it/docs/errors/3): capacità o autorizzazione mancante per questo endpoint.

## FAQ

### Devo riprovare una chiamata rifiutata con l'errore 0?

No. Il problema è il token: la stessa richiesta fallirà in modo identico finché non viene
sostituito.

### La mia chiave API Genuka è compromessa?

No. L'errore 0 riguarda il token Meta, non la tua chiave `pk_live_…`. Una chiave rifiutata produce
un `401 invalid_token` di Genuka.

### Perché il mio token funzionava ieri?

Perché un token utente scade nel giro di qualche ora, oppure smette di funzionare non appena il suo
proprietario cambia le sue impostazioni. Un token di utente di sistema non ha questa debolezza.

## Fonti

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Access tokens](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens)
* [Meta — Graph API, Handling errors](https://developers.facebook.com/docs/graph-api/guides/error-handling)
