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

# Enviar Documento

> Envia um arquivo como documento (PDF, DOC, MP4, etc)

## Descrição

Envia um arquivo como documento para um contato ou grupo. Diferente dos outros endpoints de mídia, o arquivo é enviado como um anexo para download, independente do tipo. Suporta PDF, DOC, XLSX, MP4 e qualquer outro formato.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "document": "https://exemplo.com/arquivo.pdf",
  "caption": "Segue o documento solicitado",
  "delayMessage": 1000
}
```

| Campo          | Tipo   | Obrigatório | Descrição                                          |
| -------------- | ------ | ----------- | -------------------------------------------------- |
| `phone`        | string | Sim         | Número do destinatário no formato DDI+DDD+número   |
| `document`     | string | Sim         | URL pública do arquivo a ser enviado               |
| `caption`      | string | Não         | Legenda ou descrição do documento                  |
| `delayMessage` | number | Não         | Aguarda N milissegundos antes de enviar a mensagem |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-document/mp4' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "document": "https://exemplo.com/arquivo.pdf",
    "caption": "Segue o documento solicitado"
  }'
```

<Note>O endpoint aceita qualquer tipo de arquivo. Use a URL do arquivo no campo `document`. O arquivo será exibido como anexo para download no WhatsApp.</Note>