Envío de mensajes

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": "Hola, este es un mensaje de texto",
    "userId": "PHONE_NUMBER_OR_BSUID"
  }'

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

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

POST

bots

{botId}

messages

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": "Hola, este es un mensaje de texto",
    "userId": "PHONE_NUMBER_OR_BSUID"
  }'

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

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

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": "Hola, este es un mensaje de texto",
    "userId": "PHONE_NUMBER_OR_BSUID"
  }'

Identificación del destinatario

El campo userId acepta dos formatos:

Número de teléfono: formato E.164 sin el signo + (ej: 593999999999).
BSUID (Business-Scoped User ID): un identificador con formato CC.alfanumérico (ej: US.13491208655302741918).

¿Qué es un BSUID? Cuando un usuario activa la protección de número en WhatsApp, Meta deja de exponer su número de teléfono real y en su lugar identifica al usuario mediante un BSUID único por negocio. Si tu integración ya conoce el BSUID de un usuario —por ejemplo, porque lo recibiste en un webhook entrante—, puedes usarlo directamente en userId para enviarle un mensaje sin necesitar su número de teléfono.

Con número de teléfono
Con BSUID

cURL

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": "Hola, este es un mensaje de texto",
    "userId": "593999999999"
  }'

cURL

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": "Hola, este es un mensaje de texto",
    "userId": "US.13491208655302741918"
  }'

Formato inválido: si userId no corresponde a un número de teléfono ni a un BSUID con formato válido, la API responde con un error 400 (INVALID_USER_ID).

Casos de Uso

Notificaciones simples
Confirmaciones
Mensajes informativos
Respuestas automáticas básicas
Responder a un usuario que activó la privacidad de número en WhatsApp, usando el BSUID recibido en un webhook entrante
Enviar mensajes proactivos a usuarios identificados exclusivamente por BSUID, sin necesidad de almacenar ni conocer su número de teléfono real

Ejemplos

Responder a un mensaje entrante identificado por BSUID

Cuando un usuario con privacidad de número activada te escribe, el webhook entrante trae su BSUID en vez de un teléfono. Usa ese mismo valor para responderle:

cURL

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": "¡Gracias por escribirnos! En breve un agente te atenderá.",
    "userId": "US.13491208655302741918"
  }'

Enviar una imagen a un destinatario identificado por BSUID

El resto de tipos de mensaje (imagen, documento, ubicación, etc.) funcionan igual: solo cambia el valor de userId por el BSUID del destinatario.

cURL

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": "image",
    "mediaUrl": "https://example.com/catalogo.jpg",
    "userId": "US.13491208655302741918"
  }'

Autorizaciones

Authorization

string

header

requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

botId

string

requerido

The unique identifier of the bot

Cuerpo

application/json

Message payload. The structure varies based on the message type.

type

enum<string>

requerido

Type of message to send

Opciones disponibles:

text

Ejemplo:

"text"

userId

string

requerido

Unique identifier of the user receiving the message. Accepts either a phone number in E.164 format without the leading '+' (e.g. '593999999999') or a BSUID (Business-Scoped User ID, e.g. 'US.13491208655302741918') for users who have enabled phone number privacy in WhatsApp.

Ejemplo:

"593999999999"

text

string

requerido

Text content of the message

Ejemplo:

"Hello, this is a text message"

botId

string

Unique identifier of the bot sending the message

Ejemplo:

"BOT_ID"

Respuesta

Message sent successfully

success

boolean

Ejemplo:

true

messageId

string

Ejemplo:

"msg_123456789"

Introducción

Mensaje de Texto

⌘I

API reference

Campañas

Conversaciones

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Gestión de Memoria

Envío de mensajes

Identificación del destinatario

Casos de Uso

Ejemplos

Responder a un mensaje entrante identificado por BSUID

Enviar una imagen a un destinatario identificado por BSUID

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

​Identificación del destinatario

​Casos de Uso

​Ejemplos

​Responder a un mensaje entrante identificado por BSUID

​Enviar una imagen a un destinatario identificado por BSUID

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Identificación del destinatario

Casos de Uso

Ejemplos

Responder a un mensaje entrante identificado por BSUID

Enviar una imagen a un destinatario identificado por BSUID