Перейти к основному содержимому

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

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

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

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

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

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

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

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

      Заполнитель Описание Пример значения
      <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.

      Комментарии отсутствуют

      Вернуться наверх