Skip to main content

​
Bienvenido

La API de Jelou te permite enviar mensajes a usuarios a través de WhatsApp. Esta API soporta múltiples tipos de mensajes incluyendo texto, imágenes, audio, video, archivos, stickers, ubicación, contactos y elementos interactivos como botones y respuestas rápidas.

​
Endpoint Base

Todos los mensajes se envían a través del siguiente endpoint: 
POST https://api.jelou.ai/v1/bots/{botId}/messages

​
Requisitos de Sesión

Esta API solo puede enviar mensajes cuando existe una sesión activa: dispones de 24 horas desde el último mensaje del usuario para responder con cualquier tipo de mensaje. Si la sesión expiró, debes enviar plantillas preaprobadas mediante nuestra plataforma o API de Campañas para reabrir la conversación antes de continuar con mensajes libres.

​
Campos Comunes

Todos los tipos de mensajes comparten estos campos comunes:
​
type
string
required
Tipo de mensaje a enviar. Ver tipos disponibles en las siguientes páginas.
​
userId
string
required
Identificador único del usuario que recibirá el mensaje.
​
botId
string
Identificador único del bot que envía el mensaje. Puede incluirse en el cuerpo o inferirse del parámetro de ruta.

​
Tipos de Mensajes Disponibles

La API de Jelou soporta los siguientes tipos de mensajes:

Mensaje de Texto

Mensajes de texto simples y con botones interactivos

Mensaje con Opciones

Texto con botones de selección múltiple

Respuestas Rápidas

Mensajes con botones de respuesta rápida

Mensaje con Imagen

Envía imágenes con texto opcional

Mensaje de Audio

Envía archivos de audio

Mensaje con Video

Envía videos con texto opcional

Mensaje con Archivo

Envía documentos y archivos

Mensaje con Sticker

Envía stickers en formato WebP

Mensaje con Ubicación

Comparte coordenadas específicas

Mensaje de Contacto

Comparte tarjetas de contacto (vCard)

Solicitud de Ubicación

Solicita la ubicación del usuario

Botón URL

Botón que abre una URL

Botón de Flujo

Botón que abre un WhatsApp Flow

Botón de Llamada

Botón que inicia una llamada de voz

​
Respuestas

​
Respuesta Exitosa

{
  "success": true,
  "messageId": "msg_123456789"
}

​
Respuestas de Error

{
  "error": "INVALID_REQUEST",
  "message": "Formato de mensaje inválido"
}

​
Códigos de Estado HTTP

  • 200 - Éxito
  • 400 - Solicitud incorrecta (formato de mensaje inválido o campos requeridos faltantes)
  • 401 - No autorizado (sesión inexistente o expirada)
  • 404 - No encontrado (bot o usuario no encontrado)
  • 500 - Error interno del servidor

​
Próximos Pasos

Explora los diferentes tipos de mensajes disponibles en las siguientes páginas. Cada página incluye ejemplos de solicitud completos y documentación detallada de los parámetros.