Аудиосообщения | Документация для разработчиков
Аудиосообщения
Обновлено: 17 февраля 2026 г
17 марта 2026 года голосовые сообщения начнут получать веб-хук со статусом «проиграно» при первом воспроизведении пользователем WhatsApp голосового сообщения, отправленного компанией.
С помощью Cloud API вы можете отправлять голосовые сообщения и простые аудиосообщения.
Голосовые сообщения
Голосовое сообщение (иногда называемое голосовой заметкой, голосовым сообщением или аудиозаписью) — это запись речи одного или нескольких человек, которая может включать фоновые звуки, такие как музыка. Голосовые сообщения включают такие функции, как автоматическая загрузка, изображение профиля и значок голоса. Эти функции недоступны для обычных аудиосообщений. Если пользователь устанавливает автоматическое, сообщение будет содержать текстовую расшифровку.
Основные аудиосообщения
В стандартных аудиосообщениях отображаются значок загрузки и значок воспроизведения музыки. Когда пользователь WhatsApp нажимает на значок воспроизведения, он вручную загружает аудиосообщение, чтобы клиент WhatsApp мог загрузить и воспроизвести аудиофайл.
Синтаксис запроса
Используйте POST / Конечная точка для отправки аудиосообщения пользователю WhatsApp.
curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<WHATSAPP_USER_PHONE_NUMBER>",
"type": "audio",
"audio": {
"id": "<MEDIA_ID>", <!-- Only if using uploaded media -->
"ссылка": "<MEDIA_URL>", <!-- Only if using hosted media (not recommended) -->
"голос": <IS_VOICE?><!-- Only include if sending voice message -->
}
}'
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить | Необходимый. | |
<API_VERSION>Нить | Необязательный. Версия Graph API. | v25.0 |
<IS_VOICE?>Логический | Необязательный. Установите значение true если отправляете голосовое сообщение. Голосовые сообщения должны быть файлами Ogg, закодированными с помощью OPUS .Чтобы отправить простое аудиосообщение, установите значение false или полностью пропустите этот параметр. | истинный |
<MEDIA_ID>Нить | Обязательно, если используются загруженные медиафайлы, в противном случае пропустите. Идентификатор загруженного медиафайла. | 1013859600285441 |
<MEDIA_URL>Нить | Обязательно, если используются размещенные медиафайлы; в противном случае опустите. URL медиафайла, размещенного на вашем общедоступном сервере. Для повышения производительности мы рекомендуем использовать идентификатор и идентификатор загруженного медиафайла . | https://www.luckyshrub.com/media/ringtones/wind-chime.mp3 |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить | Необходимый. Идентификатор бизнес-телефона WhatsApp. | 106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>Нить | Необходимый. Номер телефона пользователя WhatsApp. | +16505551234 |
Поддерживаемые аудиоформаты
| Тип аудио | Расширение | Тип MIME | Максимальный размер |
|---|---|---|---|
ААК | .aac | аудио/аАК | 16 МБ |
АМР | .amr | аудио/амр | 16 МБ |
MP3 | .mp3 | аудио/мпег | 16 МБ |
MP4 Аудио | .m4a | аудио/мп4 | 16 МБ |
OGG Audio | .ogg | audio/ogg (только кодеки OPUS; базовый формат audio/ogg не поддерживается; только монофонический вход) | 16 МБ |
Наиболее распространенные ошибки, связанные с аудиофайлами, — это несоответствие MIME-типов (MIME-тип не соответствует типу файла, указанному в имени файла) и недопустимая кодировка для файлов Ogg (только для кодека OPUS). Если при отправке медиафайла возникает ошибка, убедитесь, что MIME-тип вашего аудиофайла соответствует его расширению и является поддерживаемым типом. Для файлов Ogg используйте кодек OPUS.
Пример запроса
Пример запроса на отправку сообщения с изображением, используя идентификатор загруженного медиафайла и подпись.
curl 'https://graph.facebook.com/v25.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" : "1013859600285441", "voice": true } }'Пример ответа
{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "+16505551234",
"wa_id": "16505551234"
}
],
"messages": [
{
"id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
}
]
}