Cómo usar la API de WhatsApp para habilitar retrocesos por SMS o voz

WhatsApp

·

Cómo usar la API de WhatsApp para habilitar retrocesos por SMS o voz

Puntos clave

    • Flow Builder automates delivery tracking. Usted puede detectar cuando fallan los mensajes de WhatsApp y activar acciones de respaldo instantáneas como SMS o Voice.

    • Fallbacks ensure message delivery. Los canales SMS y Voice compensan los mensajes de WhatsApp no entregados debido a números inválidos, desinstalaciones de aplicaciones o problemas de conectividad.

    • Real-time insights through Google Sheets. Registre automáticamente el estado de entrega (enviado, entregado, leído, rechazado) para visualizar el rendimiento e identificar números problemáticos.

    • WhatsApp Heatmap reporting. Monitoree el rendimiento de la campaña en Flow Builder para comprender el compromiso, optimizar las tasas de entrega y ajustar los flujos.

    • Simple integration setup. Requiere una cuenta de Bird, número local y cuenta de Google para conectar la lógica de mensajería y los paneles de informes.

    • Data-driven optimization. Use registros de rechazo para construir listas de contactos refinadas, reducir el desperdicio de mensajes y fortalecer la eficiencia de la comunicación omnicanal.

    • Time-based automation. La sincronización opcional de estampas de tiempo asegura un seguimiento preciso a través de zonas horarias globales para campañas a escala empresarial.

Destacados de Q&A

  • ¿Qué hace el reporting de WhatsApp API?

    Rastrea los estados de entrega de mensajes: enviados, entregados, leídos o rechazados, para que puedas monitorear el rendimiento de la campaña y tomar medidas en caso de entregas fallidas.

  • ¿Por qué usar SMS o Voice como alternativa?

    Los mecanismos de respaldo garantizan que tu mensaje aún llegue a los clientes si la entrega de WhatsApp falla debido a números no válidos, falta de conectividad o la desinstalación de la aplicación.

  • ¿Cómo configuro reportes con Flow Builder?

    Conecta tu flujo de WhatsApp a una hoja de Google a través de Flow Builder. El estado de cada mensaje (enviado, entregado, rechazado) se registra en tiempo real para un análisis fácil.

  • ¿Cuáles son las razones más comunes por las que fallan los mensajes de WhatsApp?

    Los números de teléfono inválidos, la señal de red deficiente o los usuarios que no tienen WhatsApp instalado son las principales causas.

  • ¿Cómo funciona el proceso de fallback?

    Cuando un mensaje es rechazado, Flow Builder activa automáticamente un canal secundario—SMS o Voice—para entregar el mensaje sin intervención manual.

  • ¿Puedo visualizar el rendimiento de la campaña?

    Sí. Heatmap de Flow Builder te permite ver qué mensajes fueron entregados, leídos o rechazados, ayudando a optimizar tu estrategia de difusión.

  • ¿Cuáles son los requisitos previos antes de la configuración?

    Necesitas una cuenta de Bird, un número local de SMS o de Voz, y una cuenta de Google conectada al panel.

  • ¿Puedo rastrear los tiempos de entrega por región?

    Sí. Puedes usar un paso de "Fetch Variables" para llamar a la API de TimeZoneDB y registrar marcas de tiempo de acuerdo con la zona horaria local del cliente.

  • ¿Cuál es el beneficio empresarial de habilitar fallbacks?

    Maximizas el alcance, reduces las interacciones perdidas y mejoras la satisfacción del cliente asegurando que cada mensaje, ya sea transaccional o promocional, se entregue.

  • ¿Dónde puedo obtener más información?

    Explore la documentación de WhatsApp API y Conversations API de Bird para plantillas, configuración de campañas y mejores prácticas de versionado.

Con el Flow Builder de Bird, puedes saber automáticamente si se entregó un mensaje de WhatsApp y usar SMS o Voice como opción alternativa 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 un proceso que consume tiempo y costoso entender qué usuarios tienen cuentas de WhatsApp y cuáles no.

Para esas empresas, entender qué usuarios no están recibiendo tus mensajes de WhatsApp API puede ayudarte a optimizar los resultados de tus mensajes de difusión, aumentar las conversiones, y el compromiso, y asegurar la conexión con alternativas.

Con Flows de Bird, puedes entender automáticamente si un mensaje de WhatsApp fue entregado, y usar SMS o Voice como opciones alternativas para asegurar que alcances a tu cliente. Aprende cómo obtener más datos de cada mensaje SMS para optimizar tus campañas. En este artículo de blog, aprenderás cómo:

  • Configurar la lógica de tu flujo con Flows

  • Ver los resultados de tu campaña de mensajes de WhatsApp API con Flow Heatmap

  • Crear una lista de números de teléfono de WhatsApp que fueron rechazados

Esta guía será útil si tus mensajes de plantilla de WhatsApp ya han sido aprobados y ya estás enviando mensajes de difusión con Flow Builder. Si tienes problemas para que tus mensajes de plantilla sean aprobados o aún no puedes enviar tu primer mensaje de WhatsApp, asegúrate de leer nuestra guía de Mejores Prácticas para Mensajes de WhatsApp.

Requirements

Antes de comenzar a construir la lógica y el flujo dentro de Flow Builder, necesitas tener los siguientes requisitos listos:

