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

WhatsApp

·

20 apr 2021

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

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.

Digital interface for an online platform used to automate communication through flow creation.


2. Scarica il flusso di esempio che utilizzerai.

3. Importa il flusso utilizzando la funzione di importazione. E pubblica il flusso.

Interface for importing a flow.


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

Workflow diagram is displayed on a software interface, illustrating a sequence of steps involving webhook configurations, message variables, and timeout settings for a WhatsApp broadcast SMS voice fallback and reporting process.


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.

User interface of a flow builder tool with a visible workflow diagram, including steps like sending a WhatsApp template message, along with options for adding content and setting triggers.

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


A spreadsheet titled "WhatsApp Campaign Reporting" displays columns for time, message sender, message recipient, status, and description, with all entries marked as "Rejected" and descriptions noting recipients not registered on WhatsApp.


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

Software interface for integrating Google Sheets, highlighting steps to connect and sync existing events.


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

Flow diagram of an automated process shows steps to add a row in Google Sheets after fetching a timestamp and checking message status; the result moves through success or failure routes within a structural layout.

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


Flowchart depicting a webhook integration with status updates.

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.


Flowchart illustrating a decision-making process for fetching a timestamp, featuring a starting point labeled "Fetch TimeStamp" with options "Success" and "Failed," and a side panel showing settings for API configuration, including URL, method, OAuth integration, and variables.

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.

Altre notizie

Leggi di più da questa categoria

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

© 2026 Uccello

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

© 2026 Uccello