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 "text".
​
text
string
required
Contenido del mensaje mostrado al usuario.
​
userId
string
required
Identificador único del usuario que recibirá el mensaje.
​
buttons
object
required
Configuración de los botones interactivos.

​
Restricciones

  • Opciones: Mínimo 1, máximo 10 opciones por mensaje
  • Título de Opción: Máximo 24 caracteres
  • Descripción de Opción: Máximo 72 caracteres
  • Texto del Botón: Por defecto es “Opciones” si no se especifica

​
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": "text",
    "text": "Por favor selecciona una opción",
    "userId": "USER_ID",
    "buttons": {
      "title": "Elige una opción",
      "buttonText": {
        "type": "text",
        "text": "Ver Opciones"
      },
      "options": [
        {
          "title": "Opción 1",
          "description": "Esta es la primera opción",
          "payload": "OPCION_1"
        },
        {
          "title": "Opción 2",
          "description": "Esta es la segunda opción",
          "payload": "OPCION_2"
        },
        {
          "title": "Opción 3",
          "description": "Esta es la tercera opción",
          "payload": "OPCION_3"
        }
      ]
    }
  }'

​
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

  • Crear menús de navegación
  • Proporcionar opciones de selección múltiple
  • Guiar a los usuarios a través de un flujo
  • Recopilar respuestas estructuradas