curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-audio \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"audio": "https://ejemplo.com/audio.mp3",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Mensajes
Enviar audio
Envía mensajes de audio por WhatsApp
POST
/
send-audio
curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-audio \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"audio": "https://ejemplo.com/audio.mp3",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Conceptos
Método para enviar mensajes de audio. Puedes enviarlos mediante URL o mediante Base64. El audio se envía como mensaje de voz en WhatsApp.Al enviarlo en Base64 es obligatorio incluir el prefijo con el tipo de audio, por ejemplo:
data:audio/mpeg;base64,.Los límites de tamaño y los formatos admitidos siguen las políticas de WhatsApp. Consulta la documentación oficial de WhatsApp para más detalles.
Autorizaciones
Secret Key generada en el panel de Seguridad de Omni Z-API
Cuerpo
application/json
Teléfono del destinatario (código de país + prefijo + número)
Ejemplo:
"5511999999999"
URL del audio o datos en Base64
Enviar como mensaje de visualización única
Retardo en segundos antes del envío (1-15)
Rango requerido:
1 <= x <= 15Tiempo en segundos mostrando el estado «Grabando audio...» (1-15)
Rango requerido:
1 <= x <= 15