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

# Introduction

> Shorten links, keep messages clean, and know who clicked.

<Tip>
  **Short link** = friendly URL (`clicar.co/promo`) that **redirects** and **logs the click**. **Smart Link** ties the click to the original message; **conversion** ties the click to an order on your site.
</Tip>

## What are Short links in Notifique?

The **click tracking** add-on: turn long URLs into short links and see who clicked, when, and from where.

Works in the **dashboard** (Add-ons → Short links) or **v1 API** (`/v1/short-links`).

## When to use

| Situation                                        | Use?                                          |
| ------------------------------------------------ | --------------------------------------------- |
| Campaign with link in SMS, WhatsApp, email, push | **Yes**                                       |
| Measure clicks and tie to a send                 | **Yes**                                       |
| Attribute sale to message `msg_id`               | **Yes**, Smart Links + `POST /v1/conversions` |
| Text only, no URL                                | Not needed                                    |

## How it works

1. Enable shortening in **workspace settings** (automatic) or create links manually
2. User clicks → **redirect** in milliseconds → click **logged**
3. Dashboard and API show totals, charts, and each click
4. Webhooks notify your system (`short_link.clicked`, `message.clicked`, `conversion.attributed`)

<Info>
  Each API Key belongs to **one** workspace. In v1 **do not send** `x-workspace-id`, if present, the API returns **400**.
</Info>

## What Short links are not

* **Forms**, lead capture ([Forms](/en/marketing-addons-api/como-funciona/introducao))
* **Channel delivery webhooks**, see the channel or [Webhooks](/en/guides/webhooks/index)

## v1 API

Routes `/v1/short-links` and `POST /v1/conversions`. Scopes: `short_links:read`, `short_links:manage`, `conversions:manage`. Specs in this section's sidebar.

## Next steps

* [Quick Start](/en/short-links-api/como-funciona/quick-start)
* [Smart Links and conversions](/en/short-links-api/como-funciona/smart-links-e-conversoes)
* [API Key scopes](/en/short-links-api/como-funciona/escopos-da-api-key)
* [Webhook events](/en/short-links-api/como-funciona/eventos-do-webhooks)