Skip to main content

​
Что это такое

Media API позволяет загружать изображения, видео, аудиофайлы, стикеры или документы через WhatsApp Business API. Полученный media ID можно использовать в последующих запросах на отправку сообщений WhatsApp.

​
Перед началом работы

  • Подключите и зарегистрируйте номер телефона WhatsApp для отправки сообщений.
  • Обеспечьте безопасное хранение вашего API-ключа YCloud.
  • Подготовьте файл, соответствующий поддерживаемым Meta типам медиафайлов и ограничениям по размеру.
  • Уточните, поддерживает ли целевой тип сообщения media ID или требует указания URL.

​
Как это работает

  1. Загрузите файл для номера телефона отправителя.
  2. Сохраните возвращенный media ID.
  3. Укажите media ID в соответствующем объекте контента сообщения WhatsApp.
  4. Отправьте сообщение до истечения срока действия загруженного медиафайла.
Загруженные файлы шифруются и хранятся в течение 30 дней.

​
Запрос

POST /whatsapp/media/{phoneNumber}/upload Отправьте файл в формате multipart/form-data.
Используйте зарегистрированный рабочий номер телефона в формате E.164.

​
Ответ

Сохраните id и используйте его в объекте медиа для поддерживаемого запроса сообщения WhatsApp.

​
Использование медиафайлов

Media ID привязан к хранилищу медиафайлов WhatsApp и действует в течение 30 дней. Загрузите файл повторно, если срок действия идентификатора истек. Заголовки интерактивных сообщений не поддерживают media ID для изображений, документов, видео или аудио. Для этих элементов заголовка используйте общедоступную ссылку.

​
Ограничения и устранение неполадок

  • Передавайте корректный MIME-тип вместе с загружаемым файлом.
  • Перед загрузкой ознакомьтесь с поддерживаемыми Meta типами медиафайлов и ограничениями по размеру.
  • Не используйте media ID с истекшим сроком действия повторно.
  • Убедитесь, что номер телефона при загрузке совпадает с номером отправителя сообщения.
  • Для повторно используемых публичных ресурсов использование ссылки может быть проще, чем регулярные загрузки, если это поддерживается схемой сообщения.

API загрузки медиафайлов

Изучите схему multipart-запроса и ответа.

Отправка медиасообщений

Добавьте полученный media ID в запрос на отправку сообщения WhatsApp.