Vai al contenuto principale
Quando un contatto dice di non aver ricevuto il vostro messaggio WhatsApp, per prima cosa trovate il messaggio in Flowella. Il suo stato, e il motivo indicato da Flowella, vi dicono cosa è andato storto e cosa correggere.

​
Controllare lo stato del messaggio

Aprite la conversazione nell’Inbox. Ogni messaggio che inviate mostra un’icona di stato accanto all’orario. Il motivo di un errore è riportato sotto il messaggio, quindi non serve passarci sopra con il mouse. Se WhatsApp non ha fornito alcun motivo, compare solo l’icona.

​
Individuare la causa

Questo albero decisionale mostra dove guardare, partendo da ciò che vedete nell’Inbox.

​
Messaggi non riusciti

Quando un messaggio mostra Failed, leggete il motivo sotto di esso. Questi sono i motivi più comuni: La finestra di 24 ore è la finestra di assistenza clienti di Meta: le 24 ore successive all’ultimo messaggio che il contatto vi ha inviato. Per tutti gli altri codici, consultate Codici di errore WhatsApp.

​
Messaggi che non sono nell’Inbox

Se non trovate il messaggio nella conversazione, non è mai stato inviato: Flowella o WhatsApp lo hanno rifiutato, oppure Flowella lo sta trattenendo. Controllate da dove è stato inviato:
  • Un workflow HubSpot. Aprite in HubSpot la cronologia delle iscrizioni del workflow per quel contatto. Il passaggio Send WhatsApp Template, Send WhatsApp Message o Send WhatsApp Reply non riuscito mostra il messaggio di errore di Flowella e l’output Error code dell’azione contiene un codice breve. Consultate Codici di errore delle azioni di invio.
  • Un invio massivo o un invio di prova. Aprite il template, selezionate la scheda Statistics e leggete la colonna Details del Send log. Consultate Send log.
  • L’Inbox o l’API. Flowella mostra il motivo nell’Inbox, o lo restituisce nella risposta API, e non invia il messaggio.
Questi sono i motivi più frequenti:
Flowella blocca ogni messaggio verso un numero di telefono che ha effettuato l’opt-out sul numero WhatsApp da cui inviate. Questo vale per Inbox, invii massivi, Test Template, workflow HubSpot e API.
  • In HubSpot, il passaggio fallisce con CONTACT_OPTED_OUT.
  • Nel Send log, Details riporta “Recipient opted out of messages on this channel.”
  • Nell’Inbox, Flowella indica “This contact opted out on this WhatsApp number.”
Per verificare, selezionate il numero WhatsApp da cui avete inviato, poi selezionate Opt-outs nella barra laterale e cercate il numero di telefono. Ogni numero WhatsApp ha il proprio elenco. Rispettate l’opt-out. Usate Re-opt in solo quando il contatto ha chiesto di ricevere di nuovo vostri messaggi. Consultate Opt-out.
Quando WhatsApp sospende o disattiva un template, Flowella trattiene gli invii massivi e gli invii HubSpot Send WhatsApp Template che lo usano. Li invia quando WhatsApp ripristina il template e la notifica Message template approved vi indica quanti processi di invio trattenuti sono ripresi. Nel frattempo il passaggio HubSpot attende il risultato di Flowella.Un template disattivato resta trattenuto finché non lo modificate, lo inviate di nuovo in revisione e Meta lo approva di nuovo. Non potete inviare un template sospeso o disattivato dall’Inbox. Controllate il badge del template nella pagina Templates. Consultate Badge sullo stato di consegna e Template sospesi o disattivati.
Flowella blocca gli invii quando la prova gratuita è terminata, siete sul piano Free, l’abbonamento è terminato o un pagamento è scaduto da più di 7 giorni. Quando un pagamento non va a buon fine, l’invio continua a funzionare per 7 giorni. Durante la prova gratuita, gli invii dall’Inbox, gli invii massivi e l’API si fermano anche quando raggiungete il limite di messaggi della prova.Nell’app vedete Subscription required, Payment required o Message limit reached. In HubSpot, il passaggio Send WhatsApp Template fallisce con un messaggio che indica che l’abbonamento non è attivo o che il pagamento è scaduto. Consultate Azioni bloccate dalla fatturazione.
I numeri di telefono devono essere in formato internazionale: un +, il prefisso internazionale e il numero, come +447700900123. Uno 0 iniziale o un prefisso internazionale mancante fanno fallire l’invio.
  • In HubSpot, il passaggio fallisce con CONTACT_PHONE_MISSING o CONTACT_PHONE_INVALID.
  • Nel Send log, Details riporta “Invalid phone number.”
