Skip to main content
POST
https://api.oxenty.api.br
/
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
  }'
{
  "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.
to
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
  }'
{
  "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ísticaPTT (ptt: true)Arquivo (ptt: false)
AparênciaBolinha azulÍcone de arquivo
Velocidade1x, 1.5x, 2xPlayer padrão
ComportamentoToque para ouvirPrecisa baixar