v1

latestOpenAPI 3.0.22026-08-045831103.6 KB

Messages

Send audio message

Send an audio message via WhatsApp Official. The audio URL is sent directly to the Meta API. No caption support for audio messages. Set "voice" to true to deliver the file as a WhatsApp voice note (PTT) instead of a regular audio attachment; for PTT the file must be .ogg encoded with the OPUS codec (Meta validates and rejects other formats). Returns immediately with QUEUED status.

post/v2/messages/audio

Headers

api-tokenstring required

API Token

Request body

channel_account_idstring uuid required

UUID of the WhatsApp Official channel account

contact_idstring uuid required

UUID of the contact to send the audio to

urlstring uri required

Direct URL of the audio file to send

voiceboolean

Optional. When true, the audio is delivered as a WhatsApp voice note (PTT) instead of a regular audio attachment. Requires an .ogg file encoded with the OPUS codec.

chat_idstring uuid

Optional UUID of an existing chat. If not provided, the system will find or create a chat automatically.

Example request

{
  "channel_account_id": "550e8400-e29b-41d4-a716-446655440001",
  "contact_id": "550e8400-e29b-41d4-a716-446655440002",
  "url": "https://example.com/audio.ogg",
  "voice": true,
  "chat_id": "550e8400-e29b-41d4-a716-446655440003"
}

Response

Audio message queued for sending

statusinteger

Example response

{
  "status": 200,
  "data": {
    "success": true,
    "message_id": "550e8400-e29b-41d4-a716-446655440099",
    "chat_id": "550e8400-e29b-41d4-a716-446655440003",
    "status": "QUEUED"
  }
}