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

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

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

<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

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

<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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.graspil.com/ru/app/outside-links.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.