> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Загрузка медиафайлов WhatsApp

> Загружайте медиафайлы и используйте полученный media ID в запросах на отправку сообщений WhatsApp.

## Что это такое

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`.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST \
  https://api.ycloud.com/v2/whatsapp/media/+16315551111/upload \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --form "file=@./invoice.pdf;type=application/pdf"
```

Используйте зарегистрированный рабочий номер телефона в формате E.164.

## Ответ

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "MEDIA_ID"
}
```

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "type": "document",
  "document": {
    "id": "MEDIA_ID",
    "filename": "invoice.pdf"
  }
}
```

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

Media ID привязан к хранилищу медиафайлов WhatsApp и действует в течение 30 дней. Загрузите файл повторно, если срок действия идентификатора истек.

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

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

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

<CardGroup cols={2}>
  <Card title="API загрузки медиафайлов" icon="upload" href="/api-reference/whatsapp-media/upload-media">
    Изучите схему multipart-запроса и ответа.
  </Card>

  <Card title="Отправка медиасообщений" icon="image" href="/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Добавьте полученный media ID в запрос на отправку сообщения WhatsApp.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.