Video

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": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "text": "Check out this video",
    "userId": "USER_ID"
  }'

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

POST

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": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "text": "Check out this video",
    "userId": "USER_ID"
  }'

{
  "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": "video",
    "mediaUrl": "https://example.com/video.mp4",
    "text": "Check out this video",
    "userId": "USER_ID"
  }'

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

Path parameters

string

required

Unique identifier of the bot sending the message.

Body parameters

string

required

Message type. Must be "video".

string

required

Message recipient. Accepts a phone number in E.164 format without the leading + (e.g. 593999999999) or a BSUID (e.g. US.13491208655302741918) for users who have enabled phone number privacy in WhatsApp. See Identifying the recipient.

string

required

Public (HTTPS) URL of the video file. Supported formats and maximum size depend on the channel (see the formats and limits by channel table).

string

Optional text shown alongside the media. WhatsApp only: Instagram and Messenger do not support text with a video; to send it, use a separate text message.

Response

boolean

true if the message was sent successfully.

string

Identifier of the sent message.

Formats and size limits by channel

Channel	Supported formats	Size limit
WhatsApp	`video/mp4`, `video/3gp`	16MB
Instagram	`video/mp4`, `video/ogg`, `video/webm`, `video/quicktime` (.mov)	25MB
Messenger	`video/mp4`, `video/ogg`, `video/webm`, `video/quicktime` (.mov)	25MB

URL Requirements

The URL must be publicly accessible via HTTPS, must not require authentication, and must point directly to the file (not to an HTML page).

Common Errors

INVALID_MEDIA_URL - The video URL is invalid or inaccessible
MEDIA_TOO_LARGE - The video file exceeds the channel’s size limit
UNSUPPORTED_MEDIA_TYPE - The video format is not supported

Use Cases

Sharing video tutorials
Sending product demonstrations
Sharing promotional videos
Sending educational content

API reference

Send Messages

Campaigns

Conversations

Tags

Metrics

Users

Resources

Widget

Datum

External Support Panel

Custom Channel

Memory Management

Path parameters

Body parameters

Response

Formats and size limits by channel

URL Requirements

Common Errors

Use Cases

​Path parameters

​Body parameters

​Response

​Formats and size limits by channel

​URL Requirements

​Common Errors

​Use Cases

Path parameters

Body parameters

Response

Formats and size limits by channel

URL Requirements

Common Errors

Use Cases