> ## 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 and conversions

> Automatic shortening, UTMs, click attribution, and order registration.

<Tip>
  **Automatic** = each URL in a message becomes a tracked short link. **Conversion** = your backend confirms the order with the tracked `msg_id`.
</Tip>

## Automatic shortening

Enable **“Shorten links automatically”** in workspace settings. Every link in WhatsApp, SMS, email, Telegram, push, or RCS becomes a short link **with no extra code**.

Each automatic link carries metadata tying the click to the **original message**, “Clicked” status in the dashboard and `message.clicked` webhook.

***

## Manual links

Dashboard or `POST /v1/short-links` for:

* Sharing outside a campaign
* **Custom code** (`clicar.co/winter-promo`), 4–32 chars, letters, numbers, `-` and `_`
* **Expiration**, after expiry, visitors see “link expired”

***

## Smart Links and ROI

1. Message goes out with tracked link (automatic or manual with `msg_id`)
2. User clicks → `short_link.clicked` or `message.clicked`
3. At checkout, your site sends conversion:

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

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

Scope: **`conversions:manage`**. **`conversion.attributed`** webhook confirms attribution.

***

## Domain

Default: **`clicar.co`**. Custom domain (e.g. `link.yoursite.com`) in advanced options, contact support.

***

## Limits

* Up to **300 clicks/minute** per IP
* Malicious URLs blocked automatically
* Pause or deactivate any link anytime

***

## Next steps

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