В этой статье мы собрали всю необходимую информацию о переменных в сервисе 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}} — Описание ресурса, в который происходит отправка сообщения, приветствия и пр.