---
title: "Enviar archivo (documento, imagen, etc.)"
method: POST
path: "/send/media"
tags: ["Message"]
---

# Enviar archivo (documento, imagen, etc.)

`POST /send/media`

Envía un archivo a un **chat** o **grupo**. En `number`: persona → E.164 sin +; grupo → **JID** (`...@g.us`). En `file`: archivo **local** → **Base64**; en **internet** → **URL** (`https://...`). `Content-Type: application/json` y Bearer.

## Request body

- WhatsappSendMediaRequest
  - `number` string, required — Destino del mensaje. **Persona (chat individual):** número con código de país, **sin** el símbolo + (ej. Perú: `51999999997`). **Grupo:** el **JID** del grupo, p. ej. `120363423133649225@g.us` (como en el campo `JID` al listar grupos).
  - `file` string, required — Si el archivo es **local** (solo en tu equipo o sin URL pública), envíalo en **Base64**. Si **no** es local y está publicado en internet, envía la **URL** (`https://...`, accesible por el servidor que envía a WhatsApp).
  - `filetype` string, required — Tipo de medio. Ejemplos: `document`, `image`, `video`, `audio`
  - `filename` string — Nombre de archivo que verá el destinatario con su extensión
  - `caption` string — Texto opcional que acompaña al medio.

## Response `200`

Envío exitoso.

- WhatsappApiOkResponse
  - `success` boolean, required
  - `message` string, required
  - `data` object, required — Carga útil adicional del proveedor; puede venir vacío.

## Other responses

- `400` — Solicitud inválida.
- `401` — Token inválido o ausente.

---

[API](https://skmtc.net/json/apis/json-pe-api-consulta-ruc-dni-placa-soat-licencia-de-conducir.md) · [All operations](https://skmtc.net/json/apis/json-pe-api-consulta-ruc-dni-placa-soat-licencia-de-conducir/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/json/json-pe-api-consulta-ruc-dni-placa-soat-licencia-de-conducir/revisions/7d6e90afad50/schema)