WhatsAppApi
Añade mensajería WhatsApp a tu app.
Envía actualizaciones útiles, recibe respuestas de clientes y sigue cada mensaje a lo largo de su ciclo de vida. Usa las APIs y los SDKs publicados de Bird para conectar WhatsApp con las aplicaciones y flujos en los que tus clientes ya confían.
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);Elige tu SDK o usa HTTP directamente. Estos ejemplos se generan a partir de la operación publicada de Bird.
Una solicitud clara
Elige el mensaje para el momento.
Usa una plantilla aprobada para un mensaje elegible iniciado por la empresa, o una respuesta de formato libre admitida dentro de la ventana de atención al cliente. Mantén el remitente, el destinatario, el idioma y el contenido explícitos.
Usa los ejemplos publicados
Parte del ejemplo generado de SDK o HTTP de arriba. Sigue la estructura de contenido real de la operación y su validación en lugar de adivinar un método a partir de una ilustración de marketing.
Controla el ritmo de la carga
Usa la respuesta de limitación de solicitudes y una cola acotada. Cuando tu aplicación distribuye mensajes, conserva un registro duradero de cada destinatario previsto y cada solicitud.
Un ciclo de vida que puedes razonar
Sigue la aceptación hasta la respuesta del cliente.
Una solicitud aceptada por la API comienza a procesarse. La aceptación de Meta, la entrega y las actualizaciones de lectura describen etapas posteriores; no garantizan que un cliente haya completado tu tarea de negocio.
Concilia con las lecturas de mensajes
Consume los webhooks relevantes y consulta los registros de mensajes cuando investigues una discrepancia. Mantén los intentos inciertos separados de los fallos confirmados.
Mantén precisas las decisiones de reintento
Usa las protecciones de solicitud documentadas y la clasificación de errores. No asumas que un intento incierto del proveedor puede repetirse indefinidamente de forma segura.
Bird admite la solicitud y devuelve la identidad del mensaje.
El mensaje avanza por el flujo de envío.
Las observaciones del proveedor actualizan el registro del mensaje cuando están disponibles.
Gestiona el rechazo, el fallo y las observaciones faltantes como parte de la misma integración.
Una conversación, no solo un endpoint
Lleva el contexto útil a la respuesta.
Usa identificadores explícitos de botón o lista de respuesta y el estado de conversación de tu aplicación. Una respuesta puede citar un mensaje anterior, pero esa referencia es opcional y puede no estar disponible.
Mantén los metadatos en su lugar
Los metadatos salientes pertenecen al registro saliente. No asumas que se copian en el mensaje entrante del cliente.
Conecta herramientas con los mismos permisos
CLI y MCP pueden ayudar a los desarrolladores a operar el canal. Siguen sujetos al mismo acceso del espacio de trabajo, propiedad del remitente y reglas de envío.
Preguntas sobre la API 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
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Haz que la primera solicitud forme parte de una integración funcional.
Configura tu espacio de trabajo, usa un ejemplo publicado e inspecciona la respuesta. Conecta las respuestas y los eventos de entrega antes de ampliar el tráfico.