AccediInizia la prova gratuita
Meta Tech Provider

Messaggio WhatsApp API non consegnato: le cause, in ordine

Un messaggio WhatsApp API accettato non è un messaggio consegnato: Meta comunica l'esito dopo, in un webhook di stato, come sent, delivered, read o failed, con un codice di errore. Controlla in quest'ordine: lo stato failed e il suo codice, la finestra di 24 ore (131047), il metodo di pagamento (131042), il template (132001, 132015), il destinatario (131026, 131049, 131050), poi i limiti e la connessione del numero.

easyCoexistence controlla ogni numero collegato ventiquattro ore su ventiquattro, ti scrive via e-mail quando Meta smette di consegnare, rimuove il collegamento o abbassa la qualità, e inoltra i webhook di stato di Meta invariati al tuo sistema.

4 statuses

sent (un segno di spunta), delivered (due), read (due blu) e failed (un triangolo rosso con errore), così come li riportano i webhook di stato.

131047

Sono passate più di 24 ore dall'ultima risposta del destinatario; Meta consiglia di inviare un template.

131026

Impossibile consegnare: il numero non è su WhatsApp, il destinatario non ha accettato i nuovi termini o usa una versione vecchia di WhatsApp.

30 days

Tempo predefinito con cui WhatsApp riprova a consegnare un template utility o marketing non recapitato prima di scartarlo; i template di autenticazione hanno 10 minuti di default.

20 mps

Throughput fisso di un numero usato sia nell'app WhatsApp Business sia nella Cloud API.

Perché un messaggio accettato non arriva comunque?

Perché la risposta dell'API e la consegna sono due eventi separati. Quando invii, Meta restituisce un id del messaggio appena accetta la richiesta; se il messaggio arriva al telefono del cliente lo si scopre dopo, in un webhook di stato sul campo messages. sent significa che ha lasciato i server di Meta (un segno di spunta), delivered che ha raggiunto il dispositivo (due), read che è stato aperto (due blu) e failed che non è stato inviato o consegnato, mostrato con un array errors: code, title ed error_data.details. Quindi la prima mossa non è indovinare: cerca lo stato failed per quell'id e leggi il suo codice. Se non hai una destinazione webhook, nulla lo registra.

Quali sono le cause, nell'ordine in cui verificarle?

Dalla più comune su un numero appena collegato alla più rara. Ogni riga riporta il codice di Meta, così lo stato failed ti dice in quale caso sei:

  • Finestra chiusa: 131047, più di 24 ore dall'ultimo messaggio del cliente. I messaggi a testo libero richiedono una finestra aperta; invia un template.
  • Pagamento: 131042, oppure template scartati senza avviso. Dal 1 ottobre 2026 anche i messaggi di servizio si fermano dopo 1.000 al mese senza metodo di pagamento.
  • Template: 132001 non approvato o lingua errata, 132000 numero di variabili errato, 132012 formato errato, 132015 in pausa, 132016 disattivato.
  • Destinatario: 131026 non su WhatsApp, versione vecchia o termini non accettati; 131050 messaggi di marketing interrotti; 131049 trattenuto per mantenere un buon coinvolgimento; i template di marketing verso numeri statunitensi non vengono consegnati.
  • Limiti: 131048 limitato dopo segnali di spam, 131056 troppi messaggi a una persona, 130429 throughput, 20 messaggi al secondo su un numero Coexistence.
  • Account: 131031 o 368, il WhatsApp Business Account limitato o disattivato per violazione delle policy.
  • Connessione: il numero non è più collegato, per esempio dopo 14 giorni senza aprire l'app WhatsApp Business.

Come gestire i codici lato destinatario?

In modo diverso, perché alcuni meritano un nuovo tentativo e altri mai. 131050 significa che la persona ha scelto di non ricevere più messaggi di marketing da te: Meta dice di non riprovare, e il webhook user_preferences ti avvisa quando si fermano o riprendono. 131049 è Meta che trattiene un messaggio di marketing per mantenere un buon coinvolgimento, spesso un limite per utente sui template di marketing: Meta consiglia di attendere almeno 24 ore prima di rinviarlo, perché rinviare prima restituisce solo lo stesso errore. 131026 copre i numeri non presenti su WhatsApp, gli utenti che non hanno accettato i termini attuali di WhatsApp e versioni dell'app molto vecchie; controlla prima il formato del numero e il prefisso internazionale, poi chiedi al cliente tramite un altro canale.

