Come utilizzare il reporting dell'API di WhatsApp per abilitare un fallback SMS o Voce
·
20 apr 2021

Punti Chiave
Flow Builder automatizza il tracciamento delle consegne. Puoi rilevare quando i messaggi di WhatsApp falliscono e attivare azioni di fallback istantanee come SMS o Voce.
I fallback garantiscono la consegna dei messaggi. I canali SMS e Voce compensano i messaggi di WhatsApp non consegnati a causa di numeri non validi, disinstallazione dell'app o problemi di connettività.
Informazioni in tempo reale tramite Google Sheets. Registra automaticamente lo stato della consegna (inviato, consegnato, letto, rifiutato) per visualizzare le prestazioni e identificare i numeri problematici.
Reporting della heatmap di WhatsApp. Monitora le prestazioni della campagna in Flow Builder per comprendere il coinvolgimento, ottimizzare i tassi di consegna e regolare i flussi.
Impostazione di integrazione semplice. Richiede un account Bird, un numero locale e un account Google per connettere la logica di messaggistica e i dashboard di reporting.
Ottimizzazione basata sui dati. Utilizza i registri di rifiuto per costruire elenchi di contatti rifiniti, ridurre gli sprechi di messaggi e rafforzare l'efficienza nella comunicazione omnicanale.
Automazione basata sul tempo. La sincronizzazione dei timestamp opzionale garantisce un tracciamento accurato nei vari fusi orari per campagne su scala aziendale.
Punti salienti del Q&A
Cosa fa la reportistica dell'API di WhatsApp?
Monitora gli stati di consegna dei messaggi—inviato, consegnato, letto o rifiutato—così puoi tenere sotto controllo le prestazioni della campagna e agire sulle consegne non riuscite.
Perché utilizzare SMS o Voce come opzione di riserva?
I fallback garantiscono che il tuo messaggio raggiunga ancora i clienti se la consegna di WhatsApp fallisce a causa di numeri non validi, mancanza di connettività o disinstallazione dell'app.
Come posso configurare la reportistica con Flow Builder?
Collega il tuo flusso di WhatsApp a un Google Sheet tramite Flow Builder. Ogni stato del messaggio (inviato, consegnato, rifiutato) viene registrato in tempo reale per un'analisi facile.
Quali sono i motivi più comuni per cui i messaggi di WhatsApp non riescono?
I numeri di telefono non validi, il segnale di rete debole o utenti che non hanno WhatsApp installato sono le principali cause.
Come funziona il processo di fallback?
Quando un messaggio viene rifiutato, Flow Builder attiva automaticamente un canale secondario—SMS o Voce—per consegnare il messaggio senza intervento manuale.
Posso visualizzare le prestazioni della campagna?
Sì. Il Heatmap di Flow Builder ti consente di vedere quali messaggi sono stati consegnati, letti o rifiutati, aiutando a ottimizzare la tua strategia di broadcast.
Quali sono i requisiti necessari prima dell'installazione?
Hai bisogno di un account Bird, di un numero SMS o di Voice locale e di un account Google collegato al cruscotto.
Posso monitorare i tempi di consegna per regione?
Sì. Puoi utilizzare un passaggio "Recupera variabili" per chiamare l'API TimeZoneDB e registrare i timestamp secondo il fuso orario locale del cliente.
Qual è il vantaggio commerciale di abilitare i fallback?
Massimizzi la portata, riduci le interazioni mancate e migliori la soddisfazione del cliente assicurando che ogni messaggio, sia esso transazionale o promozionale, venga consegnato.
Dove posso imparare di più?
Esplora la documentazione dell'API WhatsApp e dell'API Conversazioni di Bird per modelli, configurazione della campagna e migliori pratiche per la gestione delle versioni.
Con il Flow Builder di Bird, puoi sapere automaticamente se un messaggio WhatsApp è stato consegnato e utilizzare SMS o Voce come opzione di riserva per garantire di raggiungere il tuo cliente.
Man mano che sempre più aziende interagiscono con i propri clienti tramite WhatsApp, può essere dispendioso in termini di tempo e costoso capire quali utenti possiedono un account WhatsApp e quali no.
Per queste aziende, comprendere quali utenti non ricevono i tuoi messaggi API di WhatsApp può aiutarti a ottimizzare i risultati dei tuoi messaggi broadcast, aumentare le conversioni e il coinvolgimento, e garantire la connessione con alternative di fallback.
Con i Flows di Bird, puoi comprendere automaticamente se un messaggio WhatsApp è stato consegnato, e utilizzare SMS o Voce come opzioni di fallback per garantire di raggiungere il tuo cliente. Scopri come ottenere più dati da ogni messaggio SMS per ottimizzare le tue campagne. In questo blog, imparerai come:
Impostare la logica del tuo flusso con Flows
Visualizzare i risultati della tua campagna di messaggi API di WhatsApp con la mappa di calore Flows
Costruire un elenco di numeri di telefono WhatsApp che sono stati rifiutati
Questa guida ti aiuterà se i tuoi messaggi modello di WhatsApp sono già stati approvati e stai già inviando messaggi broadcast con Flow Builder. Se hai problemi ad ottenere l'approvazione dei tuoi messaggi modello o non riesci ancora a inviare il tuo primo messaggio WhatsApp, assicurati di leggere la nostra guida sulle Migliori Pratiche per i Messaggi di WhatsApp.
Requisiti
Prima di iniziare a costruire la logica e il flusso all'interno di Flow Builder, è necessario avere i seguenti requisiti pronti:
Con questi, puoi seguire questi passaggi per vedere i risultati della tua campagna di trasmissione e costruire fallback SMS/Voce per aiutare a garantire la consegna utilizzando Flow Builder.
Passo 1: Crea un nuovo flusso in Flow Builder con un Webhook di WhatsApp
Per il primo passaggio, avvia un nuovo flusso utilizzando questo modello:
1. Accedi al tuo Dashboard di Bird e vai su Flussi.

