Respuesta breve
Para enviar un mensaje de WhatsApp por API, conecte una cuenta de WhatsApp Business mediante un partner de Meta o la Cloud API de Meta, obtenga el consentimiento (opt-in) de los destinatarios y consiga aprobar una plantilla. Envíe la plantilla para iniciar la conversación. Cuando el cliente responda, podrá enviar texto libre, multimedia o mensajes interactivos durante la ventana de atención de 24 horas.
Qué necesita antes del primer envío
- Una cuenta de WhatsApp Business (WABA), creada normalmente con el flujo Embedded Signup de Meta de un partner, con un número de empresa verificado y un nombre visible.
- Al menos una plantilla aprobada en la categoría de marketing, utilidad o autenticación.
- El consentimiento de cada destinatario, como exigen las políticas de Meta.
- Un acuerdo de facturación. Desde el 1 de julio de 2025, Meta cobra por mensaje entregado según la categoría y el mercado del destinatario; consulte la tarifa vigente de Meta.
¿Plantilla o mensaje libre?
Desde el 1 de octubre de 2026, Meta también cobra los mensajes de servicio y las plantillas de utilidad enviadas dentro de la ventana, a partir de 1.000 mensajes de servicio gratuitos por número de empresa al mes.
| Situación | Qué puede enviar |
|---|---|
| Usted inicia la conversación | Solo una plantilla aprobada |
| El cliente le escribió en las últimas 24 horas | Cualquier tipo de mensaje: texto, multimedia, interactivo o plantilla |
| La ventana de 24 horas está cerrada | Solo una plantilla aprobada |
| Envío de un código de un solo uso | Una plantilla de autenticación |
Pasos para enviar
- Cree la plantilla con nombre, idioma, categoría y valores de ejemplo para las variables, y envíela a Meta para su revisión.
- Espere a que el estado de la plantilla sea aprobado.
- Llame al endpoint de envío con el destinatario, el nombre de la plantilla, el idioma y los valores de las variables.
- Guarde el ID devuelto y siga SENT, DELIVERED, READ o FAILED en su webhook.
Ejemplo: enviar una plantilla
En OmniChannels.ai, todos los mensajes de WhatsApp pasan por POST https://api.broadnet.me/whatsapp/message/sendbulk como multipart form data con un token Bearer. Indique messageType como TEMPLATE y pase destinationNo, templateName, templateLanguage y bodyTemplateVariables. La llamada devuelve un batchId, y los estados por destinatario llegan a su webhook o desde GET /whatsapp/message/bulk-insights.