Per quanto tempo WhatsApp continua a provare la consegna?

Per il time to live del messaggio. Quando un telefono è spento o fuori copertura, WhatsApp riprova la consegna invece di fallire subito: per impostazione predefinita per 30 giorni sui template utility e marketing e per 10 minuti sui template di autenticazione. Un'azienda può accorciarlo per template con message_send_ttl_seconds, da 30 secondi a 12 ore per gli utility e da 30 secondi a 15 minuti per l'autenticazione. Un messaggio che non può essere consegnato entro il suo TTL viene scartato. Quindi un messaggio con stato sent e senza stato delivered dopo ore di solito è in attesa sul telefono del cliente, non perso; imposta un TTL breve per codici e avvisi urgenti, così una consegna tardiva non confonde nessuno.

Cosa significa per risposte AI e automazioni?

Leggi prima l'esecuzione, poi lo stato. Nella scheda Runs, un'esecuzione Skipped non ha inviato nulla e spiega il motivo: "Più di 24 ore dall'ultimo messaggio del cliente", "Hai risposto di recente a questa chat dal telefono" oppure "Raggiunto il limite di risposte AI per questa chat in quest'ora". Un'esecuzione Done significa che Meta ha accettato ogni risposta, il che non è una prova di consegna. easyCoexistence non salva gli stati dei messaggi: con le automazioni attive arrivano al tuo URL di inoltro, se ne imposti uno, e in modalità diretta vanno direttamente al tuo endpoint. Da ChatGPT o Claude, chiedi alla tua AI di eseguire get_number_health: restituisce lo stato live, il rating di qualità e gli ultimi 15 eventi di monitoraggio, incluso un blocco sending con il codice di Meta.

Come configurarlo

  1. Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.

Errori comuni

  • Riprovare su un 131050. La persona ha smesso di ricevere messaggi di marketing da te; altri tentativi non vengono mai consegnati e possono solo aggiungere segnali negativi.
  • Considerare un id del messaggio come consegnato. Meta accetta per prima cosa e segnala i fallimenti dopo, quindi un flusso che si ferma all'id perde ogni messaggio rifiutato.
  • Inviare una risposta a testo libero un giorno dopo. Dopo 24 ore senza messaggi del cliente viene accettato solo un template.
  • Lavorare senza una destinazione webhook. Gli stati failed arrivano solo come webhook, quindi senza uno si perde il motivo per cui un messaggio non è arrivato.
Farlo con EasyCoexistence

La tua AI può verificare un numero da ChatGPT o Claude con get_number_health. Da US$ 9 scendendo a US$ 0,75 per numero collegato al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni di prova gratuita.

Domande frequenti

Perché il messaggio mostra un segno di spunta per ore?

Un segno di spunta è lo stato sent: Meta l'ha inviato, ma il telefono non l'ha ricevuto, di solito perché è spento o offline. WhatsApp continua a riprovare finché non scade il time to live del template, per impostazione predefinita 30 giorni per utility e marketing.

Perché le risposte arrivano ma i template no?

Di solito è un problema di metodo di pagamento sul WhatsApp Business Account. Meta consegna i messaggi di servizio entro la soglia gratuita mensile del numero anche senza, ma non consegna i template. Aggiungi una carta in Billing & payments.

Posso vedere i messaggi falliti nell'app WhatsApp Business?

Non in modo affidabile. Su un numero Coexistence, i messaggi inviati tramite API compaiono nella chat dell'app, ma il motivo del fallimento arriva solo nel codice di errore del webhook di stato.

Meta addebita i messaggi non consegnati?

No. Meta addebita solo i messaggi consegnati, e anche i tentativi con un template in pausa non vengono addebitati.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il