June 30, 2023

Руководство по использованию XP Bot

Содержание

  1. Установка бота
  2. Назначение прав администратора
  3. Список команд
  4. Часто задаваемые вопросы
  5. Общие понятия

Установка бота

1. Начните диалог с ботом

2. Нажмите на кнопку "Добавить бота в чат"

3. Выберите чат, в который вы хотите добавить бота

4. Готово!

Назначение прав администратора

Для того, чтобы работали все функции, боту необходимы следующие права: "Удаление сообщений", "Выбор администраторов".

Если вы не хотите давать боту права администратора и при этом у вас скрыт список участников в чате, то вы можете назначить его администратором без прав:

Список команд

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

Например, для просмотра информации о чате можно написать /about, !about, .about или about.

/about

Аналоги: о чате, инфа чат

Только для чатов

Команда для получения технической информации о чате.

Использование: /about

Очень желательно прикладывать скриншот этой команды при обращении в тех. поддержку - это позволит быстрее разобраться в сути проблемы.

/check

Аналоги: бот, пинг, чек

Команда для проверки того, работает ли бот.

Использование: /check

Если бот не отвечает, то это либо проблема со стороны Телеграма (до бота не доходят сообщения), либо он временно отключен для обслуживания/апгрейда. В таком случае, попробуйте написать команду снова через некоторое время или сообщите об этом @evenangelscastshadows.

/contact

Аналоги: саппорт

Команда для общения с тех. поддержкой бота.

Использование: /contact [сообщение]

/description

Аналоги: desc, описание, опис

Только для чатов

Только для пользователей

Команда для установки описания себе в профиль.

Использование: /description [описание]

Максимальная длина описания - 300 символов.

/detailed_stats

Аналоги: стдет, stdet

Только для чатов

Команда для просмотра детальной статистики чата (показываются еще и типы сообщений).

Использование: /detailed_stats (д/н/м/г), где д - статистика за день, н - за неделю, м - за месяц, г - за год

Если период не указан, показывается статистика за неделю.

/help

Аналоги: хелп, помощь, команды

Команда для получения ссылки на эту инструкцию.

Использование: /help

/invite_support

Команда для приглашения тех. поддержки в чат для решения каких-либо проблем.

Использование: /invite_support [ссылка на чат]

/me

Аналоги: кто я, я кто, моя стата

Только для чатов

Команда для просмотра своего профиля.

Использование: /me

/name

Аналоги: имя

Только для чатов

Команда для установки имени себе в профиль.

Использование: /name [имя]

Максимальная длина имени - 100 символов.

/profile

Аналоги: профиль, статус, status

Только для чатов

Команда для просмотра профиля другого пользователя.

Использование:
/profile [упоминание]
/profile ответом на сообщение пользователя

/promote

Аналоги: назначить

Только для чатов

Только для пользователей

Команда для выдачи себе титула.

Использование: /promote [титул]

Длина титула должна быть меньше 16 символов и он не должен содержать эмоджи.

/reward

Аналоги: наградить

Только для чатов

Только для пользователей

Команда для награждения пользователя.

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

Использование:
/reward [упоминание] [награда]
/reward [награда] в ответ на сообщение пользователя

Максимальная длина награды - 150 символов.

/rewards

Аналог: награды

Только для чатов

Только для пользователей

Команда для просмотра наград пользователя.

Использование:
/rewards [упоминание] [страница]
/rewards [страница] ответом на сообщение пользователя

Страница по умолчанию - 1.

Награды сортируются по принципу "Сначала новые".

На одной странице показывается 10 наград.

/stats

Аналоги: стата

Только для чатов

Команда для просмотра статистики чата.

Использование: /stats (д/н/м/г), где д - статистика за день, н - за неделю, м - за месяц, г - за год

Если период не указан, показывается статистика за неделю.

/toplvl

Аналоги: топ ур, топ уровни, топ, toplevel

Только для чатов

Команда для вывода топа пользователей по уровню.

Использование: /toplvl

/topxp

Аналоги: топ хп, топ опыт

Только для чатов

Команда для вывода топа пользователей по XP.

Использование: /topxp

Часто задаваемые вопросы (FAQ)

Q: Есть идея для бота. Куда написать?

A: Пишите в телеграм @evenangelscastshadows или в бота через команду /contact.

Q: Иногда при использовании команд вместо имени пользователя выдает "%username%". Что это?

A: Так происходит, когда бот не может получить имя пользователя. Обычно причины три: либо пользователь удалил свой аккаунт, либо администраторы скрыли список участников, либо кто-то пишет от лица группы. Обычно для решения проблемы необходимо назначить бота администратором.

Q: Зачем боту права администратора? Может ли он работать без них?

A: Может, но его функционал будет немного ограничен: он не сможет удалять за собой сообщения, просматривать список участников (если этот список скрыт), назначать пользователям титулы.

Q: Почему в титуле не может быть эмоджи и он должен быть меньше 16 символов?

A: Ограничение со стороны Телеграма.

Q: Может ли пользователь с титулом изменять настройки чата, банить пользователей, добавлять новых админов и так далее?

A: Не может, так как у пользователя с титулом попросту нет админских прав (только должность).

Общие понятия

XP - очки опыта, которые начисляются за общение.

LVL - уровень в чате.

Титул - состояние, когда пользователь имеет должность (надпись как у администраторов справа сверху), но не имеет прав управления чатом: