AccediInizia la prova gratuita
Meta Tech Provider

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.

Messaggi non salvati di defaultApp Business + Cloud APIMCP per Claude e ChatGPTOperativo in 2 minuti

Richiesta

CodiceCosa significaRiprovare
100Un parametro non è supportato, è scritto male o è malformato.No
131008Un parametro obbligatorio non è stato incluso affatto.No
131009Un parametro è presente con un valore che l'endpoint rifiuta.No
131021Mittente e destinatario sono lo stesso numero.No
131051Il tipo di messaggio non è supportato, spesso per un limite di Coexistence.No
131052Meta non è riuscita a scaricare un contenuto multimediale inviato da un cliente.No
131053Meta non è riuscita a caricare un contenuto multimediale che hai inviato. Dimensione, formato o raggiungibilità.No

Template

CodiceCosa significaRiprovare
132000Il numero di parametri non corrisponde al template.No
132001Non esiste alcun template con quella coppia di nome e lingua.No
132007Il template viola le norme sulla messaggistica. Riscrivilo e invialo di nuovo.No
132012Il formato del parametro non corrisponde a quello definito dal template.No
132015Il template è in pausa dopo un calo di qualità. È temporaneo.Attendi
132016Il template è disattivato in modo permanente. Non tornerà.No

Finestra e destinatario

CodiceCosa significaRiprovare
131047La finestra di assistenza di 24 ore è chiusa. Invia un template.No
131026Il destinatario non può ricevere il messaggio in alcun modo.No
131050La persona ha scelto di non ricevere messaggi. Non c'è modo di aggirarlo, per scelta progettuale.No
130497L'invio di messaggi verso quel paese è limitato per il tuo account.No

Registrazione e PIN

CodiceCosa significaRiprovare
131045Il numero non è mai stato registrato per la messaggistica tramite Cloud API.No
133010Il numero non è registrato. La registrazione deve essere completata.No
133006Il numero deve essere verificato prima di poter essere registrato.No
133005Il PIN della verifica in due passaggi era sbagliato. Smetti di tirare a indovinare.No
133008Troppi tentativi di PIN. La registrazione è bloccata per un certo periodo.Attendi

Accesso e account

CodiceCosa significaRiprovare
190Il token di accesso è scaduto o è stato invalidato.No
368L'account è limitato dopo una violazione delle norme.No
131031L'account è limitato, oppure i suoi dati non corrispondono a quelli di Meta.No
131042Un problema di pagamento sull'account aziendale blocca l'invio.No
131049Meta ha bloccato il messaggio per proteggere la salute dell'ecosistema.No

Limiti di frequenza

CodiceCosa significaRiprovare
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
131056Troppi messaggi tra il tuo numero e un singolo destinatario.No
80007L'account ha raggiunto il limite di chiamate di gestione. Di solito per polling.Attendi

Temporanei

CodiceCosa significaRiprovare
131016Un servizio Meta è temporaneamente non disponibile.Sì
131000Errore non classificato. Riprova una volta, poi apri una segnalazione con il trace id.Sì

Sincronizzazione Coexistence

CodiceCosa significaRiprovare
2593107È stato superato il limite di sincronizzazione della cronologia delle chat.No
2593108È stata tentata una sincronizzazione fuori dalla finestra di sincronizzazione di 24 ore.No

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.

Continua a leggere