Audio

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": "audio",
    "mediaUrl": "https://example.com/audio.mp3",
    "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": "audio",
    "mediaUrl": "https://example.com/audio.mp3",
    "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": "audio",
    "mediaUrl": "https://example.com/audio.mp3",
    "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 "audio".

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 audio file. Supported formats and maximum size depend on the channel (see the formats and limits by channel table).

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	`audio/aac`, `audio/mp4`, `audio/mpeg`, `audio/amr`, `audio/ogg` (opus codec only)	16MB
Instagram	`audio/aac`, `audio/mp4` (.m4a, .mp4), `audio/wav`	25MB
Messenger	`audio/aac`, `audio/mp4` (.m4a, .mp4), `audio/wav`	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 audio URL is invalid or inaccessible
MEDIA_TOO_LARGE - The audio file exceeds the channel’s size limit
UNSUPPORTED_MEDIA_TYPE - The audio format is not supported

Use Cases

Sending voice messages
Sharing music or podcasts
Sending audio notifications
Sharing recordings

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