> ## 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 Link com Preview

> Envia uma mensagem com link e preview personalizado

## Descrição

Envia uma mensagem contendo um link com preview personalizado (título, descrição e imagem thumbnail). Permite controlar como o link será exibido para o destinatário, independente do preview padrão da URL.

## Request

### Headers

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

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "message": "Confira nosso site!",
  "image": "https://exemplo.com/thumb.jpg",
  "linkUrl": "https://bliper.io",
  "title": "Bliper API",
  "linkDescription": "API WhatsApp profissional"
}
```

| Campo             | Tipo   | Obrigatório | Descrição                                        |
| ----------------- | ------ | ----------- | ------------------------------------------------ |
| `phone`           | string | Sim         | Número do destinatário no formato DDI+DDD+número |
| `message`         | string | Sim         | Texto principal da mensagem                      |
| `linkUrl`         | string | Sim         | URL do link a ser compartilhado                  |
| `image`           | string | Não         | URL da imagem thumbnail do preview               |
| `title`           | string | Não         | Título exibido no card de preview                |
| `linkDescription` | string | Não         | Descrição exibida no card de preview             |

## 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-link' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Confira nosso site!",
    "image": "https://exemplo.com/thumb.jpg",
    "linkUrl": "https://bliper.io",
    "title": "Bliper API",
    "linkDescription": "API WhatsApp profissional"
  }'
```

<Tip>Use este endpoint quando quiser personalizar o preview do link, como em campanhas de marketing ou compartilhamento de conteúdo com visual customizado.</Tip>