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

# Introdução

> Encurte links, deixe a mensagem mais limpa e saiba quem clicou.

<Tip>
  **Link curto** = URL amigável (`clicar.co/promo`) que **redireciona** e **registra o clique**. **Smart Link** liga o clique à mensagem original; **conversão** liga o clique ao pedido no seu site.
</Tip>

## O que são Links curtos na Notifique?

É o add-on de **rastreamento de cliques**: transforma URLs longas em links curtos e mostra quem clicou, quando e de onde.

Funciona no **painel** (Add-ons → Links curtos) ou na **API v1** (`/v1/short-links`).

## Quando usar

| Situação                                         | Use?                                          |
| ------------------------------------------------ | --------------------------------------------- |
| Campanha com link em SMS, WhatsApp, e-mail, push | **Sim**                                       |
| Medir cliques e ligar ao envio                   | **Sim**                                       |
| Atribuir venda ao `msg_id` da mensagem           | **Sim**, Smart Links + `POST /v1/conversions` |
| Só texto sem URL                                 | Não precisa                                   |

## Como funciona na prática

1. Ative encurtamento nas **configurações do workspace** (automático) ou crie links manualmente
2. A pessoa clica → **redirecionamento** em milissegundos → clique **registrado**
3. Painel e API mostram totais, gráficos e cada clique
4. Webhooks avisam seu sistema (`short_link.clicked`, `message.clicked`, `conversion.attributed`)

<Info>
  Cada API Key pertence a **um** workspace. Na v1 **não** envie `x-workspace-id`, se vier preenchido, a API responde **400**.
</Info>

## O que não são Links curtos

* **Forms**, captura de leads ([Forms](/marketing-addons-api/como-funciona/introducao))
* **Webhooks de entrega** de canal, veja o canal (SMS, WhatsApp…) ou [Webhooks](/guides/webhooks/index)

## API v1

Rotas `/v1/short-links` e `POST /v1/conversions`. Escopos: `short_links:read`, `short_links:manage`, `conversions:manage`. Specs no menu lateral desta seção.

## Próximos passos

* [Quick Start](/short-links-api/como-funciona/quick-start)
* [Smart Links e conversões](/short-links-api/como-funciona/smart-links-e-conversoes)
* [Escopos da API Key](/short-links-api/como-funciona/escopos-da-api-key)
* [Eventos de webhooks](/short-links-api/como-funciona/eventos-do-webhooks)