Skip to main content
Se utiliza para enviar mensajes externos (por ejemplo, desde sistemas o flujos automatizados) hacia una conversación activa.

​
Enviar un mensaje

​
Endpoint

POST https://api.jelou.ai/v1/rooms/{roomId}/message

​
Parámetros de ruta

​
roomId
string
required
Identificador único de la sala de conversación.

​
Cuerpo de la solicitud

​
senderId
string
required
Identificador del emisor del mensaje.
Valores posibles: Bot.id, Bot.socketId, Operator.id o un uuid genérico.
​
messages
array
required
Lista de mensajes a enviar.
​
messages[]
object
required
Objeto que representa un mensaje individual.
​
messages[].id
string
required
Identificador único del mensaje (uuid).
​
messages[].type
string
required
Tipo de mensaje a enviar.
Ejemplos comunes: "TEXT", "IMAGE", "VIDEO", "DOCUMENT".
​
messages[].text
string
Contenido de texto del mensaje. Obligatorio cuando el tipo es "TEXT".
​
messages[].mediaUrl
string
URL del archivo multimedia a enviar. Obligatorio para mensajes no textuales.

​
Respuestas

  • 200 – OK: Mensaje enviado correctamente.
  • 401 – Unauthorized: Credenciales inválidas o faltantes.

​
Ejemplo de solicitud

cURL
curl --request POST \
  --url https://api.jelou.ai/v1/rooms/{roomId}/message \
  --header 'Authorization: Basic <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "senderId": "<ID>",
    "messages": [
      {
        "id": "<uuid>",
        "type": "TEXT",
        "text": "Hola 👋, este es un mensaje de prueba."
      }
    ]
  }'
Puedes consultar la lista completa de tipos de mensajes disponibles en la documentación de tipos de mensajes.