Saltar al contenido principal
POST
/
v1
/
bots
/
{botId}
/
messages
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"
      }
    ]
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Autorizaciones

​
Authorization
string
header
requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

​
botId
string
requerido

The unique identifier of the bot

Cuerpo

application/json

Message payload. The structure varies based on the message type.

​
type
enum<string>
requerido

Type of message to send

Opciones disponibles:
text
Ejemplo:

"text"

​
userId
string
requerido

Unique identifier of the user receiving the message

Ejemplo:

"USER_ID"

​
text
string
requerido

Text content of the message

Ejemplo:

"Hello, this is a text message"

​
botId
string

Unique identifier of the bot sending the message

Ejemplo:

"BOT_ID"

Respuesta

Message sent successfully

​
success
boolean
Ejemplo:

true

​
messageId
string
Ejemplo:

"msg_123456789"