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

# Subir archivos multimedia de WhatsApp

> Sube archivos multimedia y usa el ID de archivo multimedia devuelto en las solicitudes de mensajes de WhatsApp.

## Qué es

La API de medios sube una imagen, video, archivo de audio, sticker o documento a través de la WhatsApp Business API. El ID de archivo multimedia devuelto puede referenciarse en una solicitud posterior de mensaje de WhatsApp.

## Antes de comenzar

* Conecta y registra el número de teléfono de WhatsApp remitente.
* Guarda tu clave de API de YCloud de forma segura.
* Prepara un archivo que cumpla con los tipos de archivos multimedia admitidos y los límites de tamaño de Meta.
* Comprueba si el tipo de mensaje de destino admite un ID de archivo multimedia o requiere una URL.

## Cómo funciona

1. Sube el archivo para el número de teléfono remitente.
2. Guarda el ID de archivo multimedia devuelto.
3. Coloca el ID de archivo multimedia en el objeto de contenido correspondiente del mensaje de WhatsApp.
4. Envía el mensaje antes de que el archivo multimedia subido caduque.

Los archivos subidos están cifrados y se conservan durante 30 días.

## Solicitud

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

Envía el archivo 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"
```

Usa el número de teléfono comercial registrado en formato E.164.

## Respuesta

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

Guarda `id` y úsalo en el objeto multimedia para una solicitud admitida de mensaje de WhatsApp.

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

## Uso de archivos multimedia

Un ID de archivo multimedia está vinculado al almacenamiento de medios de WhatsApp y caduca después de 30 días. Súbelo de nuevo cuando el ID ya no sea válido.

Los encabezados de mensajes interactivos no pueden usar un ID de archivo multimedia para imágenes, documentos, videos o audio. Usa un enlace de acceso público para esos elementos de encabezado.

## Límites y resolución de problemas

* Envía el tipo MIME correcto con el archivo subido.
* Verifica los tipos de archivos multimedia admitidos y los límites de tamaño de Meta antes de subir.
* No reutilices un ID de archivo multimedia caducado.
* Mantén alineados el número de teléfono de subida y el del remitente del mensaje.
* Para recursos públicos reutilizables, un enlace puede ser más sencillo que subirlos repetidamente cuando
  el esquema del mensaje lo admita.

<CardGroup cols={2}>
  <Card title="API para subir archivos multimedia" icon="upload" href="/api-reference/whatsapp-media/upload-media">
    Inspecciona el esquema de solicitud y respuesta multipart.
  </Card>

  <Card title="Enviar mensajes con archivos multimedia" icon="image" href="/es/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Añade el ID de archivo multimedia devuelto a una solicitud de mensaje de WhatsApp.
  </Card>
</CardGroup>


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