Codici di errore WhatsApp Cloud API
Qui trovi tutti i codici di errore WhatsApp Cloud API che documentiamo, in una tabella con il significato di ciascuno e l'utilità di un nuovo tentativo. La maggior parte non serve: gli errori sono deterministici, quindi la stessa richiesta fallisce nello stesso modo e un ciclo di nuovi tentativi trasforma una richiesta errata in un limite di frequenza.
EasyCoexistence monitora continuamente la connessione e registra nella cronologia della connessione gli eventi di Meta sull'account e sulla qualità, così gli errori legati allo stato di un numero sono visibili prima dell'invio fallito, non dopo.
Richiesta
| Codice | Cosa significa | Riprovare |
|---|---|---|
| 100 | Un parametro non è supportato, è scritto male o è malformato. | No |
| 131008 | Un parametro obbligatorio non è stato incluso affatto. | No |
| 131009 | Un parametro è presente con un valore che l'endpoint rifiuta. | No |
| 131021 | Mittente e destinatario sono lo stesso numero. | No |
| 131051 | Il tipo di messaggio non è supportato, spesso per un limite di Coexistence. | No |
| 131052 | Meta non è riuscita a scaricare un contenuto multimediale inviato da un cliente. | No |
| 131053 | Meta non è riuscita a caricare un contenuto multimediale che hai inviato. Dimensione, formato o raggiungibilità. | No |
Template
| Codice | Cosa significa | Riprovare |
|---|---|---|
| 132000 | Il numero di parametri non corrisponde al template. | No |
| 132001 | Non esiste alcun template con quella coppia di nome e lingua. | No |
| 132007 | Il template viola le norme sulla messaggistica. Riscrivilo e invialo di nuovo. | No |
| 132012 | Il formato del parametro non corrisponde a quello definito dal template. | No |
| 132015 | Il template è in pausa dopo un calo di qualità. È temporaneo. | Attendi |
| 132016 | Il template è disattivato in modo permanente. Non tornerà. | No |
Finestra e destinatario
| Codice | Cosa significa | Riprovare |
|---|---|---|
| 131047 | La finestra di assistenza di 24 ore è chiusa. Invia un template. | No |
| 131026 | Il destinatario non può ricevere il messaggio in alcun modo. | No |
| 131050 | La persona ha scelto di non ricevere messaggi. Non c'è modo di aggirarlo, per scelta progettuale. | No |
| 130497 | L'invio di messaggi verso quel paese è limitato per il tuo account. | No |
Registrazione e PIN
| Codice | Cosa significa | Riprovare |
|---|---|---|
| 131045 | Il numero non è mai stato registrato per la messaggistica tramite Cloud API. | No |
| 133010 | Il numero non è registrato. La registrazione deve essere completata. | No |
| 133006 | Il numero deve essere verificato prima di poter essere registrato. | No |
| 133005 | Il PIN della verifica in due passaggi era sbagliato. Smetti di tirare a indovinare. | No |
| 133008 | Troppi tentativi di PIN. La registrazione è bloccata per un certo periodo. | Attendi |
Accesso e account
| Codice | Cosa significa | Riprovare |
|---|---|---|
| 190 | Il token di accesso è scaduto o è stato invalidato. | No |
| 368 | L'account è limitato dopo una violazione delle norme. | No |
| 131031 | L'account è limitato, oppure i suoi dati non corrispondono a quelli di Meta. | No |
| 131042 | Un problema di pagamento sull'account aziendale blocca l'invio. | No |
| 131049 | Meta ha bloccato il messaggio per proteggere la salute dell'ecosistema. | No |
Limiti di frequenza
| Codice | Cosa significa | Riprovare |
|---|---|---|
| 130429 | È stato raggiunto il limite di throughput dei messaggi dell'account. | Attendi |
| 131048 | È stato raggiunto un limite anti-spam. La causa è la qualità, non il volume. | No |
| 131056 | Troppi messaggi tra il tuo numero e un singolo destinatario. | No |
| 80007 | L'account ha raggiunto il limite di chiamate di gestione. Di solito per polling. | Attendi |
Temporanei
Sincronizzazione Coexistence
Come leggere la colonna dei nuovi tentativi
Contiene tre valori e scegliere quello sbagliato è l'errore più costoso di tutta questa guida.
No significa che il fallimento è deterministico. È la richiesta, il template o lo stato del destinatario ad aver causato il problema: inviare di nuovo la stessa richiesta produce lo stesso errore e consuma capacità che ti servirà in seguito. Sì significa che il problema era dalla parte di Meta e un backoff lo risolve davvero. Attendi significa che la condizione è reale ma temporanea: un limite o un blocco che si rimuove da solo. Ritentare prima che scompaia non serve e può prolungarlo.
Perché la maggior parte di questi codici non consente nuovi tentativi
Perché la piattaforma restituisce codici specifici invece di codici generici. Un parametro non valido, un template inesistente, una finestra di messaggistica chiusa e un destinatario che ha revocato il consenso sono tutti problemi riconoscibili al momento della risposta, quindi Meta li identifica invece di restituire un errore vago.
- Un problema nella richiesta non diventa corretto al secondo tentativo.
- Un problema del template è nel template, che la richiesta non può modificare.
- Un problema della finestra o del consenso riguarda lo stato del destinatario, non il tuo.
- Una limitazione dell'account è una decisione e ritentare non è un ricorso.
Cosa registrare quando arriva uno di questi codici
Quanto basta per diagnosticarlo senza riprodurlo: è la differenza tra una correzione di cinque minuti e una giornata passata a tirare a indovinare.
- La risposta completa dell'errore, incluso il trace id, richiesto dall'assistenza Meta.
- Il corpo della richiesta così come è stato inviato, non come lo avevi previsto. Di solito il problema è proprio la differenza tra i due.
- L'ID del numero di telefono, per distinguere un problema su un numero da uno che riguarda l'intero account.
- Il timestamp, per verificare il fallimento rispetto allo stato della connessione in quel momento.
I codici che esistono solo su Coexistence
Sono due e confondono perché sembrano normali errori di invio. 2593107 e 2593108 riguardano entrambi la sincronizzazione della cronologia chat, il passaggio che copia le conversazioni recenti dall'app WhatsApp Business quando un numero viene collegato per la prima volta.
Non sono errori di messaggistica e non indicano che la connessione sia fallita. Una sincronizzazione che supera il limite o avviene fuori dalla finestra prevista lascia il numero connesso e operativo, ma con meno cronologia copiata del previsto. Interpretarli come una connessione interrotta porta a scollegare il numero e ricominciare, perdendo altra cronologia invece di recuperarla.
Domande frequenti
Quali errori devo ritentare?
131016 e 131000, con backoff esponenziale. 130429, 132015 e 133008 si risolvono da soli aspettando. Tutto il resto è deterministico.
Un codice di errore significa che il mio numero è disconnesso?
Di solito no. La maggior parte riguarda la richiesta, il template o il destinatario. I problemi di connessione compaiono come webhook dell'account e della qualità, non come errori di invio.
Che cos'è un trace id?
È un identificativo nella risposta dell'errore che permette all'assistenza Meta di trovare la richiesta specifica. Registralo a ogni fallimento: senza di esso una segnalazione non può essere gestita.
Questi codici sono uguali per ogni provider?
Sì. Provengono dalla Cloud API di Meta, quindi sono identici qualunque provider abbia collegato il numero. Un provider può cambiare solo la chiarezza con cui ti vengono mostrati.
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaNessun addebito per 3 giorni. Annulla quando vuoi.