Cómo usar la API de WhatsApp para habilitar retrocesos por SMS o voz
Zou PengBin
20 abr 2021
1 min read
Puntos clave
Flow Builder automates delivery tracking. You can detect when WhatsApp messages fail and trigger instant fallback actions like SMS or Voice.
Fallbacks ensure message delivery. SMS and Voice channels compensate for undelivered WhatsApp messages due to invalid numbers, app uninstalls, or connectivity issues.
Real-time insights through Google Sheets. Automatically log delivery status (sent, delivered, read, rejected) to visualize performance and identify problem numbers.
WhatsApp Heatmap reporting. Monitor campaign performance in Flow Builder to understand engagement, optimize delivery rates, and adjust flows.
Simple integration setup. Requires a Bird account, local number, and Google account to connect messaging logic and reporting dashboards.
Data-driven optimization. Use rejection logs to build refined contact lists, reduce message waste, and strengthen omnichannel communication efficiency.
Time-based automation. Optional timestamp syncing ensures accurate tracking across global time zones for enterprise-scale campaigns.
Q&A Highlights
What does WhatsApp API reporting do?
It tracks message delivery statuses—sent, delivered, read, or rejected—so you can monitor campaign performance and take action on failed deliveries.
Why use SMS or Voice as a fallback?
Fallbacks ensure your message still reaches customers if WhatsApp delivery fails due to invalid numbers, lack of connectivity, or the app being uninstalled.
How do I set up reporting with Flow Builder?
Connect your WhatsApp flow to a Google Sheet through Flow Builder. Each message status (sent, delivered, rejected) is recorded in real time for easy analysis.
What are the most common reasons WhatsApp messages fail?
Invalid phone numbers, poor network signal, or users not having WhatsApp installed are the main causes.
How does the fallback process work?
When a message is rejected, Flow Builder automatically triggers a secondary channel—SMS or Voice—to deliver the message without manual intervention.
Can I visualize campaign performance?
Yes. Flow Builder’s Heatmap lets you see which messages were delivered, read, or rejected, helping optimize your broadcast strategy.
What are the prerequisites before setup?
You need a Bird account, a local SMS or Voice number, and a Google account connected to the dashboard.
Can I track delivery times by region?
Yes. You can use a “Fetch Variables” step to call the TimeZoneDB API and record timestamps according to the customer’s local time zone.
What’s the business benefit of enabling fallbacks?
You maximize reach, reduce missed interactions, and improve customer satisfaction by ensuring every message—transactional or promotional—gets delivered.
Where can I learn more?
Explore Bird’s WhatsApp API and Conversations API documentation for templates, campaign setup, and versioning best practices.
Con el Flow Builder de MessageBird, puedes saber automáticamente si un mensaje de WhatsApp fue entregado, y utilizar SMS o Voz como opción de respaldo para asegurarte de llegar a tu cliente.
A medida que más y más empresas interactúan con sus clientes a través de WhatsApp, puede ser lento y costoso entender cuáles usuarios tienen cuentas de WhatsApp y cuáles no.
Para esas empresas, entender quiénes usuarios no están recibiendo sus mensajes del API de WhatsApp puede ayudarle a optimizar los resultados de sus mensajes de difusión, aumentar las conversiones y el compromiso, y asegurar la conexión con alternativas.
Con los Flows de Bird, puede entender automáticamente si un mensaje de WhatsApp fue entregado, y usar SMS o Voice como opciones alternativas para asegurar que llega a su cliente. Aprenda cómo obtener más datos de cada mensaje SMS para optimizar sus campañas. En este blog, aprenderá cómo:
Configurar la lógica de su flujo con Flows
Ver los resultados de su campaña de mensajes de API de WhatsApp con Flow Heatmap
Construir una lista de números de teléfono de WhatsApp que fueron rechazados
Esta guía le ayudará si sus mensajes de plantilla de WhatsApp ya han sido aprobados y ya está enviando mensajes de difusión con Flow Builder. Si tiene problemas para que sus mensajes de plantilla sean aprobados o aún no puede enviar su primer mensaje de WhatsApp, asegúrese de leer nuestra guía de Mejores Prácticas de Mensajes de WhatsApp.
Requirements
Antes de comenzar a construir la lógica y el flujo dentro de Flow Builder, necesitas tener listos los siguientes requisitos:
Con esos, puedes seguir estos pasos para ver los resultados de tu campaña de difusión y construir soluciones alternativas de SMS/Voz para ayudar a garantizar la entregabilidad usando Flow Builder.
Paso 1: Crear un nuevo flujo en Flow Builder con un WhatsApp Webhook
Paso 2: Registra los detalles de los mensajes de WhatsApp en una nueva hoja de Google Sheet
En este paso, aprenderás cómo conectar tu flujo a Google Sheets para que puedas rastrear la entrega de mensajes y su estado. Luego, usa esa información para optimizar la entrega a través de WhatsApp y crea una lógica de respaldo para asegurarte de llegar a tu cliente.
1. Crea una nueva hoja de Google con el siguiente nombre (“WhatsApp Campaign Reporting”) y columnas:
Time: Esto mostrará la hora en que tu mensaje fue rechazado
Message_From: Quién es el remitente del mensaje
Message_To: Quién es el destinatario del mensaje
Status: Cuál es el estado actual del mensaje
Description: Cuál es la razón por la que el mensaje fue rechazado
2. Integra tu cuenta de Google con el Bird dashboard para que puedas conectar la hoja que acabas de crear con tu flujo
3. Conecta las columnas de tu “WhatsApp Campaign Reporting” con cada columna en tu nuevo flujo dentro de Flow Builder
Parte 3: Crear lógica de respaldo para SMS / Voice
En este paso, podrás agregar canales de respaldo (SMS o Voice) a la lógica de tu flujo si se rechaza un mensaje de WhatsApp.
Estas son algunas de las razones más comunes por las que los mensajes se rechazan en esta etapa:
El número de teléfono de tus clientes es inválido
No tienen señal al momento en que los mensajes fueron enviados
No usan WhatsApp o no lo tienen instalado en su teléfono móvil
Una vez que abras el flujo en Flows, verás cuatro ramas diferentes (ver imagen abajo). Estas ramas están alineadas con los estados de mensajes de WhatsApp API:
Enviado: Mensaje recibido por el servidor de WhatsApp
Entregado: Mensaje entregado al destinatario
Leído: Mensaje leído por el destinatario
Rechazado: Mensaje enviado por tu negocio falló en enviarse
En este paso, agregarás tu canal de respaldo a la rama rechazada. La rama rechazada capturará a todos tus clientes que no recibieron tu mensaje de WhatsApp exitosamente. Esto es parte de una estrategia más amplia para desviar consultas a canales de menor costo.
1. Agrega la acción “Enviar SMS” o “Llamada Saliente” como un paso en la rama rechazada. Esta rama se utilizará como la ruta de respaldo una vez que los mensajes sean rechazados por WhatsApp Business API. El SMS también es efectivo para recopilar comentarios de clientes a través de formularios. Por ejemplo, si un mensaje no se entrega con éxito, Flow Builder enviará un SMS o mensaje de voz.
2. Usa Flow Heatmap para monitorear el flujo y ver los resultados de tu campaña de WhatsApp API. Podrás ver cuántos mensajes fueron enviados, entregados, rechazados y mucho más.
Utiliza nuestro Heatmap para entender los resultados y la entregabilidad de tus campañas de difusión de WhatsApp API. Para obtener información más amplia sobre la campaña, aprende cómo usar Bird's Competitive Tracker para comparar tu rendimiento.
Parte 4: Añadir marca de tiempo a tu flujo (opcional)
La variable de marca de tiempo predeterminada en Flows se basa en la zona horaria UTC. Puede usar un paso de “Fetch variables” dentro de Flow Builder para hacer una solicitud GET a http://api.timezonedb.com y sincronizar automáticamente con la zona horaria del cliente. Las output variables deben estar formatted. Por favor regístrese y obtenga su propia clave API gratuita.
Consejo: Asegúrese de monitorear los manejos de fallos del flujo para garantizar que su flujo continúe incluso si la solicitud falla.
Estos son los pasos simples que debe seguir para comenzar a usar SMS o Voice como una solución alternativa cuando sus mensajes de WhatsApp no se entregan con éxito.
Conclusión
Tu flujo ahora puede crear un Heatmap y mostrar los resultados de tus campañas de difusión de WhatsApp. Ahora sabes cómo usar Flows para personalizar la experiencia del cliente. Para continuar construyendo proyectos y relacionarte con tus clientes a través de una sola API, consulta nuestra WhatsApp API y la documentación de Conversations API. Al trabajar con APIs, sigue las mejores prácticas de versionado de APIs para integraciones mantenibles.
