nvia su WhatsApp quando il destinatario ha fornito il consenso per ricevere comunicazioni su quel canale e dispone di un account WhatsApp attivo; in tutti gli altri casi, invia tramite SMS o attiva il fallback su SMS. Sul Cloud API di WhatsApp, un messaggio inviato a un numero che non può riceverlo fallisce con l'errore 131026, e l'informazione è disponibile solo tramite il webhook di stato, non dalla risposta di invio. Il modello affidabile consiste nel registrare il consenso al canale di ogni cliente al momento dell'opt-in, verificare ciò che è consentito per legge prima dell'invio e lasciare che uno stato di WhatsApp fallito attivi un SMS. BroadNet gestisce entrambi i canali tramite un unico Omnichannel API con regole di fallback esplicite.
Punti chiave
- L'errore 131026 significa che Meta non è riuscito a consegnare il messaggio. Meta elenca tre possibili motivi: il numero non è un numero WhatsApp, il destinatario non ha accettato i termini più recenti o il destinatario utilizza una vecchia versione di WhatsApp.
- Una risposta API con esito positivo indica solo che la richiesta è stata accettata. La consegna viene segnalata successivamente dal webhook di stato: inviato, consegnato, letto o fallito, con un array di errori in caso di fallimento.
- Avere un account WhatsApp non autorizza a inviare messaggi a qualcuno: la policy di Meta richiede il numero della persona e il suo consenso per ricevere comunicazioni.
- Al di fuori della finestra di 24 ore per il servizio clienti, WhatsApp accetta solo messaggi basati su template (altrimenti errore 131047).
- Il tipo di linea è il primo filtro: un SMS verso un numero fisso o un numero verde solitamente fallisce, ma comporta comunque il costo del messaggio.
- Il fallback funziona meglio come regola all'interno della piattaforma di invio: WhatsApp prioritario se scelto dal cliente, SMS in caso di stato fallito o mancanza di consenso WhatsApp.
Cosa significa l'errore 131026 di WhatsApp?
Nel riferimento agli errori della Cloud API di Meta, 131026 indica "Impossibile consegnare il messaggio". Meta fornisce tre possibili motivi: "Il numero di telefono del destinatario non è un numero WhatsApp", il destinatario "non ha accettato i nuovi Termini di Servizio e l'Informativa sulla Privacy", oppure il destinatario "sta utilizzando una vecchia versione di WhatsApp". La soluzione suggerita da Meta è quella di chiedere alla persona, "utilizzando un metodo di comunicazione non WhatsApp", di confermare di poter inviare messaggi al numero della tua azienda, accettare gli ultimi termini o aggiornare l'app.
In altre parole, 131026 è un segnale di instradamento, non un bug nel tuo codice. Per una password monouso, una notifica di consegna o un promemoria di un appuntamento, il metodo non WhatsApp a cui Meta fa riferimento è solitamente l'SMS, e dovrebbe essere inviato automaticamente anziché dopo l'apertura di un ticket di supporto.
Perché un ID messaggio non garantisce che il messaggio sia stato consegnato?
L'invio è asincrono. L'API accetta la richiesta e restituisce un ID messaggio; ciò che accade successivamente viene comunicato tramite il tuo webhook. Il webhook dello stato del messaggio di Meta riporta questi valori:
| Stato | Descrizione di Meta | Cosa fare |
|---|---|---|
| inviato | Il messaggio è stato inviato correttamente dai server di Meta | In attesa di consegna o errore |
| consegnato | Il messaggio è stato consegnato con successo al dispositivo dell'utente WhatsApp | Nessun fallback necessario |
| letto | Il messaggio è stato visualizzato in una chat aperta sul dispositivo dell'utente | Nessun fallback necessario |
| errore | Impossibile inviare o consegnare il messaggio al dispositivo dell'utente | Leggere errors[].code; utilizzare il fallback SMS per i messaggi urgenti |
Uno stato di errore include un array di errori con un codice numerico, un titolo, un campo dettagli e un link al riferimento dell'errore. Registra il codice insieme al messaggio: ti indicherà se riprovare, cambiare canale o correggere un template. La stessa logica si applica a SMS, dove la ricevuta di consegna (DLR) dell'operatore svolge il ruolo del webhook di stato.
È possibile inviare un messaggio a qualcuno su WhatsApp solo perché possiede un account?
No. La WhatsApp Business Messaging Policy stabilisce che "è possibile contattare le persone su WhatsApp solo se: (a) hanno fornito il proprio numero di cellulare o username; e (b) si è ricevuta l'autorizzazione di opt-in dal destinatario che conferma la volontà di ricevere messaggi o chiamate successive da parte tua". È inoltre necessario rispettare ogni richiesta di interruzione, sia su che fuori da WhatsApp.
Pertanto, la scelta del canale inizia con l'opt-in, non al momento dell'invio. Chiedi ai clienti quali canali accettano, memorizza la scelta con un timestamp e invia messaggi solo sui canali concordati. La legge locale aggiunge ulteriori regole: consulta la nostra guida al marketing SMS e WhatsApp per PDPL negli UAE per un esempio.
E per quanto riguarda la finestra di 24 ore e l'errore 131047?
Un messaggio WhatsApp a testo libero è consentito solo entro 24 ore dall'ultimo messaggio inviato dal cliente. Al di fuori di questo intervallo, la Cloud API restituisce 131047, "Sono trascorse più di 24 ore dall'ultima risposta del destinatario al numero del mittente", e la soluzione di Meta è "inviare al destinatario un messaggio tramite template". Scopri cos'è la finestra di 24 ore di WhatsApp.
Per la progettazione del fallback, ciò significa due tipi diversi di errore: 131047 si risolve passando a un template approvato su WhatsApp, mentre 131026 si risolve cambiando canale. Gestiscili in modo differente nella tua logica di retry.
Quale canale dovresti utilizzare per primo?
Non esiste una risposta univoca per ogni mercato; dipende dal messaggio e da ciò che ogni cliente ha accettato. Un set di regole per destinatario copre la maggior parte dei casi:
| Situazione | Primo canale | Fallback |
|---|---|---|
| Il cliente ha fornito il consenso per WhatsApp e ti ha già inviato un messaggio | WhatsApp (template oltre le 24 ore) | SMS in caso di consegna fallita |
| Il cliente ha fornito il consenso per WhatsApp, nessuna cronologia disponibile | Template WhatsApp | SMS in caso di consegna fallita o assenza di stato entro il limite di tempo |
| Nessun consenso WhatsApp registrato | SMS | Voce per OTP dove supportata |
| Il precedente messaggio WhatsApp è fallito con 131026 | SMS | Chiedere al cliente di confermare il proprio WhatsApp al prossimo contatto |
| Il numero è fisso o numerazione verde | Non SMS: solitamente fallisce | Chiamata vocale, o richiedere un numero di cellulare |
| Il cliente ha fornito il consenso per RCS, Telegram o Viber | Canale abilitato all'invio | SMS |
Per la visualizzazione per mercato (dove prevalgono WhatsApp, RCS o SMS), consulta la nostra guida ai canali SMS vs WhatsApp vs RCS.
Cosa è possibile verificare prima dell'invio?
Il primo controllo non riguarda affatto le app: si tratta del tipo di linea. Un SMS verso un numero fisso o un numero verde solitamente fallisce, comportando comunque il costo del messaggio. MobileValidate, un brand BroadNet in anteprima privata, restituisce il tipo di linea, l'operatore attuale e, per i numeri portati, l'operatore originale; il HLR Lookup di BroadNet aggiunge lo stato della rete in tempo reale, indicando se la linea è attualmente raggiungibile.
Per i clienti che hanno fornito il consenso ad altri canali, MobileValidate può anche verificare in tempo reale se il loro numero è registrato su Telegram, Viber o Zalo, oppure in modalità bulk su Signal, iMessage, RCS, LINE o Botim; il controllo RCS riporta la piattaforma del dispositivo quando disponibile. La sua policy di utilizzo accettabile limita questi controlli alla prevenzione delle frodi e alla selezione del canale per i contatti che hanno fornito il consenso. L'elenco completo dei controlli è disponibile su mobilevalidate.com. MobileValidate è un servizio indipendente, non affiliato, approvato o sponsorizzato dalle piattaforme che controlla; i loro nomi sono utilizzati esclusivamente per descrivere l'ambito del controllo.
Per WhatsApp stesso, i segnali affidabili sono quelli forniti da Meta: il consenso (opt-in) del cliente, le sue risposte e lo stato di consegna o fallimento dell'ultimo messaggio inviato. Memorizza l'ultimo esito del WhatsApp per ogni cliente e utilizzalo per orientare l'invio successivo.
Come gestisce BroadNet il fallback?
BroadNet è un Business Solution Provider ufficiale di Meta e gestisce WhatsApp Business API, SMS, RCS e la voce su un'unica piattaforma. L' Omnichannel API riceve una singola richiesta con regole di fallback esplicite su SMS, WhatsApp, RCS e voce, restituendo ricevute unificate; in questo modo, uno stato di fallimento WhatsApp diventa un SMS senza richiedere codice aggiuntivo nella tua applicazione.
- Per le password monouso, il API OTP effettua l'invio con fallback automatico su SMS, WhatsApp, voce e Flash Call; MyOTP.App copre SMS, WhatsApp e Telegram con un unico account.
- Imposta un limite temporale per i messaggi urgenti: se non si riceve né la conferma di consegna né quella di fallimento entro i tempi previsti, invia il fallback.
- Mantieni dei template approvati per ogni tipologia di messaggio necessaria al di fuori della finestra di 24 ore.
- Sospendi un canale per un cliente dopo un errore 131026 finché non conferma nuovamente, così da non pagare per i fallimenti ripetuti.
Per ulteriori modelli, leggi la nostra strategia di failover multicanale.
Come si presenta una checklist di instradamento per singolo destinatario?
- Al momento dell'opt-in, registra quali canali accetta il cliente, con la data e il testo su cui ha dato il consenso.
- Verifica il tipo di linea dei nuovi numeri e richiedi un numero mobile se si tratta di una linea fissa o di un numero verde.
- Seleziona il primo canale basandoti sul consenso e sulla cronologia del cliente, non solo su un valore predefinito per paese.
- Al di fuori della finestra di 24 ore, invia solo template WhatsApp.
- Monitora i webhook di stato e le ricevute di consegna; tratta i fallimenti e i timeout come trigger per il fallback.
- Passa a SMS per i messaggi con scadenza temporale e registra il codice errore WhatsApp insieme al messaggio.
- Controlla i fallimenti settimanalmente: un aumento di 131026 in un segmento indica solitamente numeri non più attivi o mancanza di consenso.
Domande frequenti
Cosa significa l'errore WhatsApp 131026?
"Impossibile consegnare il messaggio." Meta indica tre possibili motivi: il numero non è un numero WhatsApp, il destinatario non ha accettato i più recenti Termini di servizio e l'Informativa sulla privacy, oppure il destinatario utilizza una vecchia versione WhatsApp.
Dovrei riprovare l'invio di un messaggio che ha restituito l'errore 131026?
Non su WhatsApp immediatamente. Invia contenuti urgenti tramite SMS e chiedi al cliente, attraverso un altro canale, di confermare il proprio numero WhatsApp.
Una risposta 200 dall'API WhatsApp significa che il messaggio è stato consegnato?
No. Significa che la richiesta è stata accettata. La consegna viene segnalata dal webhook di stato come inviata, consegnata, letta o fallita.
Posso inviare un messaggio a un cliente su WhatsApp se so che possiede un account?
No. La policy di Meta richiede che la persona ti abbia fornito il proprio numero e abbia dato il consenso a ricevere messaggi dalla tua azienda su WhatsApp.
Cos'è l'errore 131047?
Sono trascorse più di 24 ore dall'ultima risposta del cliente. Invia un messaggio basato su un template approvato invece di un messaggio a testo libero.
Quale canale dovrebbe essere il fallback per WhatsApp?
SMS nella maggior parte dei casi, poiché raggiunge qualsiasi numero mobile. Per le password monouso, la voce è un ulteriore fallback laddove la piattaforma lo supporti.
Posso verificare un numero prima dell'invio?
Sì, nel rispetto della propria base giuridica. Verifica prima il tipo di linea; per i clienti che hanno fornito il consenso, MobileValidate può verificare la registrazione su app come Telegram, Viber e RCS, e BroadNet HLR Lookup fornisce lo stato della rete in tempo reale.
In che modo BroadNet invia il fallback SMS?
L'Omnichannel API applica le regole di fallback in un'unica richiesta, e l'OTP API effettua il fallback automaticamente tra SMS, WhatsApp, voce e Flash Call.
Abbiamo consultato ogni fonte sottostante il 27 settembre 2026. Consulta i nostri standard editoriali.
Fonti
- Meta per gli sviluppatori — codici di errore WhatsApp Cloud API (131026, 131047), consultati il 27 settembre 2026: developers.facebook.com.
- Meta per gli sviluppatori — riferimento webhook per lo stato dei messaggi, consultato il 27 settembre 2026: developers.facebook.com.
- Politica di messaggistica WhatsApp Business — requisiti di opt-in e disiscrizione, consultato il 27 settembre 2026: whatsappbusiness.com/policy.
- MobileValidate — riferimento ai servizi e ricerca operatore, aggiornato l'ultima volta il 25 settembre 2026: mobilevalidate.com/docs/services, mobilevalidate.com/services/carrier-lookup.
- MobileValidate — politica sull'uso accettabile, consultato il 27 settembre 2026: mobilevalidate.com/legal/acceptable-use.