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

# Fazer upload de mídia do WhatsApp

> Faça upload de mídia e use o ID de mídia retornado em solicitações de mensagens do WhatsApp.

## O que é

A Media API faz o upload de uma imagem, vídeo, arquivo de áudio, figurinha ou documento por meio da WhatsApp Business API. O ID de mídia retornado pode ser referenciado em uma solicitação posterior de mensagem do WhatsApp.

## Antes de começar

* Conecte e registre o número de telefone remetente do WhatsApp.
* Armazene sua chave de API da YCloud com segurança.
* Prepare um arquivo que atenda aos limites de tamanho e tipos de mídia suportados pela Meta.
* Verifique se o tipo de mensagem de destino suporta um ID de mídia ou requer uma URL.

## Como funciona

1. Faça o upload do arquivo para o número de telefone remetente.
2. Armazene o ID de mídia retornado.
3. Insira o ID de mídia no objeto de conteúdo correspondente da mensagem do WhatsApp.
4. Envie a mensagem antes que a mídia enviada expire.

Os arquivos enviados são criptografados e permanecem por 30 dias.

## Solicitação

`POST /whatsapp/media/{phoneNumber}/upload`

Envie o arquivo como `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"
```

Use o número de telefone comercial registrado no formato E.164.

## Resposta

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

Armazene o `id` e use-o no objeto de mídia para uma solicitação de mensagem do WhatsApp compatível.

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

## Uso de mídia

Um ID de mídia está vinculado ao armazenamento de mídia do WhatsApp e expira após 30 dias. Faça o upload novamente quando o ID não for mais válido.

Os cabeçalhos de mensagens interativas não podem usar um ID de mídia para imagens, documentos, vídeos ou áudios. Use um link acessível publicamente para esses elementos de cabeçalho.

## Limites e solução de problemas

* Envie o tipo MIME correto com o arquivo enviado.
* Verifique os tipos de mídia e limites de tamanho suportados pela Meta antes de fazer o upload.
* Não reutilize um ID de mídia expirado.
* Mantenha o mesmo número de telefone remetente no upload e na mensagem.
* Para recursos públicos reutilizáveis, um link pode ser mais simples do que uploads repetidos quando
  o esquema da mensagem for compatível.

<CardGroup cols={2}>
  <Card title="Upload media API" icon="upload" href="/api-reference/whatsapp-media/upload-media">
    Inspecione o esquema de solicitação e resposta multipart.
  </Card>

  <Card title="Enviar mensagens de mídia" icon="image" href="/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Adicione o ID de mídia retornado a uma solicitação de mensagem do WhatsApp.
  </Card>
</CardGroup>


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