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

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

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

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

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

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

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

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

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

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

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

Запрос синтаксис

~~Используйте~~ ~~ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения~~ ~~endpoint to send an audio message to a WhatsApp user.~~

curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>' \
-д '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "к": "<Номер телефона пользователя WhatsApp>",
  "type": "audio",
  "audio": {
    "идентификатор": "<MEDIA_ID>", <!-- Only if using uploaded media -->
    "связь": "<MEDIA_URL>", <!-- Only if using hosted media (not recommended) -->
    "voice": <IS_VOICE?><!-- Only include if sending voice message -->
  }
}'

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

Заполнитель Описание Пример значения

<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.

Пример запроса

Пример запроса на отправку сообщения с изображением, используя идентификатор загруженного медиафайла и подпись.

локон 'https://graph.facebook.com/v25.0/106540352242922/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель EAAJB...» \
-д ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "audio", "audio": { "id" : "1013859600285441", "voice": true } }'

Пример ответа

{
"messaging_product": "WhatsApp",
"контакты": [
    {
"вход": "+16505551234",
"ва_ид": "16505551234"
    }
  ],
"сообщения": [
    {
"идентификатор": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}