Skip to main content

Descripción

Este endpoint permite enviar mensajes a un usuario dentro de una sala de conversación, como texto o contenido multimedia.
Está diseñado principalmente para el canal de WhatsApp y respeta las restricciones operativas del canal.

Enviar 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

messages
array
required
Lista de mensajes que se enviarán al usuario.
messages[].type
string
required
Tipo de mensaje a enviar.
Valores comunes: "text", "image", "video", "document".
messages[].text
string
Texto del mensaje. Obligatorio cuando el tipo es "text".
messages[].mediaUrl
string
URL del archivo multimedia a enviar. Obligatorio cuando el tipo no es "text".
senderId
string
required
Identificador del usuario o referencia desde la cual se envía el mensaje.

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 <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "senderId": "agent-12345",
    "messages": [
      {
        "type": "text",
        "text": "Hola 👋, este es un mensaje de prueba."
      }
    ]
  }'

Ejemplo de respuesta

{
  "status": "success",
  "message": "Mensaje enviado correctamente"
}
Este endpoint solo entregará mensajes a usuarios que hayan escrito previamente al bot en las últimas 24 horas, de acuerdo con las políticas de WhatsApp.