ChatKeeperBot

# Плейсхолдеры

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

Внимание

Все условия кроме самих плейсхолдеров заданы для примера

# Базовые плейсхолдеры

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

В качестве примера, мы рассмотрим установку плейсхолдеров в триггере:

# Информация о сообщениях

Два плейсхолдера ниже срабатывают на отправленные реплаем сообщения.

# %message% – текст сообщения

# %reply_message% – текст сообщения реплая

# Информация о чате

# %chat_id% – уникальный id чата

# %chat_title% – название чата

# %chat_login% – юзернейм чата (если он имеется)

# %reputation_url% – ссылка на репутацию

# Плейсхолдеры для форм

Для команд с формами необходимо:

  1. Перейти на страницу «Триггеры»
  2. Открыть расширенные настройки
  3. Выбрать форму, по которой вы хотите получить отчет
  4. В действиях написать нужные команды

# %form_name% – название формы

# %form_description% – описание формы

# %form_open_count% – количество переходов на форму

# %form_responce_count% – количество заполненных форм

# %form_url% – ссылка на форму

# Капча

Капча вписывается только в приветственное сообщение.

Когда тумблер «Проверять новых пользователей» включен, и в качестве проверки стоит математическая капча, укажите один или оба плейсхолдера в приветственном сообщении:

# %captcha% – капча в цифрах (например: 25)

# %captcha_txt% – капча прописью (например: двадцать пять)

Выглядеть это будет так:

В настройках:

В чате:

# Информация банах и предупреждениях используется в фильтрах модерации

# %total_warning_count% – общее количество предупреждений

# %warning_count% – количество предупреждений за период

# %max_warning_count% – максимальное количество предупреждений

# %banlevel% - уровень по бану

Подсказка

Пишется при получении бана

# %banreason% – причина бана

# %bantime% – время бана в минутах

# %bantime_sec% – время бана в секундах

# %bantime_time_str% – время бана с днями

# %bantime_str% – время бана временной строкой 00:05:00

# %bantime_to_hr% - время бана «на сколько» прописью

# Плейсхолдеры используемые в любых полях ввода

Такие плейсхолдеры используются чаще в развлекательных целях. енератор случайных чисел может использоваться для конкурсов.

# %timestamp% - текущее время в UNIX-системе

# %timestamp_ms% - текущее время в UNIX-системе в миллисекундах

# %rand% – генерирует случайное число до миллиона

# %rand10% – генерирует случайное число до 10

# %rand100% – генерирует случайное число до 100

# %rand1000% – генерирует случайное число до 1000

# %guid% – создание уникального 128-битного кода

# Префиксы по пользователю

Подсказка

Префиксы по пользователю и возможные значения используются совместно.

Для того чтобы совместить префиксы, и возможные значения просто соедините команды.

Например, посмотрим сколько дней непрерывных сообщений у инициатора триггера: %actor_days_with_message%, где %actor_ - инициатор, а days_with_message% - дней непрерывных сообщений

# %actor - инициатор

Инициатор – это пользователь, который вызвал триггер. Задавая этот плейсхолдер можно узнать о себе информацию по репутации, рейтингу, опыту, количество дне в чате, количество написанных сообщений, ранг в чате.

Аналог такого плейсхолдера:

# %caller – пользователь, который вызвал триггер

# %target_ - цель

Цель – это пользователь, в ответ которому был вызван триггер. Например, чтобы узнать про определенного пользователя в чате, вам необходимо ответом прислать слово, заданное в условиях триггера.

Аналог такого плейсхолдера:

# %reply_ – пользователь, на которого был сделан реплай

# %overtake_ – пользователь, которого обогнали по количеству репутации

Реакцией на такой плейсхолдер будет логин пользователя, которого только что обогнали по количеству репутации.

# %reputation_ - репутация при выдаче репутации

Этот плейсхолдер используется только при выдаче репутации, поэтому лучше вписать его в поле о репутации.

# Информация по случайным пользователям

Внимание

Работает только на тарифах Advanced и Ultimate

# %rnd_user_ (1-31) – случайный пользователь из всех (от 1 до 31)

# %rnd_active_user_ – случайный пользователь из активных (от 1 до 31)

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

В одном призыве команды присваивается каждому свой номер. То есть, если бот выбрал Олесю под номером 1, то информация о репутации будет тоже под номером 1.

Подсказка

В каждом призыве команды бот будет присваивать разные номера, разным пользователям

Наглядный пример на картинке:

# Информация о написанных сообщениях

Внимание

Работает только на тарифах Advanced и Ultimate

# %msg_prev_day_ – количество сообщений за предыдущий день

# %msg_prev_days_ – количество сообщений за предыдущие дни

Количество сообщений по дням пишется таким образом, чтобы в конце была переменная, то есть за какой день, если 0 — это за сегодня, 1 — это за вчера и т.д.

Выглядит таким образом: %msg_prev_day_1%

Во втором случае, количество сообщений за период дней. Количество сообщений за последние два дня будет выглядеть так: %msg_prev_days_2%

# Возможные значения для префиксов по пользователям

# Информация по пользователям

Совмещайте префиксы по пользователям и возможные значение по конкретным и случайным пользователям. С помощью этого вы узнаете юзернейм, логин, ссылку, id пользователя, рейтинг, репутацию и количество очков.

Например, нужно узнать всю информацию об определенном пользователе.

Рассмотрим на примере якорей.

Напишем триггер, на который среагирует бот. Зададим реакцию, совместив нужные префиксы:

В чате, в ответ на нужного участника, пишем установленный триггер:

# username% - юзернейм пользователя

# login% – логин пользователя

# user_id% – id пользователя

# Информация о рефералах

Внимание

Работает только на тарифах Advanced и Ultimate

# %referrals_url% - список всех рефералов

# _referral_url% - конкретный пользователь-реферал

# Информация о репутации и рейтинге

# reputation% - репутация

Значение положительной репутации.

# anti_reputation% - отрицательная репутация

Если репутация положительная, то значение будет 0.

# rating% – рейтинг (всегда не меньше нуля)

При рейтинге рассчитывается среднее значение положительной и отрицательной репутации.

# action_points% – количество очков действий

Количество заработанных очков в чате.

# Информация о рангах, сообщении

# days_in_chat% – количество дней в чате

Значение с первого дня участия в чате.

# days_from_first_message% – количество дней с первого сообщения

Значение с первого написанного вами сообщения в чате.

# rank% - ранг

Значение ранга в конкретном чате цифрой.

# rank_title% – ранг

Значение ранга в конкретном чате словам.

Например: если ранг цифрой 3, то словами будет «новичок».

# days_with_message% – сколько дней непрерывных сообщений

Значение показывает сколько дней подряд непрерывно приходили сообщения от конкретного пользователя.

# msg_count% – количество сообщений

Количество сообщений за все время в чате от конкретного пользователя.

# xp% - опыт

Значение опыта пользователя.

# xp_next_rank% – количество очков, которое осталось до следующего ранга.

# %earned_xp% – количество заработанного опыта

Количество опыта, заработанного конкретно в этот момент.

← Команды →