~rd/blame-bot

Telegram bot to save and distribute links to ChGK discussions among tournament players

7a2f9bb Описал фикс в changelog

~rd pushed to ~rd/blame-bot git

3 months ago

4934ea1 Handle errors in sending in poll_discussions

~rd pushed to ~rd/blame-bot git

3 months ago

#ChGK Blame&Flame Bot

Бот для о(б)суждений турниров: Link to the bot | Link to the project hub | Link to the changelog

Организаторы могут в него сохранить ссылку на обсуждение, и игроки получат её сразу после того, как отыгрыш введут на турнирном сайте. И наоборот, игроки могут записаться на обсуждение, а когда орги сохранят ссылку --- бот её пришлёт всем жаждущим. Понятно, чтобы что-то с ботом делать, нужно на своей странице на турнирном сайте указать свой телеграм (а боту сказать свой id на турнирном сайте).

#Содержание

  1. Инструкция
  2. Что-то пошло не так?

#Инструкция

Зайдите к боту и запустите его: https://t.me/chgk_blame_bot

#Верификация id игрока на турнирном сайте

Чтобы бот знал, что вы - это вы, а не кто-то ещё, нужно связать ваш id на турнирном сайте с вашим аккаунтом в телеграме.

  1. Зайдите на свою страницу пользователя. Там вы можете редактировать настройки.
  2. Найдите поле "Telegram" и запишите туда своё имя пользователя в телеграме (его можно посмотреть и установить в настройках: Settings -- Edit Profile). Например, gltronred
  3. Установите поле "Приватность" в "Отсутствует" --- тогда бот сможет увидеть, какое у вас имя пользователя. После верификации значение поля можно будет поменять обратно.
  4. Напишите ваш id на турнирном сайте боту (только число, например, "46976")

Что такое id игрока и как его узнать? Зайдите на свою страницу игрока на турнирном сайте (можно, например, залогиниться и нажать на свои ФИО в правом верхнем углу). Число возле ваших ФИО --- ваш id; он же будет в адресной строке: например, если адрес https://rating.chgk.info/player/46976, то id --- 46976.

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

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

Если вы ошиблись при вводе своего id, и проверка не проходит, просто отправьте правильный id - бот запишет ваш новый id.

#Игрокам: запись на обсуждение

Для записи на обсуждение отправьте боту команду /discuss <id>, где <id> --- это идентификатор турнира, например, /discuss 9616

Что такое id турнира и как его узнать? Зайдите на страницу турнира на турнирном сайте. Идентификатор турнира будет в адресной строке: например, если адрес https://rating.chgk.info/tournament/9616, то id турнира --- 9616. Также идентификатор пишется в таблице турниров в самом левом столбце.

Бот проверит, отыгрывали ли вы этот турнир (указаны ли вы в составе какой-либо команды), и отправит вам ссылку на обсуждение, если она добавлена организатором. Бот обновляет информацию об отыгрышах раз в три часа, поэтому проверка может занять некоторое время. Если бот не отвечает больше суток, проверьте, выполнили ли вы все шаги, и напишите мне или в трекер задач.

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

Если вы отыгрывали турнир, но вашу команду ещё не внесли на турнирный сайт, обратитесь к представителю в вашем городе (вы можете узнать, кто это, посмотрев на страницу "Заявки" нужного турнира).

Если вы хотите обсуждать турнир, но обсуждение не добавлено в бота, обратитесь к кому-либо из организаторов турнира (вы можете узнать, кто это, нажав "Показать информацию" на странице "Результаты" нужного турнира).

#Игрокам: автоматическая запись на все обсуждения

Если вы хотите, чтобы вам приходили ссылки на обсуждения всех турниров, которые вы отыграли, отправьте боту команду /auto.

Теперь после регистрации обсуждения организатором (и после внесения вашего отыгрыша представителем) вы получите ссылку на обсуждение. Даже тех турниров, которые вы не хотели бы обсуждать.

Чтобы отключить этот режим, снова отправьте боту команду /auto.

#Организаторам: регистрация обсуждения

Для добавления обсуждения отправьте боту команду /register <id> <url>, где <id> --- это идентификатор вашего турнира, а <url> --- ссылка на обсуждение, например, /register 9616 https://tinyurl.com/testtournament.

Что такое id турнира и как его узнать? Зайдите на страницу турнира на турнирном сайте. Идентификатор турнира будет в адресной строке: например, если адрес https://rating.chgk.info/tournament/9616, то id турнира --- 9616. Также идентификатор пишется в таблице турниров в самом левом столбце.

Обратите внимание! Ссылку может получить любой верифицированный в боте игрок, указанный в составе какой-либо из команд на турнире. Если это не то поведение, которого вы ожидаете, вы можете добавить обсуждение после отыгрыша.

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

#Что-то пошло не так?

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

Если бот начинает вести себя неправильно (или вести себя), пожалуйста, напишите мне. Я смогу быстрее разобраться с проблемой, если вы напишете, что именно вы делали, как реагировал бот и как, по вашему мнению, он должен был реагировать при правильном поведении.

Я буду рад вашим сообщениям, отзывам и пожеланиям!