Message with Options

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": "Please select an option",
    "userId": "USER_ID",
    "title": "Choose an option",
    "buttonText": {
      "type": "text",
      "text": "View Options"
    },
    "options": [
      {
        "id": "option_1",
        "title": "Option 1",
        "description": "This is the first option"
      },
      {
        "id": "option_2",
        "title": "Option 2",
        "description": "This is the second option"
      },
      {
        "id": "option_3",
        "title": "Option 3",
        "description": "This is the third option"
      }
    ]
  }'

​

Payload Structure

• title (optional): Title displayed above the option list.
• buttonText (optional): Button object that opens the list. Supports the fields:
  • type: button content type (defaults to "text").
  • text: visible button label (defaults to "Options").
• options[] (required): List of selectable options. Each option supports:
  • id (optional): Stable identifier returned when the user selects the option. If omitted, a UUID is generated automatically.
  • title (required): Visible option text.
  • description (optional): Secondary text shown below the title.

​

Restrictions

• Options: Minimum 1, maximum 10 options per message
• Option Title: Maximum 24 characters
• Option Description: Maximum 72 characters
• Button Text (buttonText.text): Defaults to “Options” if not specified

​

Use Cases

• Creating navigation menus
• Providing multiple-choice options
• Guiding users through a flow
• Collecting structured responses