# Зарезервированные переменные

Переменные, с некоторыми именами нельзя создать. Но можно использовать :)&#x20;

Зарезервированная переменная - это переменная, которая создается платформой автоматически. Например, имя подписчика, его идентификатор, utm-метка, по которой он перешел. Эти данные фиксируются платформой, и в дальнейшем ты можешь использовать их.&#x20;

Список таких переменных :point\_down:&#x20;

### Часто используемые переменные&#x20;

| Переменная              | Описание переменной                                                                                                                                                                      |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| first\_name             | имя подписчика                                                                                                                                                                           |
| last\_name              | <p>фамилия подписчика <br>(если фамилии не было - может быть пустой)</p>                                                                                                                 |
| id                      | идентификатор подписчика **в платформе**                                                                                                                                                 |
| user\_id                | идентификатор подписчика **в мессенджере**                                                                                                                                               |
| gender                  | <p>пол пользователя</p><p><code>возможные значения:</code> </p><p><code>FEMALE - женщина,</code> </p><p><code>MALE - мужчина,</code> </p><p><code>NULL - не известно</code></p>          |
| created\_at             | дата создания подписчика в платформе                                                                                                                                                     |
| nickname                | Никнейм пользователя в Telegram                                                                                                                                                          |
| last\_request           | В этой переменной хранится вся входящая информация от мессенджера в случае активации триггера или получения сообщения. Чтобы включить работу переменной, нужно обратиться в техподдержку |
| photo\_max\_orig        | Cсылка на аватар пользователя (если аватара нет - будет null)                                                                                                                            |
| incoming\_message\_text | В этой переменной хранится текст последнего сообщения написанного пользователем                                                                                                          |

### JSON-переменные

Так же существуют JSON-переменные.&#x20;

| Переменная               | Описание переменной                                                                                                                                                                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| channel                  | <p>JSON-объект с информацией о канале<br>пример:</p><p><code>{</code><br>  <code>"id":"1945495217",</code><br>  <code>"name":"example\_channel",</code><br>  <code>"resource":"TG",</code><br>  <code>"token":"1945495217:AAF9shqpZPum62KweE7VsWVHrigBDDKg3U"</code><br><code>}</code></p> |
| channel.id               | ID канала                                                                                                                                                                                                                                                                                  |
| channel.name             | имя канала                                                                                                                                                                                                                                                                                 |
| channel.resource         | <p>код мессенджера</p><p><code>возможные значения:</code></p><p><code>VK - ВКонтакте</code></p><p><code>FB - Facebook</code></p><p><code>INST - Instagram</code></p><p><code>TG - Telegram</code></p><p><code>VIBER - Viber</code></p><p><code>EMAIL - Email</code></p>                    |
| channel.token            | токен канала                                                                                                                                                                                                                                                                               |
| last\_comment            | <p><strong>JSON-объект</strong> с информацией о комментарии пользователя<br><br><code>{</code><br><code>"id": "18110358151664656",</code><br><code>"text": "text",</code><br><code>"source\_id": "18195934504223416"</code><br><code>}</code></p>                                          |
| last\_comment.id         | ID комментария пользователя                                                                                                                                                                                                                                                                |
| last\_comment.text       | Текст комментария пользователя                                                                                                                                                                                                                                                             |
| last\_comment.source\_id | ID Поста                                                                                                                                                                                                                                                                                   |

### Переменные аналитики

| Переменная           | Описание переменной                                                                                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tracking             | <p>URL-params строка собранная из всех utm\_\* меток подписчика</p><p><code>пример:</code></p><p><code>utm\_source=yandex\&utm\_campaign=example</code></p> |
| utm\_source          | UTM Source метка подписчика                                                                                                                                 |
| utm\_medium          | UTM Medium метка подписчика                                                                                                                                 |
| utm\_campaign        | UTM Campaign метка подписчика                                                                                                                               |
| utm\_content         | UTM Content метка подписчика                                                                                                                                |
| utm\_term            | UTM Term метка подписчика                                                                                                                                   |
| first\_utm\_source   | Первая UTM Source метка подписчика                                                                                                                          |
| first\_utm\_medium   | Первая UTM Medium метка подписчика                                                                                                                          |
| first\_utm\_campaign | Первая UTM Campaign метка подписчика                                                                                                                        |
| first\_utm\_content  | Первая UTM Content метка подписчика                                                                                                                         |
| first\_utm\_term     | Первая UTM Term метка подписчика                                                                                                                            |

#### Небольшой комментарий для простоты понимания

Предвижу немой вопрос, что ещё за **first\_utm\_\*** переменные?&#x20;

Всё дело в том, что платформа фиксирует ВСЕ касания с клиентом. И первое, и второе, и пятое.

Например, подписчик зашёл на подписную страницу с меткой utm\_source=yandex. После чего снова увидел нашу рекламу, и подписался в другого бота с меткой utm\_source=google.&#x20;

В переменной first\_utm\_source будет значение yandex;

В переменной utm\_source будет значение google;

#### tracking переменная

tracking переменная собирается из всех актуальных utm\_\* переменных в строку формата url параметров.

Звучит немного пугающе, но на практике всё просто. Рассмотрим пример.&#x20;

Есть задача - вести трафик с рекламных сетей на бота, прогревать подписчика в боте, и уводить на свой итоговый лендинг. Так же мы хотим, чтобы при переходе на итоговый лендинг передавались все utm-метки, которые были у подписчика, для аналитики.

Мы можем собрать подобную конструкцию:

> <https://example.com/page\\_1?utm\\_source=({utm\\_source})\\&utm\\_mediium=({utm\\_medium})\\&utm\\_campaign=({utm\\_campaign})\\&utm\\_term=({utm\\_term})\\&utm\\_content=({utm\\_content})>

Она будет выполнять нашу задачу, но выглядит как-то громоздко и неудобно.

С помощью переменной tracking мы можем сократить эту конструкцию до такой:

> example.com/page\_&#x31;**?**({tracking})

Если у нашей ссылки уже были какие-то параметры, просто добавь перед этой переменной символ &

> example.com/page\_1?parameter=valu&#x65;**&**({tracking})

## Остались вопросы?

Если тебе что-то не понятно - напиши нам в поддержку, мы с радостью тебе всё объясним и решим твой вопрос :)

{% content-ref url="/pages/-MasAPNcg291uNezFqb4" %}
[Как задать вопрос в поддержку?](/kak-zadat-vopros-v-podderzhku.md)
{% endcontent-ref %}


---

# 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.leadconverter.su/peremennye/zarezervirovannye-peremennye-1.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.
