Cloud API

Audio Messages

Audio messages display an audio icon and a link to an audio file. When the WhatsApp user taps the icon, the WhatsApp client loads and plays the audio file.

Sending Audio Messages

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send an audio message to a WhatsApp user.

Request Syntax

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Post Body

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "audio",
  "audio": {
    "id" : "<MEDIA_ID>"
  }
}

Post Body Parameters

PlaceholderDescriptionExample Value

<MEDIA_ID>

String

Required if using an uploaded media asset (recommended).

Uploaded media asset ID.

3674626312780147

<MEDIA_URL>

String

Required if linking to your media asset (not recommended)

URL of audio asset on your public server. For better performance, we recommend that you upload your media asset instead.

https://www.luckyshrub.com/assets/lucky-track.aac

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Supported Audio Formats

Audio TypeExtensionMIME TypeMax Size

AAC

.aac

audio/aac

16 MB

AMR

.amr

audio/amr

16 MB

MP3

.mp3

audio/mpeg

16 MB

MP4 Audio

.m4a

audio/mp4

16 MB

OGG Audio

.ogg

audio/ogg (OPUS codecs only; base audio/ogg not supported.)

16 MB

Example Request

Example request to send an image message using an uploaded media ID and a caption.

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "audio",
  "audio": {
    "id" : "3674626312780147"
  }
}'

Example Response

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}