Skip to main content
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": "flow",
    "title": "Hello",
    "text": "Complete this flow to get started",
    "caption": "Jelou",
    "userId": "USER_ID",
    "parameters": {
      "flow_id": "FLOW_ID",
      "flow_cta": "Start Flow",
      "flow_name": "Welcome Flow",
      "flow_action_payload": {
        "screen": "RECOMMEND"
      },
      "mode": "draft",
      "flow_action": "navigate",
      "flow_message_version": "3"
    }
  }'

{
  "success": true,
  "messageId": "msg_123456789"
}
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": "flow",
    "title": "Hello",
    "text": "Complete this flow to get started",
    "caption": "Jelou",
    "userId": "USER_ID",
    "parameters": {
      "flow_id": "FLOW_ID",
      "flow_cta": "Start Flow",
      "flow_name": "Welcome Flow",
      "flow_action_payload": {
        "screen": "RECOMMEND"
      },
      "mode": "draft",
      "flow_action": "navigate",
      "flow_message_version": "3"
    }
  }'

​
Best Practices

Complex Flows: Use flow buttons for complex multi-step interactions that require form inputs, selections, or guided experiences. Flows provide a native WhatsApp experience without leaving the chat.

​
Use Cases

  • Registration forms or surveys
  • Multi-step purchase processes
  • Guided configurations
  • Complex interactive experiences

Authorizations

​
Authorization
string
header
required

Basic authentication using Base64 encoded clientId:clientSecret

Path Parameters

​
botId
string
required

The unique identifier of the bot

Body

application/json

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

​
type
enum<string>
required

Type of message to send

Available options:
text
Example:

"text"

​
userId
string
required

Unique identifier of the user receiving the message

Example:

"USER_ID"

​
text
string
required

Text content of the message

Example:

"Hello, this is a text message"

​
botId
string

Unique identifier of the bot sending the message

Example:

"BOT_ID"

Response

Message sent successfully

​
success
boolean
Example:

true

​
messageId
string
Example:

"msg_123456789"