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