Envío de Mensajes por WhatsApp
Permite enviar mensajes de texto o archivos multimedia a cualquier número de WhatsApp a través de la sesión activa del tenant.
[!NOTE] Creación Automática de Contactos y Conversaciones: Si el número de destino (
to) no existe registrado previamente en Subflow, el endpoint creará el contacto y la conversación de forma automática en segundo plano antes de despachar el mensaje.
Endpoint de Envío
- Método:
POST - Ruta:
/api/v1/integrations/:integrationKey/messages - Cabeceras:
Authorization: Bearer sf_int_...Content-Type: application/json
Parámetros del Cuerpo (JSON Body)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
to |
string |
Sí | Número de destino en formato internacional E.164 (debe comenzar con + y el código de país, ej. +573001234567). |
text |
string |
Condicional | Texto del mensaje. Si el mensaje es multimedia, actúa como pie de foto (caption). |
contentType |
string |
No | Tipo de mensaje: 'text' (por defecto), 'image', 'video', 'audio', 'document'. |
mediaUrl |
string |
Condicional | URL pública y accesible del archivo multimedia (requerido si contentType no es 'text'). |
mimeType |
string |
No | Tipo MIME del archivo (ej. image/png, application/pdf, audio/ogg). |
fileName |
string |
No | Nombre del archivo con extensión (especialmente útil para document). |
scheduledAt |
string |
No | Fecha/hora ISO 8601 a futuro para envío programado (ej. 2026-09-01T15:00:00.000Z). |
Ejemplo 1: Mensaje de Texto Simple
curl -X POST "https://api.omniflou.com/api/v1/integrations/agendaconmigo/messages" \
-H "Authorization: Bearer sf_int_agendaconmigo_your_token" \
-H "Content-Type: application/json" \
-d '{
"to": "+573001234567",
"text": "Hola Carlos, te confirmamos que tu cita médica está agendada para mañana a las 10:00 AM."
}'Ejemplo 2: Envío de Factura en PDF
curl -X POST "https://api.omniflou.com/api/v1/integrations/agendaconmigo/messages" \
-H "Authorization: Bearer sf_int_agendaconmigo_your_token" \
-H "Content-Type: application/json" \
-d '{
"to": "+573001234567",
"contentType": "document",
"mediaUrl": "https://tuservidor.com/facturas/FAC-9842.pdf",
"fileName": "Factura_FAC-9842.pdf",
"text": "Adjunto enviamos el comprobante fiscal de tu servicio."
}'Respuesta Exitosa (200 OK)
{
"success": true,
"enqueued": true,
"messageId": "6a4ffc99e5956fd8d285c5c0",
"contactId": "6a4ffc99e5956fd8d285c5bb",
"conversationId": "6a4ffc99e5956fd8d285c5be"
}