Endpoint
POST https://api.jelou.ai/v1/bots/{botId}/messages
Parámetros de Ruta
Identificador único del bot que envía el mensaje.
Cuerpo de la Solicitud
Identificador único del usuario que recibirá el mensaje.
Configuración del botón de flujo. Show Parámetros del Flujo
Identificador único del flujo a abrir.
Texto de llamada a la acción mostrado en el botón del flujo.
parameters.flow_action_payload
Datos de carga útil para la acción del flujo. Este objeto puede contener cualquier dato que quieras pasar al flujo. {
"screen" : "RECOMMEND"
}
Modo del flujo. Debe ser "draft" o "published".
Acción a realizar. Actualmente solo se soporta "navigate".
parameters.flow_message_version
Versión del mensaje de flujo. Usa "3" para la versión más reciente.
Ejemplos de Solicitud
curl --request POST \
--url https://api.jelou.ai/v1/bots/BOT_ID/messages \
--header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
--header 'Content-Type: application/json' \
--data '{
"type": "flow",
"title": "Hola",
"text": "Completa este flujo para comenzar",
"caption": "Jelou",
"userId": "USER_ID",
"parameters": {
"flow_id": "FLOW_ID",
"flow_cta": "Iniciar Flujo",
"flow_name": "Flujo de Bienvenida",
"flow_action_payload": {
"screen": "RECOMMEND"
},
"mode": "draft",
"flow_action": "navigate",
"flow_message_version": "3"
}
}'
Respuesta
Indica si el mensaje fue enviado exitosamente.
Identificador único del mensaje enviado.
Ejemplo de Respuesta
{
"success" : true ,
"messageId" : "msg_123456789"
}
Mejores Prácticas
Flujos Complejos: Usa botones de flujo para interacciones complejas de múltiples pasos que requieren entradas de formulario, selecciones o experiencias guiadas. Los flujos proporcionan una experiencia nativa de WhatsApp sin salir del chat.
Casos de Uso
Formularios de registro o encuestas
Procesos de compra multi-paso
Configuraciones guiadas
Experiencias interactivas complejas