Áudio

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"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

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"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

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"
  }'

Formatos e Limites de Tamanho

Tipo de Mídia	Formatos Suportados	Limite de Tamanho
Áudio	`audio/aac`, `audio/mp4`, `audio/mpeg`, `audio/amr`, `audio/ogg` (somente codec opus)	16MB

Requisitos de URL

A URL deve ser acessível publicamente via HTTPS, não deve exigir autenticação e deve apontar diretamente para o arquivo (e não para uma página HTML).

Erros Comuns

INVALID_MEDIA_URL - A URL do áudio é inválida ou inacessível
MEDIA_TOO_LARGE - O arquivo de áudio excede o limite de 16MB
UNSUPPORTED_MEDIA_TYPE - O formato de áudio não é suportado

Casos de Uso

Enviar mensagens de voz
Compartilhar músicas ou podcasts
Enviar notificações em áudio
Compartilhar gravações

Autorizações

Authorization

string

header

obrigatório

Basic authentication using Base64 encoded clientId:clientSecret

Parâmetros de caminho

botId

string

obrigatório

The unique identifier of the bot

Corpo

application/json

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

type

enum<string>

obrigatório

Type of message to send

Opções disponíveis:

text

Exemplo:

"text"

userId

string

obrigatório

Unique identifier of the user receiving the message. Accepts either a phone number in E.164 format without the leading '+' (e.g. '593999999999') or a BSUID (Business-Scoped User ID, e.g. 'US.13491208655302741918') for users who have enabled phone number privacy in WhatsApp.

Exemplo:

"593999999999"

text

string

obrigatório

Text content of the message

Exemplo:

"Hello, this is a text message"

botId

string

Unique identifier of the bot sending the message

Exemplo:

"BOT_ID"

Resposta

Message sent successfully

success

boolean

Exemplo:

true

messageId

string

Exemplo:

"msg_123456789"

Imagem

Vídeo

⌘I

Referência de API

Enviar Mensagens

Campanhas

Conversações

Métricas

Usuários

Recursos

Widget

Datum

Painel de Atendimento Externo

Gestão de Memória

Formatos e Limites de Tamanho

Requisitos de URL

Erros Comuns

Casos de Uso

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Formatos e Limites de Tamanho

​Requisitos de URL

​Erros Comuns

​Casos de Uso

Autorizações

Parâmetros de caminho

Corpo

Resposta

Formatos e Limites de Tamanho

Requisitos de URL

Erros Comuns

Casos de Uso