Аудиосообщения | Документация для разработчиков

Аудиосообщения

Обновлено: 17 февраля 2026 г

17 марта 2026 года голосовые сообщения начнут получать веб-хук со статусом «проиграно» при первом воспроизведении пользователем WhatsApp голосового сообщения, отправленного компанией.

С помощью Cloud API вы можете отправлять голосовые сообщения и простые аудиосообщения.

Голосовые сообщения

Голосовое сообщение (иногда называемое голосовой заметкой, голосовым сообщением или аудиозаписью) — это запись речи одного или нескольких человек, которая может включать фоновые звуки, такие как музыка. Голосовые сообщения включают такие функции, как автоматическая загрузка, изображение профиля и значок голоса. Эти функции недоступны для обычных аудиосообщений. Если пользователь устанавливает автоматическое , сообщение будет содержать текстовую расшифровку.

Для голосовых сообщений требуются файлы .ogg, закодированные с использованием OPUS . Если вы отправите файл другого типа или файл, закодированный с использованием другого кодека, расшифровка голосового сообщения не удастся.Значок воспроизведения появится только в том случае, если размер файла не превышает 512 КБ, в противном случае он будет заменен значком загрузки (стрелка, направленная вниз).В сообщении отображается изображение профиля вашей компании со значком микрофона.Текстовая расшифровка отображается, если пользователь включил автоматическую расшифровку голосовых сообщений . Если пользователь установил значение «Вручную» , вместо этого появится текст «Расшифровать», который отобразит расшифрованный текст после нажатия. Если пользователь установил значение « Никогда» , текст отображаться не будет.

Основные аудиосообщения

В стандартных аудиосообщениях отображаются значок загрузки и значок воспроизведения музыки. Когда пользователь WhatsApp нажимает на значок воспроизведения, он вручную загружает аудиосообщение, чтобы клиент WhatsApp мог загрузить и воспроизвести аудиофайл.

Значок загрузки будет заменен значком воспроизведения, если пользователь WhatsApp включил автоматическую загрузку аудиофайлов и соблюдены условия для автоматической загрузки (например, подключение к Wi-Fi).Если вы отправляете файл .ogg, закодированный с помощью кода OPUS, в качестве обычного аудиосообщения, значок музыки будет заменен значком микрофона. Кроме того, если пользователь включил автоматическую или ручную расшифровку голосовых сообщений , сообщение будет сопровождаться текстовой расшифровкой или текстом «Расшифровать».

Синтаксис запроса

Используйте POST / /messages для отправки аудиосообщения пользователю 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 > ", "ссылка": "
 < MEDIA_URL > ", --> "голос":
 < IS_VOICE ? > }
 }'

Параметры запроса

Заполнитель	Описание	Пример значения
`<ACCESS_TOKEN>` Нить	Необходимый. Системный токен или бизнес-токен .	`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`
`<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.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzA zMzQ5MkEA" }
 ]
 }