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 "quick_reply".
​
text
string
required
Contenido del mensaje enviado al cliente.
​
userId
string
required
Identificador único del usuario que recibirá el mensaje.
​
title
string
Título del mensaje. Opcional, máximo 20 caracteres.
​
quick_replies
array
required
Array de botones de respuesta rápida. Mínimo 1, máximo 3 botones.

​
Restricciones

  • Respuestas Rápidas: Mínimo 1, máximo 3 botones
  • Título: Opcional, máximo 20 caracteres
  • Título del Botón: Máximo 20 caracteres, no puede estar vacío, debe ser único, sin emojis ni markdown

​
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": "quick_reply",
    "text": "¿Te gustaría continuar?",
    "title": "Pregunta",
    "quick_replies": [
      {
        "title": "Sí"
      },
      {
        "title": "No"
      },
      {
        "title": "Tal vez"
      }
    ],
    "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"
}

​
Casos de Uso

  • Preguntas de sí/no
  • Confirmaciones simples
  • Opciones binarias
  • Respuestas rápidas a preguntas frecuentes