> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/app/outside-links.md).

# Ссылки из бота

Для трекинга переходов по внешним ссылкам из бота можно использовать наши специальные ссылки. При переходе по такой ссылке, автоматически будет создано соответствующее событие у указанного пользователя. Плюс будет определена геопозиция пользователя.

Ссылки могут быть двух форматов, но обязательно должны содержать следующие параметры

<table><thead><tr><th width="143.40625">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td>key</td><td>Ключ для ссылки который вы получаете в личном кабинете</td></tr><tr><td>url</td><td>http/https адрес куда нужно переадресовать пользователя. <mark style="background-color:red;">Адрес должен быть закодирован</mark> с помощью URL кодирования. Примеры функций: <code>encodeURIComponent</code> в <strong>JS</strong>, <code>urlencode</code> в <strong>PHP,</strong> <code>urllib.parse.quote</code> в <strong>python</strong></td></tr><tr><td>uid</td><td>Telegram ID пользователя, которой переходит по ссылке (кому вы отправляете это сообщение)</td></tr><tr><td>event</td><td>Название события, латиницей. Макс. 250 символов. Именно это название вы будете видеть в отчетах</td></tr></tbody></table>

{% hint style="warning" %}

### Интерфейс настройки ссылок еще не готов, но вы уже можете использовать их. Чтобы получить ключ key для ссылки обратитесь в поддержку :)

{% endhint %}

### Формат 1

Вы можете поместить все вышеперечисленные переменные в параметры ссылки (после символа ?), т.е.

<https://tlin.cc/i?**key**=><mark style="color:red;">**вашКлюч**</mark>&**url**=<mark style="color:purple;">**urlАдрес**</mark>&**uid**=<mark style="color:yellow;">**123**</mark>&**event**=<mark style="color:green;">**названиеСобытия**</mark>

{% code title="Пример ссылки" overflow="wrap" %}

```
https://tlin.cc/i?key=12mew345&url=https%3A%2F%2Fexample.com&uid=123456&event=myevent
```

{% endcode %}

### Формат 2

Этот формат немного короче. Переменные разделяются слэшем, сохраняйте правильный порядок переменных

<https://tlin.cc/i/><mark style="color:red;">**key**</mark>/<mark style="color:green;">**event**</mark>/<mark style="color:yellow;">**uid**</mark>?**url**=<mark style="color:purple;">**urlАдрес**</mark>

{% code title="Пример ссылки" overflow="wrap" %}

```uri
https://tlin.cc/i/12mew345/myevent/123456?url=https%3A%2F%2Fexample.com
```

{% endcode %}