В этой статье мы собрали всю необходимую информацию о переменных в сервисе PuzzleBot.

Переменные — название функции, которая позволяет подставлять определенные значения индивидуально под каждого пользователя. Все переменные имеют общий вид {{NAME}} для обозначения используются двойные фигурные скобки с двух сторон и "a-z" "A-Z" "0-9" "_" для названия переменной.

Например: для приветствия пользователя по имени при входе в бота или группу.

Обратите внимание, что в Форме ввода, в поле "Переменная" указывать {{}} не нужно, сервис автоматически подставит их за вас.

Важно! Команда /start исключается из ответа на форму и выполняется вне зависимости от маски. 

Все переменные встречающиеся в сервисе PuzzleBot можно разделить на три группы:

1. Переменные общие (работают везде);
2. Переменные работающие только в боте;
3. Переменные работающие только в ресурсах (чатах и каналах).

Разберем каждую группу.

Переменные общие

Данная группа переменных создана администраторами сервиса и она: 

• Не подлежит редактированию;
• Работает и в боте и в ресурсах (каналах и группах).

1. {{BOT_NAME}} — Название бота (ссылкой);
   {{BOT_NAME_TEXT}} — Название бота;
   
   
   
2. {{BOT_USERNAME}} — Юзернейм бота (ссылкой);
   {{BOT_USERNAME_TEXT}} — Юзернейм бота;
   
   
   
3. {{HOURS}} — Часы (двузначное число);
   
   
   
4. {{MINUTES}} — Минуты (двузначное число);
   
   
   
5. {{SECONDS}} — Секунды (двузначное число);
   
   
   
6. {{DAY}} — День в месяце (двузначное число);
   
   
   
7. {{MONTH}} — Номер месяца (двузначное число);
   {{MONTH_TEXT}} — Месяц (текстом);
   
   
   
8. {{YEAR}} — Год (четырёхзначное число);
   
   
   
9. {{WEEKDAY}} — День недели (текстом);
   
   
   
10. {{USD}} — Курс доллара (берётся с cbr.ru, отображается в долларах);
    
    
    
11. {{EUR}}  — Курс евро (берётся с cbr.ru, отображается в долларах);
    
    
    
12. {{BTC}}  — Курс Bitcoin (берётся с CoinMarketCup);
    
    
    
13. {{ETH}}  — Курс Etherium (берётся с CoinMarketCup);
    
    
    
14. {{BIP}}  — Курс BIP блокчейна Minter (берётся с CoinMarketCup);
    
    
    
15. {{HUB}}  — Курс HUB блокчейна Minter (берётся с CoinMarketCup);

Работают только в боте или в ресурсах, но при событиях (приветствие новых пользователей или триггеры):

1. {{FIRST_NAME}} — Имя пользователя (ссылкой); 
   {{FIRST_NAME_TEXT}} — Имя пользователя;
   
   
   
2. {{LAST_NAME}} — Фамилия пользователя (ссылкой);
   {{LAST_NAME_TEXT}} — Фамилия пользователя;
   
   
   
3. {{USERNAME}} — Юзернейм пользователя (ссылкой);
   {{USERNAME_TEXT}} — Юзернейм пользователя;
   
   
   
4. {{USER_ID}} — ID пользователя в Telegram (ссылкой);
   {{USER_ID_TEXT}} — ID пользователя в Telegram;
   
   
   
5. {{CATEGORY_NAME}} или {{CATEGORY_NAMES}} — Название категории, в которой находится пользователь.
   
   
   
6. {{JOIN_DATE}} — Дата входа в бота или ресурс (в формате “26.06.2020 15:41:29”);
   
   
   
7. {{ACTIVE_SCENARIOS}} — Активные сценарии (названия текстом через запятую);

Важно! Все переменные даты и времени берут значения относительно часового пояса заданного в настройках аккаунта.

Переменные работающие только в боте

Пользовательская группа переменных, формируемая за счет Форм ввода и вкладки Вход, подробнее: Форма ввода.

Переменные работающие только в ресурсах

1. Все общие переменные;
   
   
   
2. {{RES_TITLE}} — Название ресурса, в который происходит отправка сообщения, приветствия и пр. (ссылкой);
   {{RES_TITLE_TEXT}} — Название ресурса, в который происходит отправка сообщения, приветствия и пр.;
   
   
   
3. {{RES_DESCRIPTION}} — Описание ресурса, в который происходит отправка сообщения, приветствия и пр.