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

# Mensajes y archivos

> Envía mensajes y descarga archivos de tu cuenta.

## Envía un mensaje

`POST /v1/messages` requiere `to`, `kind` y el objeto correspondiente: `text`, `template`, `reaction`, `location`, `contacts` o `interactive`. Image, audio, video, document y sticker usan `media`. Consulta campos y validaciones en la referencia.

Para archivos, incluye `id` o `link`. Audio no acepta caption/filename; video no acepta filename. Usa `replyToMessageId` para responder a un mensaje.

La respuesta usa el formato de Watahub, no el completo de Meta. `messageId` contiene el wamid cuando Meta lo devuelve. Sigue la entrega mediante [webhooks](https://docs.watahub.dev/es/webhooks.md).

## Sube y descarga

Sube con `POST /v1/media` mediante `multipart/form-data`, o con `POST /v1/media/{id}` usando un ID de teléfono. Fuera de la ruta, usa un selector documentado como `X-Phone-Number-Id`.

`GET /v1/media/{id}` devuelve una URL temporal de Meta, no el contenido. Esa URL requiere el token de Meta del número. Prefiere `GET /v1/media/{mediaId}/content` para descargar mediante Watahub sin exponer el token.

Solo puedes consultar archivos subidos o recibidos por tu cuenta. No presupongas que `/v1` incluye tipo MIME, checksum o tamaño de Meta.


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