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

# Smart Links e conversões

> Encurtamento automático, UTMs, atribuição de clique e registro de pedidos.

<Tip>
  **Automático** = cada URL na mensagem vira link curto com marcação do envio. **Conversão** = seu backend confirma o pedido com o `msg_id` rastreado.
</Tip>

## Encurtamento automático

Ative **“Encurtar links automaticamente”** nas configurações do workspace. Todo link em WhatsApp, SMS, e-mail, Telegram, push ou RCS vira link curto **sem código extra**.

| Canal    | Onde encurta           |
| -------- | ---------------------- |
| WhatsApp | Texto, legenda, botões |
| SMS      | Corpo                  |
| E-mail   | Links no HTML          |
| Telegram | Texto                  |
| Push     | Links da notificação   |
| RCS      | Texto e botões         |

Cada link automático carrega marcação que liga o clique à **mensagem original**, status “Clicado” no painel e webhook `message.clicked`.

***

## Links manuais

No painel ou `POST /v1/short-links` para:

* Compartilhar fora de uma campanha
* **Código personalizado** (`clicar.co/promo-inverno`), 4–32 caracteres, letras, números, `-` e `_`
* **Validade**, após expirar, visitante vê “link expirado”

***

## Smart Links e ROI

1. Mensagem sai com link rastreado (automático ou manual com `msg_id`)
2. Pessoa clica → evento `short_link.clicked` ou `message.clicked`
3. No checkout, seu site envia conversão:

```http theme={null}
POST /v1/conversions
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "msg_id": "id_da_mensagem",
  "order_id": "PED-12345",
  "value": 149.90,
  "currency": "BRL"
}
```

Escopo: **`conversions:manage`**. Webhook **`conversion.attributed`** confirma a atribuição.

***

## Domínio

Padrão: **`clicar.co`**. Domínio próprio (ex.: `link.seusite.com`) nas opções avançadas, fale com o suporte.

***

## Limites

* Até **300 cliques/minuto** por IP
* URLs maliciosas bloqueadas automaticamente
* Pause ou desative qualquer link quando quiser

***

## Próximos passos

* [Quick Start](/short-links-api/como-funciona/quick-start)
* [Eventos de webhooks](/short-links-api/como-funciona/eventos-do-webhooks)
* [Escopos da API Key](/short-links-api/como-funciona/escopos-da-api-key)