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

# Mensagens e mídias

> Envie mensagens e baixe mídias da sua conta.

## Envie uma mensagem

`POST /v1/messages` exige `to`, `kind` e o objeto correspondente: `text`, `template`, `reaction`, `location`, `contacts` ou `interactive`. Image, audio, video, document e sticker usam `media`. Confira campos e validações na referência.

Para mídias, inclua `id` ou `link`. Áudio não aceita caption/filename; vídeo não aceita filename. Use `replyToMessageId` para responder a uma mensagem.

A resposta usa o formato do Watahub, não o completo da Meta. `messageId` contém o wamid quando fornecido pela Meta. Acompanhe a entrega com [webhooks](https://docs.watahub.dev/pt-BR/webhooks.md).

## Envie e baixe arquivos

Envie com `POST /v1/media` usando `multipart/form-data`, ou `POST /v1/media/{id}` com um ID de telefone. Fora da rota, use um seletor documentado como `X-Phone-Number-Id`.

`GET /v1/media/{id}` retorna uma URL temporária da Meta, não o conteúdo. A URL exige o token da Meta do número. Prefira `GET /v1/media/{mediaId}/content` para baixar pelo Watahub sem expor esse token.

Somente mídias enviadas ou recebidas pela conta são acessíveis. Não presuma que `/v1` inclua tipo MIME, checksum ou tamanho da Meta.


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