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

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

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

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

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

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

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

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

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

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

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

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

~~Используйте~~ ~~ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения~~ ~~Конечная точка для отправки аудиосообщения пользователю WhatsApp.~~

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>",
  "тип": "аудио",
  "аудио": {
    "идентификатор": "<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>

Нить

Необходимый.

Системный токен или бизнес-токен.

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"
    }
  ]
}