# Специальные переменные

> Перед прочтением мы рекомендуем ознакомиться с общей статьей о переменных ([Переменные](/sozdanie-scenariev/peremennye.md))

{% hint style="info" %}
**Специальные переменные** - фиксированные, значения которых подставляет бот.
{% endhint %}

Специальные переменные отображаются в разделе **"переменные"** в первой вкладке:

![](/files/-M0iIaI3GiYaDAvE5Esp)

При использовании переменной, например, в тексте сообщения, бот заменит ключ переменной на значение:

![](/files/-M0iKZ2vQH-aHDdSInZj)

![](/files/-M0iKfe9fjAqDjJ7TOmn)

Отлично! Бот заменил переменную %имя% на имя пользователя ВКонтакте :star\_struck: 

Давайте рассмотрим основные специальные переменные:

| Ключ переменной | Подставлемое ботом значение |
| --------------- | --------------------------- |
| %сообщение%     | Сообщение пользователя      |
| %имя%           | Имя пользователя            |
| %фамилия%       | Фамилия пользователя        |
| %пол%           | Пол пользователя            |
| %время%         | Местное время               |
| %час%           | Часов по местному времени   |
| %минута%        | Минут по местному времени   |
| %дата%          | Дата по местному времени    |
| %город%         | Город пользователя          |
| %чат%           | Ссылка на чат               |

Со списком всех специальных переменных можно ознакомиться в разделе **переменные** в приложении.

## Переменные-функции

Среди специальных переменных существуют переменные-функции. Например, **%ранд(a, b)%** и **%дата+N%**.

При использовании таких переменных, вы можете заменить параметры (a, b, N), а бот в зависимости от них вычислит значение переменной.

Например, чтобы получить **случайное число** от 0 до 100, надо написать в тексте сообщения **%ранд(0, 100)%**:

![Использование переменной %ранд(a, b)%](/files/-M0iMQdfRAe8bMdQKq92)

![Пример вычисления случайного числа](/files/-M0iMbgmeZjjr7PZ8A9_)

Чтобы использовать переменную **%дата + N%**, нужно подставить параметр N, например, написать **%дата + 3%** (значит текущая дата + 3 дня):

![Пример использования %дата + N%](/files/-M0iN-WykbXmDKx5klF_)

С помощью специальных переменных вы можете выводить и использовать в условиях известные боту значения, а также те данные, которые передает ВКонтакте (например, имя и фамилию пользователя) :sunglasses: 


---

# 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.smartbot-vk.ru/sozdanie-scenariev/peremennye/specialnye-peremennye.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.