Skip to main content

​
Endpoint

POST https://api.jelou.ai/v1/bots/{botId}/messages

​
Parámetros de Ruta

​
botId
string
required
Identificador único del bot que envía el mensaje.

​
Cuerpo de la Solicitud

​
type
string
required
Debe ser "text".
​
text
string
required
Contenido del texto del mensaje.
​
userId
string
required
Identificador único del usuario que recibirá el mensaje.
​
botId
string
Identificador único del bot. Opcional si se incluye en la ruta.

​
Ejemplos de Solicitud

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": "USER_ID"
  }'

​
Respuesta

​
success
boolean
Indica si el mensaje fue enviado exitosamente.
​
messageId
string
Identificador único del mensaje enviado. Usa este ID para rastrear el estado del mensaje.

​
Ejemplo de Respuesta

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

​
Errores Comunes

​
error
string
Código de error que indica el tipo de error ocurrido.
​
message
string
Mensaje de error legible que describe qué salió mal.

​
Códigos de Error

  • INVALID_REQUEST - El cuerpo de la solicitud está mal formado o faltan campos requeridos
  • UNAUTHORIZED - Credenciales de autenticación inválidas
  • BOT_NOT_FOUND - El ID del bot especificado no existe
  • USER_NOT_FOUND - El ID del usuario especificado no existe

​
Casos de Uso

  • Notificaciones simples
  • Confirmaciones
  • Mensajes informativos
  • Respuestas automáticas básicas