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 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).
- 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.
{
"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.
- Smetti di riprovare.
retryable: false: non cambia nulla finché non cambia il token. - Contatta il supporto Genuka con l'header
x-request-ide ilmeta.traceId. - Controlla il numero con
GET /api/v1/connections.disconnectedsignifica 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'eventoaccount_updateinoltrato 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 rispostemeta.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
Codici di errore della WhatsApp Cloud API: cause e soluzioni
I codici di errore della WhatsApp Cloud API spiegati: cosa significano 131047, 131026, 130429, 132001, 141010 e gli altri, e se conviene riprovare.
Errore WhatsApp 3: capacità o autorizzazione mancante
Errore 3 della WhatsApp Cloud API (Capability or permissions issue): in cosa si distingue dagli errori 0, 10, 190 e 200, e come risolverlo.