--- title: "Медиа в WhatsApp API: типы файлов и ограничения по размеру" description: "Размеры и типы файлов в WhatsApp API: изображения, видео, аудио, документы и стикеры, загрузка и ссылка, media ID, срок его действия и подписи к медиа." canonical: "https://omnichannels.ai/ru/blog/whatsapp-media-messages-file-types-size-limits/" language: "ru" updated: "2026-11-07" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "whatsapp api размер файла" keywords: ["whatsapp api размер файла", "whatsapp api поддерживаемые типы файлов", "whatsapp cloud api медиа", "ограничение размера видео whatsapp", "ограничение размера документа whatsapp", "размер стикера whatsapp", "срок действия media id whatsapp", "изображение в заголовке шаблона whatsapp", "ошибка 131053 whatsapp"] published: "2026-11-07" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "Согласно документации Meta, на момент написания максимальные размеры медиа в WhatsApp Cloud API таковы: изображения 5 МБ (JPEG, PNG, статичный WebP), видео 16 МБ (MP4 или 3GPP с H.264 и AAC), аудио 16 МБ, документы 100 МБ, анимированные стикеры 500 КБ, статичные 100 КБ. Загружайте файл и отправляйте его media ID, а не ссылку, и проверяйте, что MIME-тип соответствует файлу." takeaways: ["По документации Meta на момент написания лимиты такие: 5 МБ для изображений, 16 МБ для видео и аудио, 100 МБ для документов, 500 КБ (анимированные) или 100 КБ (статичные) для стикеров.", "Видео должно быть в H.264 со звуком AAC, а изображения в 8-битном RGB или RGBA: файл, уложившийся в лимит размера, всё равно могут отклонить из-за кодека или цветового формата.", "Meta рекомендует отправлять загруженное медиа по ID, а не по ссылке: так выше производительность.", "Media ID, полученный при загрузке, действует 30 дней, а ID из входящих вебхуков 7 дней, поэтому файлы клиентов нужно скачивать сразу.", "Подписи к изображениям, видео и документам ограничены 1 024 символами, а ошибка 131053 обычно означает, что MIME-тип не соответствует файлу."] faq: - q: "Какой лимит размера файла в WhatsApp API?" a: "Он зависит от типа. По документации Meta: 5 МБ для изображений, 16 МБ для видео и аудио, 100 МБ для документов, 500 КБ для анимированных и 100 КБ для статичных стикеров. Предельный размер любого медиа в Cloud API составляет 100 МБ. Лимиты могут меняться, поэтому перед созданием правил проверки сверьтесь с актуальным справочником Meta." - q: "Какие типы файлов поддерживает WhatsApp Business API?" a: "Изображения: JPEG, PNG и статичный WebP. Видео: MP4 и 3GPP с видео H.264 и звуком AAC. Аудио: AAC, AMR, MP3, M4A и OGG с кодеком Opus. Документы: TXT, XLS, XLSX, DOC, DOCX, PPT, PPTX и PDF. Стикеры: только WebP. Всё за пределами этих списков отклоняется, поэтому конвертируйте файлы до отправки." - q: "Что лучше: отправлять медиа по ссылке или по media ID?" a: "Документация Meta рекомендует загруженный media ID ради производительности. Ссылка должна вести на файл на публичном сервере, поэтому платформе приходится скачивать его в момент отправки. ID указывает на файл, уже хранящийся у Meta. ID после загрузки действует 30 дней, затем файл нужно загрузить заново." - q: "Сколько действует media ID в WhatsApp?" a: "Meta указывает 30 дней для ID, полученных при загрузке медиа, и 7 дней для media ID из входящих вебхуков. Загруженные файлы хранятся 30 дней, если их не удалить раньше. Ссылка для скачивания по media ID действует 5 минут, поэтому при каждой необходимости запрашивайте новую." - q: "Можно ли добавить подпись к изображению или видео в WhatsApp?" a: "Да. Справочник Meta по сообщениям допускает необязательную подпись длиной до 1 024 символов для сообщений с изображением, видео и документом. У аудио и стикеров подписи нет. Если нужен текст к стикеру или голосовому сообщению, отправьте следом отдельное текстовое сообщение." - q: "Что означает ошибка 131053 в WhatsApp?" a: "Meta описывает её как невозможность загрузить медиа, использованное в сообщении. Обычно причина в том, что MIME-тип не совпадает с расширением файла или не поддерживается. Посмотрите детали ошибки в соответствующем вебхуке, сверьте формат с поддерживаемыми типами Meta и при необходимости перекодируйте файл." sources: - title: "Media — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media" - title: "Image messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages" - title: "Video messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages" - title: "Document messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages" - title: "Error codes — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes" --- # Медиа в WhatsApp API: типы файлов и ограничения по размеру Canonical: https://omnichannels.ai/ru/blog/whatsapp-media-messages-file-types-size-limits/ Language: ru Publisher: OmniChannels.ai by BroadNet Technologies Это руководство для разработчиков и маркетологов, которые отправляют через WhatsApp Business API изображения, видео, аудио, документы или стикеры и хотят избежать неудачных отправок. В нём перечислены типы файлов и лимиты размера из документации Meta, объясняются загрузка и ссылка, media ID, подписи и заголовки шаблонов, а также показано, как обрабатывать файлы, которые присылают клиенты. Все числа ниже — значения из документации Meta на момент написания (7 ноября 2026 года). Meta может их изменить, поэтому ориентируйтесь на [справочник по медиа](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media). ## Каковы лимиты размера медиафайлов в WhatsApp API? У каждого типа медиа свой предел, а общий потолок Cloud API для любого медиа — 100 МБ. Больше всего места у документов, меньше всего у стикеров. | Тип медиа | Максимальный размер | Примечания | |---|---|---| | Изображение | 5 МБ | Только 8-битный RGB или RGBA | | Видео | 16 МБ | Видео H.264, звук AAC | | Аудио | 16 МБ | Несколько форматов, см. ниже | | Документ | 100 МБ | Файлы Office, PDF и текстовые файлы | | Стикер (анимированный) | 500 КБ | Только WebP | | Стикер (статичный) | 100 КБ | Только WebP | Файл может уложиться в лимит размера и всё равно не пройти по формату. В следующих разделах перечислены допустимые форматы для каждого типа. ## Какие форматы изображений и стикеров поддерживаются? Изображения могут быть JPEG, PNG или статичным WebP, до 5 МБ, и должны быть в 8-битном RGB или RGBA. Стикеры должны быть в WebP. | Тип | Расширение | MIME-тип | |---|---|---| | JPEG | .jpeg | `image/jpeg` | | PNG | .png | `image/png` | | Статичный WebP | .webp | `image/webp` | У Meta есть ещё три правила для изображений. Статичный WebP, отправленный в сообщении с изображением, перекодируется в JPEG. Анимированные файлы WebP, файлы WebP, которые не удаётся декодировать, и изображения больше 4 096 пикселей по любой стороне отклоняются. Для стикеров используйте WebP с типом `image/webp`: до 500 КБ для анимированных и до 100 КБ для статичных. Если фирменные материалы — это крупные PNG из дизайнерской программы, экспортируйте JPEG веб-размера вместо отправки оригинала. ## Какие форматы видео и аудио поддерживаются? Видео — MP4 или 3GPP до 16 МБ. Аудио может быть AAC, AMR, MP3, M4A или OGG с кодеком Opus, тоже до 16 МБ. | Тип | Расширение | MIME-тип | |---|---|---| | Видео MP4 | .mp4 | `video/mp4` | | Видео 3GPP | .3gp | `video/3gpp` | | Аудио AAC | .aac | `audio/aac` | | Аудио AMR | .amr | `audio/amr` | | Аудио MP3 | .mp3 | `audio/mpeg` | | Аудио MP4 | .m4a | `audio/mp4` | | Аудио OGG | .ogg | `audio/ogg` | Для видео Meta требует кодек H.264 и звук AAC с одной звуковой дорожкой или без звука. Meta также не советует профиль H.264 High с B-кадрами, потому что клиенты WhatsApp на Android его не поддерживают: используйте Main без B-кадров или Baseline. Блоки `moov` должны стоять перед блоками `mdat`; в ffmpeg для этого служит параметр `-movflags faststart`. Для OGG поддерживается только кодек Opus, базовый тип `audio/ogg` не поддерживается, а источник должен быть моно. ## Какие форматы документов поддерживаются? Документы могут быть PDF, Word, Excel, PowerPoint или обычным текстом, до 100 МБ. | Тип | Расширение | MIME-тип | |---|---|---| | PDF | .pdf | `application/pdf` | | Word | .doc, .docx | `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | | Excel | .xls, .xlsx | `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | | PowerPoint | .ppt, .pptx | `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation` | | Текст | .txt | `text/plain` | В сообщении с документом можно указать необязательное имя файла с расширением, и по этому расширению клиент WhatsApp выбирает значок файла. Дайте файлу понятное имя, например `invoice-2026-1042.pdf`: клиент его увидит. ## Загружать медиа или отправлять ссылку? Meta рекомендует загрузить файл и отправлять его media ID. Можно вместо этого отправить ссылку на файл на публичном сервере, но в справочниках Meta по изображениям, видео и документам сказано предпочитать загруженный ID ради производительности, и то же самое говорится в её рекомендациях по пропускной способности для больших объёмов. | | Media ID | Ссылка | |---|---|---| | Как работает | Сначала загрузка, затем обращение по полученному ID | Указывается публичный URL; файл скачивается в момент отправки | | Рекомендация Meta | Рекомендуется | Поддерживается, но не рекомендуется | | Срок действия | 30 дней с момента загрузки | Пока ваш сервер отдаёт файл | | Как ломается | ID истёк или недействителен | URL недоступен, медленный или с неверным типом | В собственной конечной точке Meta загрузка — это `POST` на `//media` с файлом, его MIME-типом и `messaging_product=whatsapp`, а ответ имеет вид `{"id": ""}`. Загруженные файлы шифруются и хранятся 30 дней, если вы не удалите их раньше. В конечной точке WhatsApp OmniChannels.ai сообщение с медиа принимает либо `mediaUrl` (публичный HTTPS-URL), либо `mediaFile` (файл, загружаемый вместе с запросом), а подпись передаётся в `content`. См. [документацию WhatsApp API](/developers/whatsapp/). Как ваш аккаунт хранит и повторно использует медиа при больших рассылках, уточните у нашей команды. ## Сколько действуют media ID? Meta указывает 30 дней для ID, полученного при загрузке, и 7 дней для ID, полученного во входящем вебхуке. Ссылка для скачивания, возвращаемая по ID, действует 5 минут. Практические выводы: - Не кэшируйте media ID на месяцы. Храните исходный файл и загружайте заново, если ID отклонён. - Скачивайте входящие файлы, как только пришло событие, и храните собственную копию. - Не сохраняйте полученную ссылку для скачивания: запрашивайте новую, когда она нужна. ## Можно ли добавлять подписи к медиа-сообщениям? Да. Сообщения с изображением, видео и документом принимают необязательную подпись до 1 024 символов, согласно справочникам Meta по сообщениям. Подпись — это обычный текст рядом с файлом. У аудио и стикеров в этой модели подписи нет. Если к голосовому сообщению нужны слова, отправьте рядом короткое текстовое сообщение. В [окне обслуживания клиента](/ru/blog/whatsapp-24-hour-customer-service-window/) подписи пишутся свободно; вне его медиа нужно отправлять внутри одобренного шаблона. ## Как работают медиа в шаблонных сообщениях? В заголовке шаблона может быть изображение, видео или документ, и формат заголовка фиксируется при создании шаблона. Когда вы отправляете шаблон на одобрение, вы прикладываете пример файла, а настоящий файл можно передать уже при отправке. В нашем API при создании `headerFormat` может быть `IMAGE`, `VIDEO` или `DOCUMENT`, `headerFile` передаёт пример, а `mediaUrl` при отправке заменяет медиа заголовка. Требования к примерам файлов смотрите в документации Meta по шаблонам. См. [категории шаблонов и одобрение](/ru/blog/whatsapp-template-categories-approval/) и [примеры шаблонов](/ru/blog/whatsapp-message-template-examples/). ## Как скачать медиа, которое прислал клиент? Входящее медиа приходит вебхуком с media ID; его нужно преобразовать в URL и скачать с авторизацией. 1. Возьмите media ID из события входящего сообщения. 2. Запросите URL медиа для этого ID. В ответе Meta есть `url`, `mime_type`, `sha256` и `file_size`. 3. Отправьте `GET` на этот URL с заголовком `Authorization: Bearer `. Без токена запрос не пройдёт. 4. Проверьте заголовок `Content-Type` и значение `sha256`, затем сохраните файл. 5. При ответе `404` запросите новый URL и повторите; если и это не помогло, обновите токен доступа. Максимальный размер входящего медиа в Cloud API по данным Meta — 100 МБ. Более крупный файл вызывает вебхук с кодом ошибки `131052`; попросите клиента прислать файл поменьше или передать его иным способом. Проверяйте каждый файл антивирусом, прежде чем открывать его внутри компании. См. [руководство по вебхукам](/ru/blog/whatsapp-webhooks-guide/) и уточните у инженера по подключению, как входящее медиа доставляется в вашем аккаунте. ## Пример: стоматологическая клиника отправляет отчёты Клиника «Nile Smile Clinic» (вымышленная) в Каире отправляет талоны на приём и рентгеновские заключения. 1. Талоны на приём — PNG-изображения по 300 КБ с подписью в две строки. Это намного меньше 5 МБ. 2. Отчёты о лечении — PDF по 2–8 МБ с именем `report-2026-0381.pdf`, отправляются как документы. 3. Видеообзор клиники на 25 МБ слишком велик для видео. Команда перекодирует его в MP4 с H.264/AAC меньше 16 МБ с `faststart`. 4. Пациенты присылают фото рецептов. Инбокс скачивает каждый файл сразу, потому что входящий ID истекает через 7 дней. 5. Голосовое приветствие экспортировано как моно OGG с Opus, потому что другие варианты OGG отклоняются. ## Какие типичные ошибки? - **Оценка только по размеру.** Изображение в 3 МБ в неверном цветовом формате или видео с неверным кодеком всё равно не пройдут. - **Несовпадение MIME.** Файл `.jpg`, отдаваемый как `application/octet-stream`, — классическая причина ошибки 131053. - **Ссылка на медленный или закрытый URL**, например истёкшая подписанная ссылка или страница за авторизацией. - **Использование старого media ID.** ID истекают через 30 дней. - **Игнорирование срока входящих ID.** Файлы клиентов нужно сохранять в течение 7 дней. - **Анимированный WebP как изображение.** Он отклоняется; используйте стикер или видео. - **Лимиты меняются.** Перед тем как жёстко прописывать проверки, ещё раз сверьтесь со справочником Meta. ## Чем помогает OmniChannels.ai OmniChannels.ai отправляет сообщения WhatsApp с изображениями, видео, аудио, документами и стикерами через один API: по публичной ссылке или с загруженным файлом и с подписью, а медиа и вложения показывает в общем инбоксе. BroadNet — официальный бизнес-провайдер решений Meta (Business Solution Provider), поэтому шаблоны с заголовком-изображением, видео или документом можно создавать и отслеживать по статусу одобрения. Читайте [документацию WhatsApp API](/developers/whatsapp/) и [ошибки и лимиты](/developers/errors-and-limits/) или смотрите [канал WhatsApp](/ru/channels/whatsapp-business-api/).