Skip to main content

​
Bienvenidos

La API de Jelou te permite enviar mensajes a usuarios a través de WhatsApp. Esta API admite 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.

​
URL Base

Todas las solicitudes a la API deben realizarse a: 
https://api.jelou.ai/v1

​
Autenticación

Todos los endpoints requieren Autenticación Básica (Basic Auth) usando tu clientId y clientSecret.

​
Obtén tus credenciales

Cuando registras la API de Jelou, recibes:
  • Client ID: Tu identificador único de cliente.
  • Client Secret: Tu clave secreta para autenticación

​
Cómo autenticarte

Para cualquier endpoint, debes incluir el siguiente encabezado: 
Authorization: Basic <Base64 encoded clientId:clientSecret>

​
Ejemplos

Si tu clientId es your_client_id y tu clientSecret es your_client_secret, debes:
  1. Unirlos con dos puntos: your_client_id:your_client_secret
  2. Codificarlo en Base64: eW91cl9jbGllbnRfaWQ6eW91cl9jbGllbnRfc2VjcmV0
  3. Incluirlo en el header: Authorization: Basic eW91cl9jbGllbnRfaWQ6eW91cl9jbGllbnRfc2VjcmV0

​
cURL de ejemplo

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": "text",
    "text": "Hello World",
    "userId": "USER_ID"
  }'

​
Tipos de mensajes

La API de Jelou permite los siguientes tipos de mensajes:

Mensajes de Texto

Mensajes de texto simples y texto con botones interactivos

Mensajes Multimedia

Imágenes, audio, video, archivos y stickers

Mensajes Interactivos

Respuestas rápidas, solicitudes de ubicación y botones de acción

Mensajes Especiales

Ubicación, contactos y mensajes de flujo

​
Requisitos Multimedia

Cuando envías archivos multimedia (imágenes, audio, video, archivos, stickers), asegúrate de que tus URLs cumplan con lo siguiente:
Pautas clave:
  • Las URLs deben ser accesibles públicamente mediante HTTPS
  • No debe requerirse autenticación (sin tokens, cookies, etc.)
  • Las URLs no deben expirar rápidamente (al menos hasta que se confirme la entrega del mensaje)
  • Las URLs deben apuntar directamente al archivo (no a una página HTML)
  • Los archivos deben estar en formatos compatibles y respetar los límites de tamaño

​
Medios compatibles y límites

Tipo de medioFormatos compatiblesLímite
Audioaudio/aac, audio/mp4, audio/mpeg, audio/amr, audio/ogg (solo códec opus)16MB
Archivotext/plain, application/pdf, application/vnd.ms-powerpoint, application/msword, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.*100MB
Imageimage/jpeg, image/png5MB
Videovideo/mp4, video/3gp16MB
Stickerimage/webp100KB

​
Límites de uso

La API tiene límites de uso para evitar abusos. Si necesitas conocer los límites de tu cuenta, contacta a soporte.

​
Manejo de errores

La API utiliza códigos de estado HTTP estándar:
  • 200 - Éxito
  • 400 - Solicitud inválida (formato incorrecto o campos incompletos)
  • 401 - No autorizado (credenciales inválidas)
  • 404 - No encontrado (bot o usuario no existe)
  • 500 - Error interno del servidor
Todos los errores retornan un objeto JSON con un código error y un message: 
{
  "error": "INVALID_REQUEST",
  "message": "Invalid message format"
}

​
Soporte

Escríbenos

Contacta a nuestro equipo de soporte para recibir asistencia