Genuka WA docs

Errore WhatsApp 0: impossibile autenticare — soluzione

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

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

Errore 0 o errore 190?

Errore 0Errore 190
Formulazione di Meta"We were unable to authenticate the app user.""Your access token has expired."
Cosa non vaL'utente dietro il token, oppure il token stessoIl token, scaduto o invalidato
Rimedio di MetaUn nuovo token di accessoUn 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).
  • 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.

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; un numero rilasciato ha di nuovo bisogno di uno slot libero; un account eliminato, o disattivato da Meta (errore 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

Passa il token nel debugger. Il debugger dei token di accesso mostra se è ancora valido, a chi appartiene e quali autorizzazioni porta.

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). Generalo con business_management, whatsapp_business_management e whatsapp_business_messaging.

Assegnagli gli account. Senza accesso all'account WhatsApp e all'account di messaggistica, il nuovo token riceve un errore 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: il token è scaduto.
  • 200: il token è valido ma non ha accesso all'account o l'autorizzazione.
  • 10: autorizzazione non concessa o rimossa.
  • 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

In questa pagina