Отправка медиа: изображения, видео, аудио и документы
Медиа отправляется двумя способами: сначала загрузите файл и укажите полученный идентификатор либо передайте Meta общедоступную ссылку. Загрузка надёжнее, а лимиты зависят от типа файла и часто становятся неожиданностью.
Максимальный размер изображения в Cloud API.
Максимальный размер видео и аудио.
Максимальный размер документов.
Лимиты по типам
Для каждого типа они разные. Превышение лимита возвращает код ошибки 131053 без понятного описания.
- Изображения: 5 MB. JPEG и PNG.
- Видео: 16 MB. MP4 и 3GPP, с видео H.264 и аудио AAC.
- Аудио: 16 MB. AAC, AMR, MP3, аудио MP4 и OGG с Opus.
- Документы: 100 MB. Большинство распространённых типов, включая PDF и офисные форматы.
- Стикеры: 100 KB для анимированных, 500 KB для статичных, только WebP.
Загрузка или ссылка
Один и тот же файл можно отправить двумя способами, но ошибки будут разными.
При загрузке файл сначала отправляется в Meta, после чего вы получаете идентификатор медиа для отправки. При использовании ссылки Meta получает URL и загружает файл во время отправки. Ссылка кажется проще, но добавляет незаметный риск: URL, который открывается в вашем браузере, может быть недоступен инфраструктуре Meta из-за географии, правила брандмауэра или файла cookie сессии, который уже есть в браузере.
Загружайте файл. Это всего один дополнительный запрос, зато исчезает целый класс ошибок.
Получение медиа
Входящее медиа приходит как идентификатор, а не как набор байтов. Ваш обработчик отдельно загружает файл по этому идентификатору.
- Загружайте сразу. Идентификаторы действуют ограниченное время.
- Неудачная загрузка возвращает код ошибки 131052, что обычно означает неполную загрузку отправителем.
- Сохраняйте файл у себя, если он понадобится позже. Meta не архив.
- Записывайте сообщение, даже если медиа не удалось загрузить, чтобы сохранить текст и контекст.
Что меняет Coexistence
Медиа на номере Coexistence работает так же, как на любом другом номере Cloud API, с теми же лимитами.
Важно учитывать историю. При первом подключении номера Meta синхронизирует недавние сообщения из приложения WhatsApp Business. Эта синхронизация включает текст сообщений, но не является полным архивом медиа. Медиа до подключения остаётся на телефоне, где и находилось.
Распространённые ошибки
- Отправка ссылки кажется проще, но сеть Meta работает не так, как ваш браузер.
- Загрузка входящего медиа через несколько часов. Идентификаторы истекают.
- Экспорт видео без проверки кодека. Настройки по умолчанию в программах монтажа часто не поддерживаются.
EasyCoexistence передаёт события о входящих сообщениях напрямую от Meta на ваш эндпоинт. Идентификаторы медиа сразу попадают в систему, и файл можно загрузить, пока они действуют.
Часто задаваемые вопросы
Какой файл максимального размера можно отправить?
100 MB, но только для документов. Для видео и аудио лимит составляет 16 MB, для изображений 5 MB.
Загружать файл или отправлять URL?
Загружать. Это исключает доступность ссылки как причину ошибки.
Как долго действует идентификатор медиа?
Не бесконечно, поэтому входящее медиа нужно загружать сразу после получения события.
Синхронизируется ли старое медиа при подключении?
Нет. Синхронизация истории включает недавнее содержимое сообщений, а медиа до подключения остаётся на телефоне.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на