Skip to main content
POST
/
v1
/
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": "image",
    "mediaUrl": "https://example.com/imagen.jpg",
    "text": "Mira esta imagen",
    "userId": "USER_ID"
  }'
{
  "success": true,
  "messageId": "msg_123456789"
}
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/imagen.jpg",
    "text": "Mira esta imagen",
    "userId": "USER_ID"
  }'

Formatos y Límites de Tamaño

Tipo de MedioFormatos SoportadosLímite de Tamaño
Imagenimage/jpeg, image/png5MB

Requisitos de URL

La URL debe ser públicamente accesible vía HTTPS, no debe requerir autenticación, y debe apuntar directamente al archivo (no a una página HTML).

Errores Comunes

  • INVALID_MEDIA_URL - La URL de la imagen es inválida o inaccesible
  • MEDIA_TOO_LARGE - La imagen excede el límite de 5MB
  • UNSUPPORTED_MEDIA_TYPE - El formato de imagen no es soportado

Casos de Uso

  • Compartir fotos de productos
  • Enviar menús visuales
  • Mostrar instrucciones visuales
  • Compartir capturas de pantalla

Authorizations

Authorization
string
header
required

Basic authentication using Base64 encoded clientId:clientSecret

Path Parameters

botId
string
required

The unique identifier of the bot

Body

application/json

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

type
enum<string>
required

Type of message to send

Available options:
text
Example:

"text"

userId
string
required

Unique identifier of the user receiving the message

Example:

"USER_ID"

text
string
required

Text content of the message

Example:

"Hello, this is a text message"

botId
string

Unique identifier of the bot sending the message

Example:

"BOT_ID"

Response

Message sent successfully

success
boolean
Example:

true

messageId
string
Example:

"msg_123456789"