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

# Enviar uma mensagem de mídia — POST /v1/messages/send

> Envie imagem, vídeo, documento ou áudio de WhatsApp usando o modo de mídia direta do POST /v1/messages/send com autenticação x-api-key.

# Enviar uma mensagem de mídia

Mídia direta é um dos três modos mutuamente exclusivos do **único** endpoint de envio — não existe um endpoint separado `/messages/media`:

```text theme={null}
POST https://pilotstatus.com.br/v1/messages/send
```

## Requisição

Autentique com sua chave de API **com escopo de número** no header `x-api-key`. Envie `media` + `mediaType` **sem** `templateId` e **sem** `text`.

<ParamField body="destinationNumber" type="string" required>
  Telefone de destino em **E.164** com `+` inicial (ex.: `+5511999999999`).
</ParamField>

<ParamField body="media" type="string" required>
  Uma **URL http(s) pública** ou um **data URI base64** (ex.: `data:image/png;base64,...`). Base64 funciona em números **Meta Cloud API**; números **não oficiais (Pilot Status web)** exigem uma URL pública.
</ParamField>

<ParamField body="mediaType" type="string" required>
  `image`, `video`, `document` ou `audio`.
</ParamField>

<ParamField body="caption" type="string">
  Legenda opcional para `image`, `video` e `document` — **não** suportada para `audio`.
</ParamField>

<CodeGroup>
  ```bash Imagem com legenda theme={null}
  curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
    -H "Content-Type: application/json" \
    -H "x-api-key: ps_sua_chave_aqui" \
    -d '{
      "destinationNumber": "+5511999999999",
      "media": "https://cdn.example.com/photo.jpg",
      "mediaType": "image",
      "caption": "Aqui está o seu comprovante"
    }'
  ```

  ```bash Nota de voz (áudio) theme={null}
  curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
    -H "Content-Type: application/json" \
    -H "x-api-key: ps_sua_chave_aqui" \
    -d '{
      "destinationNumber": "+5511999999999",
      "media": "https://cdn.example.com/voice.ogg",
      "mediaType": "audio"
    }'
  ```
</CodeGroup>

## Resposta (202)

```json theme={null}
{
  "id": "msg_abc",
  "correlationId": "corr_123",
  "status": "QUEUED"
}
```

## Observações

* `audio` é sempre entregue como uma **nota de voz (PTT)** do WhatsApp.
* Neste modo, `buttons`, `header`, `footer` e `variables` **não são permitidos** — para combinar mídia com botões, use um envio de template (veja [Enviar interativos](/pt-BR/api/messages/send-interactive)).
* Para formatos, limites de tamanho e diferenças entre provedores, veja o [guia de mensagens de mídia](/pt-BR/guides/media-messages); para a lista completa de parâmetros, veja [Enviar uma mensagem](/pt-BR/api/messages/send).