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://example.com/audio.mp3",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Messages
Send audio
Send audio messages via 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://example.com/audio.mp3",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Overview
Method for sending audio messages. You can send via URL or Base64. The audio is sent as a voice message on WhatsApp.When sending as Base64, you must include the prefix with the audio type, for example:
data:audio/mpeg;base64,.File size limits and supported formats follow WhatsApp policies. See the official WhatsApp documentation for details.
Authorizations
Secret Key generated in the Omni Z-API Security panel
Body
application/json
Recipient phone number (country code + area code + number)
Example:
"5511999999999"
Audio URL or Base64 data
Send as view-once message
Delay in seconds before sending (1-15)
Required range:
1 <= x <= 15Seconds to display "Recording audio..." status (1-15)
Required range:
1 <= x <= 15