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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid
required

UUID of the WhatsApp Official channel account

uuid
required

UUID of the contact to send the audio to

uri
required

Direct URL of the audio file to send

boolean
Defaults to false

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.

uuid

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

Headers
string
required

API Token

Responses

401

Authentication error - invalid or missing api-token

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json