Consultate Formato del numero di telefono.
Se lo stesso template, nella stessa lingua, viene inviato allo stesso numero di telefono dallo stesso numero WhatsApp entro 15 secondi, Flowella lo invia una sola volta. La ripetizione compare come Suppressed nel Send log e il passaggio HubSpot fallisce con DUPLICATE_TEMPLATE_SEND_SUPPRESSED. Il numero di telefono ha comunque ricevuto il template una volta. Consultate Invio del template soppresso come duplicato.
Quando una variabile non ha un valore per il contatto e il template non ha un valore di riserva confermato, Flowella non invia. L’errore indica la variabile, ad esempio “Variable {{1}} is empty and has no fallback value.” In HubSpot, il codice di errore è VARIABLE_EMPTY_NO_FALLBACK. Consultate Valori di riserva.

​
Messaggi bloccati su Sent, Pending o Held

Sent ma mai Delivered. Il telefono del contatto potrebbe essere spento o offline. WhatsApp continua a tentare la consegna per un certo tempo, poi scarta il messaggio. Consultate Time-to-live. Se il contatto ha bloccato il vostro numero aziendale, anche i vostri messaggi restano su Sent. In Flowella non c’è nulla da correggere: contattate la persona in un altro modo. Held. WhatsApp può applicare il pacing a un template nuovo, riattivato di recente o non ancora valutato Green. Invia i primi messaggi, poi trattiene gli altri mentre attende i riscontri delle persone che li hanno ricevuti. Se i riscontri sono buoni, WhatsApp invia i messaggi trattenuti. Se sono negativi, WhatsApp li scarta, falliscono con il codice 132015 e il template viene sospeso. Meta dichiara di puntare a consegnare i messaggi delle campagne soggette a pacing entro un’ora. Consultate la pagina di Meta sul pacing dei template. Pending. Flowella non ha ancora ricevuto uno stato da WhatsApp. Ricaricate la conversazione dopo qualche minuto. Se molti messaggi restano Pending, controllate lo stato della WhatsApp Business API di Meta per eventuali incidenti.

​
Individuare per tempo i problemi di consegna

  • Dashboard. La barra degli avvisi mostra Delivery failures quando più del 5% dei messaggi inviati dal numero selezionato negli ultimi 7 giorni è fallito. Selezionate Open analytics per vedere i dettagli. Consultate Dashboard.
  • Results. La scheda Failure rate diventa rossa sopra il 5%. Template performance mostra quali template falliscono. Consultate Results.
  • Banner sulla qualità. Un banner rosso nella parte superiore dell’app indica “WhatsApp quality or account status needs attention” quando uno dei vostri numeri ha una valutazione della qualità Red o è limitato. Consultate Valutazione della qualità.
  • Notifiche. Flowella avvisa tutti nella vostra organizzazione, nell’app e via email, di questi eventi. Non potete disattivarle.
    • WhatsApp quality rating: la qualità di un numero scende a Yellow o Red.
    • Template paused: WhatsApp sospende un template.
    • Template quality drop: la qualità di un template scende a Red.
    Consultate Preferenze di notifica.

​
Ancora bloccati?

Contattate il supporto Flowella indicando:
  • Il numero di telefono del contatto e il numero WhatsApp da cui avete inviato
  • La data e l’ora dell’invio
  • Il testo sotto il messaggio, oppure il codice di errore da HubSpot o dal Send log
  • Il nome del template, se avete inviato un template

​
Pagine correlate

Codici di errore WhatsApp

Cosa significa ciascun codice e come risolverlo.

Errori di sincronizzazione HubSpot

Azioni dei workflow che falliscono e i relativi codici di errore.

Opt-out

Controllate e gestite gli opt-out per ciascun numero WhatsApp.

Valutazione della qualità

Come Meta valuta il vostro numero e i vostri template.
Ultima modifica il 24 ottobre 2026