# Enviar archivo

> Envía una imagen, un video, un audio o un documento a un contacto.

Fuente: https://developers.plazbot.com/whatsapp/cli/send-file/

### Enviar archivo

Envía una imagen, un video, un audio o un documento, subiendo un archivo local o desde una URL pública.

```bash
plazbot whatsapp send-file -p <número> (-f <archivo> | -u <url>) [opciones]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Teléfono | `-p, --phone <number>` | Sí | Número del contacto en formato internacional. |
| Archivo | `-f, --file <path>` | Sí* | Archivo local a subir. |
| URL | `-u, --url <url>` | Sí* | URL pública del archivo, en lugar de `--file`. |
| Texto | `-c, --caption <text>` | No | Texto que acompaña a la imagen, el video o el documento. |
| JSON | `--json` | No | Imprime `{ phone, status, contactId }`. |

\* Usa `--file` o `--url`.

**Formatos:** imágenes JPG o PNG · video MP4 o 3GP · audio MP3, M4A, OGG, AAC o AMR · documentos PDF, Word, Excel y otros.

### Ejemplos

```bash
# PDF con texto
plazbot whatsapp send-file -p +51912345678 -f ./factura.pdf -c "Tu factura de octubre"

# Imagen desde una URL
plazbot whatsapp send-file -p +51912345678 -u https://example.com/promo.png
```

> **Info:** Como cualquier mensaje libre, solo sale dentro de las 24 horas desde el último mensaje del contacto. Fuera de esa ventana, envía una plantilla con archivo en el encabezado con [`send-template --file-url`](https://developers.plazbot.com/whatsapp/cli/send-template).