Envía actualizaciones de WhatsApp, códigos de verificación y respuestas interactivas desde una sola API.
Entrega confirmaciones de pedidos, códigos de verificación de un solo uso, contenido multimedia y botones interactivos o menús de lista directamente en los chats de WhatsApp de tus clientes. Bird valida los parámetros de las plantillas y comprueba la ventana de atención al cliente de 24 horas antes del envío, lo que evita llamadas fallidas y cargos inesperados mientras transmite a tu app las confirmaciones de entrega y de lectura.
// Install the SDK
// npm install @messagebird/sdk
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
},
});
console.log(msg.id, msg.status);Envía tu primer mensaje en minutos con nuestros SDK de TypeScript, Python, Go o PHP, la CLI de Bird o solicitudes HTTP directas. Empieza de inmediato con las plantillas preaprobadas de Bird mientras se verifica tu propio número de WhatsApp Business.
Plantillas y ventana de 24 horas
Envía el formato adecuado dentro o fuera de la ventana de 24 horas.
WhatsApp distingue los contactos iniciados por la empresa de las conversaciones activas con clientes. Llega a tus clientes fuera de un chat activo con plantillas de utilidad, autenticación o marketing aprobadas por Meta y, después, pasa a texto libre, contenido multimedia y menús interactivos durante las 24 horas siguientes a que te escriban o llamen.
Detecta de antemano ventanas cerradas y variables que no coinciden
Bird controla la ventana de atención al cliente de 24 horas por destinatario y número de empresa. Si tu app intenta enviar un mensaje libre después de que se cierre la ventana, o pasa variables de plantilla que no coinciden con tus marcadores, la API rechaza la llamada antes de crear o facturar nada.
Contenido multimedia, botones interactivos y menús de lista
Con una conversación abierta, envía imágenes, PDF, clips de audio, vídeos, ubicaciones o tarjetas de contacto desde un único endpoint. Añade botones de respuesta rápida, menús de lista con varias opciones, carruseles de productos o solicitudes de ubicación y contacto para que tus clientes toquen en lugar de escribir.
Seguimiento de entregas en tiempo real
Sigue los mensajes desde su aceptación en la API hasta la confirmación de lectura.
El envío en WhatsApp es asíncrono. En cuanto Bird acepta tu solicitud, los eventos de webhook y la cronología de cada mensaje muestran cuándo se entrega a WhatsApp, cuándo llega al teléfono del cliente y cuándo se abre en el chat.
Diagnostica rechazos con los detalles de error de Meta
Si un mensaje falla tras su aceptación, por ejemplo porque la ventana de servicio caduca durante el envío o Meta bloquea la entrega, Bird registra la descripción del fallo y el código de error de Meta en el registro del mensaje, para que tu equipo sepa si debe reintentar o cambiar de canal.
Evita envíos duplicados en los reintentos de red
Incluye una clave de idempotencia en tu solicitud de envío para que, ante un tiempo de espera agotado o un reintento del worker dentro del periodo de retención, se devuelva la respuesta original en lugar de enviar un mensaje duplicado.
order_ready
Eventos
Aceptado
Bird acepta la solicitud y devuelve la identidad del mensaje.
Enviado
El mensaje avanza por el flujo de envío.
Entregado
Las observaciones del proveedor actualizan el registro del mensaje cuando están disponibles.
Lectura
Gestiona los rechazos, los fallos y las observaciones que faltan como parte de la misma integración.
Harbor
Cuenta de empresa
order_ready
Harbor
Cuenta de empresa
Eventos
Aceptado
Bird acepta la solicitud y devuelve la identidad del mensaje.
Enviado
El mensaje avanza por el flujo de envío.
Entregado
Las observaciones del proveedor actualizan el registro del mensaje cuando están disponibles.
Lectura
Gestiona los rechazos, los fallos y las observaciones que faltan como parte de la misma integración.
Contexto para flujos bidireccionales
Mantén las respuestas de los clientes vinculadas al pedido o ticket correcto.
Cita un mensaje anterior para que tu cliente vea en su chat a qué pregunta o pedido respondes. Cuando un cliente toca un botón de respuesta rápida, elige una opción de lista o responde a un mensaje reciente, Bird devuelve la acción seleccionada y la referencia del mensaje citado para que tu app enrute la respuesta al instante.
Etiqueta y añade metadatos a los envíos salientes
Añade hasta 20 etiquetas filtrables y 2 KB de metadatos JSON personalizados a un mensaje saliente. Filtra los registros de mensajes por campaña o flujo de trabajo, y mantén tus ID internos de pedido o ticket vinculados al registro saliente en las lecturas de la API y en los webhooks de entrega.
Opera desde tu código, tu terminal o tu agente de IA
Envía mensajes de prueba, revisa las cronologías de entrega y filtra el historial reciente desde la CLI de Bird, o conecta tu asistente de programación mediante el servidor MCP de Bird, sujeto a los permisos de rol y de remitente de tu espacio de trabajo.
Preguntas sobre envíos de WhatsApp
¿Una solicitud aceptada significa que el mensaje fue entregado?
¿Puedo enviar mensajes de formato libre en cualquier momento?
¿Existe un endpoint de lote en WhatsApp?
¿Cómo asocio una respuesta interactiva con mi aplicación?
Conecta el recorrido completo
Escala sin
perder el control.
Organiza equipos en espacios de trabajo, controla el acceso a la API y rastrea cambios en los registros de auditoría.
Organización
Harbor
El acceso permanece en su espacio de trabajo.
Producción/Claves de API
Agente de entrega
ActivoAlex Lee
Admin
Hoy · UTC
Registro de auditoría
Organización
Harbor
El acceso permanece en su espacio de trabajo.
Producción/Claves de API
Agente de entrega
ActivoAlex Lee
Admin
Hoy · UTC
Registro de auditoría
Organización
Harbor
El acceso permanece en su espacio de trabajo.
Producción/Claves de API
Agente de entrega
ActivoAlex Lee
Admin
Hoy · UTC
Registro de auditoría