Con eso, puedes seguir estos pasos para ver los resultados de tu campaña de difusión y construir respaldos SMS/Voice para ayudar a garantizar la entregabilidad usando Flow Builder. 

Paso 1: Crea un nuevo flujo en Flow Builder con un Webhook de WhatsApp

Para el primer paso, inicia un nuevo flujo usando esta plantilla:

1. Inicia sesión en tu Bird Dashboard y ve a Flows.

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


2. Descarga el flujo de muestra que vas a utilizar.

3. Importa el flujo con la función de importación. Y publica el flujo.

Interface for importing a flow.


4. El flujo se verá como la imagen de abajo. Luego, haz clic en el botón Publicar y copia la URL del Webhook generada.

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. Navega y abre tu Flujo de Campaña de Difusión por WhatsApp. Haz clic en el paso de enviar mensaje de plantilla de WhatsApp, desplázate hacia abajo y activa el interruptor de informes de estado. Inserta la URL del Webhook copiada en el campo disponible como se ve en la captura de pantalla a continuación. No olvides Publicar nuevamente.

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.

Paso 2: Registra detalles de mensajes de WhatsApp en una nueva hoja de Google

En este paso, aprenderás cómo conectar tu flujo a Google Sheets para que puedas rastrear la entrega de mensajes y el estado. Luego, utiliza esa información para optimizar la entrega a través de WhatsApp y crear 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:

  • Hora: Esto mostrará la hora en que tu mensaje fue rechazado

  • Mensaje_De: Quién es el remitente del mensaje

  • Mensaje_Para: Quién es el destinatario del mensaje

  • Estado: Cuál es el estado actual del mensaje

  • Descripción: Cuál es la razón del rechazo del mensaje


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 tu cuenta de Google con el Bird dashboard para que puedas conectar la hoja que acabas de crear con tu flujo

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


3. Conecta tus columnas de “WhatsApp Campaign Reporting” con cada columna de tu nuevo flujo dentro de 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: Crear lógica de respaldo para SMS / Voice

En este paso, podrá agregar canales de respaldo (SMS o Voice) a su lógica de flujo si se rechaza un mensaje de WhatsApp.

Estas son algunas de las razones más comunes por las que los mensajes son rechazados en esta etapa:

  • El número de teléfono de sus clientes es inválido

  • No tienen señal en el momento en que se enviaron los mensajes

  • No usan WhatsApp o no lo tienen instalado en su teléfono móvil

Una vez que abra el flujo en Flows, verá cuatro ramas diferentes (ver la imagen abajo). Estas ramas están alineadas con los estados de mensaje de WhatsApp API:

Canal

Significado del estado

Acción recomendada

Enviado

Mensaje llegó a los servidores de WhatsApp

Monitorear / esperar el próximo estado de entrega

Entregado

Mensaje entregado al destinatario

Ruta de éxito — continuar el recorrido normal

Leído

Usuario abrió el mensaje

Considerar un mensaje de seguimiento o de llamada a la acción

Rechazado

Entrega fallida (número inválido, sin conexión, no es usuario de WhatsApp)

Activar respaldo: SMS o Voice


Flowchart depicting a webhook integration with status updates.

En este paso, agregará su canal de respaldo a la rama rechazada. La rama rechazada capturará a todos sus clientes que no recibieron su mensaje de WhatsApp con éxito. Esto es parte de una estrategia más amplia para desviar consultas a canales de menor costo.

1. Añadir 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 recoger comentarios de clientes a través de formularios. Por ejemplo, si un mensaje no se entrega con éxito, Flow Builder enviará un SMS o un mensaje de voz.

Flowchart illustrating a communication process, featuring branches for message statuses like "sent," "delivered," and "read," leading to endpoints that perform actions such as fetching timestamps, adding Google Sheets rows, sending SMS, and making outbound calls.


2. Use Flow Heatmap para monitorear el flujo y ver los resultados de su campaña de WhatsApp API. Podrá ver cuántos mensajes fueron enviados, entregados, rechazados y mucho más.

Dashboard displaying performance metrics, including totals, success percentages, items in progress, and failed or canceled counts, along with a flow heatmap showing traffic distribution through a circular diagram.

Utilice nuestro Heatmap para comprender los resultados y la entregabilidad de sus campañas de difusión de WhatsApp API. Para obtener una visión más amplia de la campaña, aprenda cómo usar Bird's Competitive Tracker para comparar su 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. Puedes 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 formateadas. Por favor, regístrate y obtén tu propia clave API gratuita.

Consejo: Asegúrate de monitorear los fallos de manejo del flujo para garantizar que tu flujo continúe incluso si la solicitud falla.


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.

Estos son los pasos simples que necesitas seguir para comenzar a usar SMS o Voice como respaldo cuando tus mensajes de WhatsApp no se entregan correctamente.

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 e interactuar con tus clientes a través de una sola API, consulta nuestra documentación de WhatsApp API y Conversations API. Cuando trabajes con APIs, sigue las mejores prácticas de versionado de API para integraciones mantenibles.

Otras noticias

Leer más de esta categoría

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

La plataforma completa AI-native que escala con tu negocio.

© 2026 Bird

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

La plataforma completa AI-native que escala con tu negocio.

© 2026 Bird