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 "file".
​
mediaUrl
string
required
URL pública HTTPS del archivo a enviar.
​
text
string
Mensaje opcional que acompaña el archivo.
​
filename
string
Nombre del archivo. Si no se proporciona, el nombre se inferirá de la URL.
​
userId
string
required
Identificador único del usuario que recibirá el mensaje.

​
Formatos y Límites de Tamaño

Tipo de MedioFormatos SoportadosLímite de Tamaño
Archivotext/plain, application/pdf, formatos Office (.doc, .docx, .ppt, .pptx, .xls, .xlsx)100MB

​
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).

​
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": "file",
    "mediaUrl": "https://example.com/documento.pdf",
    "text": "Por favor revisa este documento",
    "filename": "documento.pdf",
    "userId": "USER_ID"
  }'

​
Respuesta

​
success
boolean
Indica si el mensaje fue enviado exitosamente.
​
messageId
string
Identificador único del mensaje enviado.

​
Ejemplo de Respuesta

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

​
Errores Comunes

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

​
Casos de Uso

  • Enviar facturas o recibos
  • Compartir documentos legales
  • Enviar reportes o análisis
  • Compartir presentaciones