Mensaje con Opciones

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",
    "title": "Elige una opción",
    "buttonText": {
      "type": "text",
      "text": "Ver Opciones"
    },
    "options": [
      {
        "id": "option_1",
        "title": "Opción 1",
        "description": "Esta es la primera opción"
      },
      {
        "id": "option_2",
        "title": "Opción 2",
        "description": "Esta es la segunda opción"
      },
      {
        "id": "option_3",
        "title": "Opción 3",
        "description": "Esta es la tercera opción"
      }
    ]
  }'

​

Estructura del Payload

• title (opcional): Título mostrado encima de la lista de opciones.
• buttonText (opcional): Objeto del botón que abre la lista. Admite los campos:
  • type: tipo del contenido del botón (por defecto "text").
  • text: etiqueta visible del botón (por defecto "Opciones").
• options[] (requerido): Lista de opciones seleccionables. Cada opción admite:
  • id (opcional): Identificador estable que se devuelve cuando el usuario selecciona la opción. Si se omite, se genera automáticamente un UUID.
  • title (requerido): Texto visible de la opción.
  • description (opcional): Texto secundario debajo del título.

​

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 (buttonText.text): Por defecto es “Opciones” si no se especifica

​

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