Pular para o conteúdo principal
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": "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"
  }'

​
Formatos e Limites de Tamanho

Tipo de MídiaFormatos SuportadosLimite de Tamanho
Áudioaudio/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

Exemplo:

"USER_ID"

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