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"
}
Mensagens
Enviar Áudio
Envia um áudio ou mensagem de voz
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
string
required
ID da sessão que enviará a mensagem.
string
required
Destinatário (número com DDI ou JID).
string
required
URL do áudio ou conteúdo em base64.Formatos suportados: OGG/Opus (recomendado), MP3, M4A, WAVTamanho máximo: 16 MB
boolean
default:"true"
Se
true, envia como mensagem de voz (bolinha azul). Se false, envia como arquivo de áudio.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 |