2. Scarica il flusso di esempio che utilizzerai.
3. Importa il flusso utilizzando la funzione di importazione. E pubblica il flusso.

4. Il flusso apparirà come nell'immagine qui sotto. Quindi, fai clic sul pulsante Pubblica e copia l'URL Webhook generato.

5. Naviga e apri il tuo Flusso della Campagna Broadcast di WhatsApp. Fai clic sul passaggio Invia messaggio di modello WhatsApp, scorri fino in fondo e attiva l'interruttore dei rapporti di stato. Inserisci l'URL Webhook copiato nel campo disponibile come visto nello screenshot qui sotto. Non dimenticare di pubblicare di nuovo.

Passo 2: Registra i dettagli dei messaggi WhatsApp su un nuovo Google Sheet
In questo passaggio, imparerai come collegare il tuo flusso a Google Sheets in modo da poter monitorare la consegna e lo stato dei messaggi. Quindi, utilizza queste informazioni per ottimizzare la consegna tramite WhatsApp e creare logiche di fallback per garantire di raggiungere il tuo cliente.
1. Crea un nuovo Google Sheet con il seguente nome (“WhatsApp Campaign Reporting”) e colonne:
Ora: Mostrerà l'ora in cui il tuo messaggio è stato rifiutato
Messaggio_Da: Chi è il mittente del messaggio
Messaggio_A: Chi è il destinatario del messaggio
Stato: Qual è lo stato attuale del messaggio
Descrizione: Qual è il motivo per cui il messaggio è stato rifiutato

2. Integra il tuo account Google con il dashboard di Bird in modo da poter collegare il foglio appena creato con il tuo flusso

3. Collega le colonne “WhatsApp Campaign Reporting” con ogni colonna del tuo nuovo flusso all'interno di Flow Builder

Parte 3: Crea la logica di fallback per SMS / Voce
In questo passaggio, sarai in grado di aggiungere canali alternativi (SMS o Voice) alla tua logica di flusso se un messaggio WhatsApp viene rifiutato.
Questi sono alcuni dei motivi più comuni per cui i messaggi vengono rifiutati in questa fase:
Il numero di telefono dei tuoi clienti non è valido
Non hanno segnale al momento in cui i messaggi sono stati inviati
Non usano WhatsApp o non lo hanno installato sul loro telefono cellulare
Una volta che apri il flusso in Flows, vedrai quattro rami diversi (vedi immagine qui sotto). Questi rami sono allineati con gli stati dei messaggi dell'API WhatsApp:
Canale | Significato dello stato | Azioni consigliate |
|---|---|---|
Inviato | Il messaggio ha raggiunto i server di WhatsApp | Monitora / aspetta il prossimo stato di consegna |
Consegnato | Messaggio consegnato al destinatario | Percorso di successo — continua il normale percorso |
Letto | L'utente ha aperto il messaggio | Considera un follow-up o un messaggio CTA |
Rifiutato | Consegna fallita (numero non valido, offline, non utente di WhatsApp) | Attiva il fallback: SMS o Voice |

In questo passaggio, aggiungerai il tuo canale alternativo al ramo rifiutato. Il ramo rifiutato catturerà tutti i tuoi clienti che non hanno ricevuto correttamente il tuo messaggio WhatsApp. Questo fa parte di una strategia più ampia per deviare le richieste su canali a costo inferiore.
1. Aggiungi l'azione “Invia SMS” o “Chiamata in uscita” come passaggio nel ramo rifiutato. Questo ramo sarà utilizzato come percorso alternativo una{
Parte 4: Aggiungi timestamp al tuo flusso (opzionale)
La variabile timestamp predefinita in Flows si basa sul fuso orario UTC. Puoi utilizzare un “Fetch variables” passo all'interno di Flow Builder per effettuare una richiesta GET a http://api.timezonedb.com e sincronizzarti automaticamente con il fuso orario del cliente. Le variabili di output dovrebbero essere formattate. Si prega di registrarsi e ottenere il proprio API key gratuito.
Consiglio: Assicurati di monitorare il maneggiamento dei fallimenti del flusso per garantire che il tuo flusso continui anche se la richiesta fallisce.

Questi sono i semplici passaggi che devi seguire per iniziare a utilizzare SMS o Voce come fallback quando i tuoi messaggi WhatsApp non vengono consegnati con successo.
Conclusione
Il tuo flusso è ora in grado di creare una Mappa di Calore e mostrare i risultati delle tue campagne broadcast su WhatsApp. Ora sai come utilizzare i Flussi per personalizzare l'esperienza del cliente. Per continuare a costruire progetti e interagire con i tuoi clienti tramite un'unica API, controlla la nostra documentazione dell'API di WhatsApp e documentazione dell'API Conversazioni. Quando lavori con le API, segui le migliori pratiche di versioning delle API per integrazioni manutenibili.



