Enviar Áudio

curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "audio": "https://exemplo.com/audio.ogg",
    "ptt": true
  }'

curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "audio": "https://exemplo.com/musica.mp3",
    "ptt": false
  }'

// Mensagem de voz
const message = await client.messages.sendAudio(sessionId, {
  to: '5511999999999',
  audio: 'https://exemplo.com/audio.ogg',
  ptt: true,
});

// Arquivo de áudio
const message = await client.messages.sendAudio(sessionId, {
  to: '5511999999999',
  audio: 'https://exemplo.com/musica.mp3',
  ptt: false,
});

# Mensagem de voz
message = client.messages.send_audio(
    session_id,
    to='5511999999999',
    audio='https://exemplo.com/audio.ogg',
    ptt=True
)

# Arquivo de áudio  
message = client.messages.send_audio(
    session_id,
    to='5511999999999',
    audio='https://exemplo.com/musica.mp3',
    ptt=False
)

{
  "messageId": "3EB0ABC123DEF456789GHI",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

POST

api

messages

audio

curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "audio": "https://exemplo.com/audio.ogg",
    "ptt": true
  }'

curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "audio": "https://exemplo.com/musica.mp3",
    "ptt": false
  }'

// Mensagem de voz
const message = await client.messages.sendAudio(sessionId, {
  to: '5511999999999',
  audio: 'https://exemplo.com/audio.ogg',
  ptt: true,
});

// Arquivo de áudio
const message = await client.messages.sendAudio(sessionId, {
  to: '5511999999999',
  audio: 'https://exemplo.com/musica.mp3',
  ptt: false,
});

# Mensagem de voz
message = client.messages.send_audio(
    session_id,
    to='5511999999999',
    audio='https://exemplo.com/audio.ogg',
    ptt=True
)

# Arquivo de áudio  
message = client.messages.send_audio(
    session_id,
    to='5511999999999',
    audio='https://exemplo.com/musica.mp3',
    ptt=False
)

{
  "messageId": "3EB0ABC123DEF456789GHI",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Envia um áudio para um contato ou grupo. Por padrão, envia como mensagem de voz (PTT - Push To Talk).

Request Body

sessionId

string

required

ID da sessão que enviará a mensagem.

string

required

Destinatário (número com DDI ou JID).

audio

string

required

URL do áudio ou conteúdo em base64.Formatos suportados: OGG/Opus (recomendado), MP3, M4A, WAVTamanho máximo: 16 MB

ptt

boolean

default:"true"

Se true, envia como mensagem de voz (bolinha azul). Se false, envia como arquivo de áudio.

quoted

object

Responder a uma mensagem específica.

curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "audio": "https://exemplo.com/audio.ogg",
    "ptt": true
  }'

curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "audio": "https://exemplo.com/musica.mp3",
    "ptt": false
  }'

// Mensagem de voz
const message = await client.messages.sendAudio(sessionId, {
  to: '5511999999999',
  audio: 'https://exemplo.com/audio.ogg',
  ptt: true,
});

// Arquivo de áudio
const message = await client.messages.sendAudio(sessionId, {
  to: '5511999999999',
  audio: 'https://exemplo.com/musica.mp3',
  ptt: false,
});

# Mensagem de voz
message = client.messages.send_audio(
    session_id,
    to='5511999999999',
    audio='https://exemplo.com/audio.ogg',
    ptt=True
)

# Arquivo de áudio  
message = client.messages.send_audio(
    session_id,
    to='5511999999999',
    audio='https://exemplo.com/musica.mp3',
    ptt=False
)

{
  "messageId": "3EB0ABC123DEF456789GHI",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Formato Recomendado

Para melhor compatibilidade com mensagens de voz (PTT), use o formato OGG com codec Opus:

# Converter MP3 para OGG/Opus com FFmpeg
ffmpeg -i input.mp3 -c:a libopus -b:a 64k output.ogg

Áudios em outros formatos (MP3, WAV, M4A) serão automaticamente convertidos, mas podem ter pequena perda de qualidade ou aumento no tempo de envio.

PTT vs Arquivo de Áudio

Característica	PTT (ptt: true)	Arquivo (ptt: false)
Aparência	Bolinha azul	Ícone de arquivo
Velocidade	1x, 1.5x, 2x	Player padrão
Comportamento	Toque para ouvir	Precisa baixar

Enviar Vídeo Enviar Documento

Começando

WhatsApp

Request Body

Formato Recomendado

PTT vs Arquivo de Áudio

​Request Body

​Formato Recomendado

​PTT vs Arquivo de Áudio

Request Body

Formato Recomendado

PTT vs Arquivo de Áudio