QuanBot. Планировщик заданий
Поговорим о том как работать с планировщиком заданий внутри бота QuanBot. Что он умеет делать? Вот небольшой список того, что можно сделать по таймеру
- Публиковать с закреплением поста(pin), откреплять пост(unpin)
- Удалять публикации, закрывать голосование, аннулировать результаты голосования
- Отправить себе результаты или просто сообщение
- Повторять задание каждый час/день/неделю/месяц
- Выполнять задание не только по времени, но и по количеству голосов в опросе или у выбранного варианта этого опроса.
- Еще много чего...
А теперь подробнее обо всем этом.
Создание плана
Напишите боту команду /plan, и бот покажет вам список ваших планов(если есть) и кнопку Создать план под списком:
Жмите создать план и напишите название задания:
Обратите внимание на название плана, здесь мы видим иконку ❌ , которая означает что этот план в данный момент остановлен, обращайте чаше внимание на этот символ, если он присутствует, значит вы что то не заполнили, например не указали дату или не выбрали опрос, и поэтому план не может быть запущен. Если всё заполнено верно, тогда этот символ заменится на ✅ .Выбор цели
Цель в данном контексте это то, с чем будет работать текущий планировщик. Т.е. это может быть опрос, шаблон или вариант ответа в опросе. Если вы выберите Шаблон, тогда по плану в первую очередь будет создан опрос из шаблона, а потом уже остальные действия. Чтобы выбрать шаблон, он должен быть сперва создан. Подробнее про шаблоны читайте здесь .
Нажмите на кнопку Опрос и выберите опрос с которым будем работать:
После выбора опроса кнопка Шаблон смениться на Вариант, если нажать на эту кнопку, бот предложит выбрать один из вариантов этого опроса. Если выбрать там вариант, тогда условия по количеству голосов будут применяться к только к этому варианту, и действия Открыть/Закрыть/Аннулировать тоже будут применены только к этому варианту, а не к опросу целиком. Если повторно кликнуть на кнопку ❌ Опрос - опрос будет удален из планировщика.
Когда?
Идем в раздел Когда?:
Здесь бот нам предлагает выбрать дату и количество голосов.
Выбор даты
Жмем Выбрать дату:
Здесь необходимо выбрать дату: месяц и число. Стрелка ➡️ внизу позволит выбрать следующий месяц. Выберите дату, после чего бот попросит выбрать часы:
а затем минуты:
После завершения выбора даты и времени, вы попадете в раздел Когда?, который будет выглядеть вот так:
Как видите время когда будет выполнен план задано. Это время можно удалить, либо поменять. Удалить время может понадобится если вы решили выполнить задание не по наступлению даты, а по количеству голосов.
🔄 Повторы
Обратите внимание на кнопку 🔄 Повторять?, это кнопка для перехода в соответствующий раздел, где вы можете выбрать как часто и сколько раз надо повторить:
Варианты каждый час, день и неделя означают что следующее задание будет выполнено через указанное количество часов. Т.е. если указано неделя, тогда через 7*24 часа. А вот в случае Каждый месяц следующее задание будет выполнено не через 30(или 31) дней, а ровно в ту же дату, только в следующем месяце. Выберите любой пункт, например каждый день:
Обратите внимание на выделенную циферку 1, это значит что вы можете выбрать период, например каждые 3 дня. Для этого используйте кнопки ➕ и ➖ . Если вы хотите отменить повторение, или выбрать другой период, например каждый час - нажмите на красный крест в центре ❌ и вы попадете в предыдущее меню выбора периода(час/день/неделя/месяц).
Так же в текущем меню есть кнопка 🔂 Сколько раз, нажав на которую вы сможете выбрать количество повторений, по достижению которого планировщик будет остановлен:
Итак в предыдущем меню я выбрал повторение каждый 2й день и повторить это 5 раз, после чего планировщик будет остановлен. Обратите внимание на меню:
🔄 Выполнено: 0/5 ⬜️⬜️⬜️⬜️⬜️
Оно показывает прогресс, сколько раз выполнено задание, и сколько раз осталось до завершения.
Нажимаем кнопку назад и выходим в меню Когда?.
🔸 Количество голосов
В меню Когда? можно выбрать не только дату, но и количество голосов. Например выполнить план когда количество голосов будет больше, меньше или равно определенного значения.
Небольшой пример где это может пригодится: например закрыть голосование когда количество голосов в одном из вариантом достигнет предельного значения.
Вы можете указывать количество голосов вместе с датой, тогда план будет выполнено только после указанной даты и только тогда, когда будет выполнение условие по количеству голосов. Можно выбрать только голоса, и убрать дату вовсе.
Нажмите на кнопку 🔸 Количество голосов чтобы перейти в соответствующий раздел:
Здесь можно выбрать условие >, < или =, а также выбрать число для сравнения. В примере выше задание будет выполнено когда количество голосов будет больше 2. Чтобы отменить условие по количеству голосов просто задайте значение нуль.
Обратите внимание, если вы главном меню планировщика, там где выбор опроса, выбрали еще и вариант:
и при этом выбрали количество голосов, тогда задание будет выполнено по достижению количества голосов у указанном варианте(а не сумма всех голосов в опросе!).
Это можно использовать например если необходимо раздать ограниченное количество мест: как только люди проголосовали N раз за один вариант - этот вариант тут же закрывается, и за него более нельзя проголосовать. Если же кто то отменил свой голос, и количество голосов стало меньше чем N - можно открыть этот вариант для голосования.
Что сделать?
Выйдите в главное меню планировщика, нажав кнопку Назад, и войдите в раздел Что сделать?:
В этом разделе вы можете выбрать что сделать в момент выполнения задания.
✅ Открыть/❌ Закрыть - это возможность/невозможность голосовать в опросе. Если вы таймеру закрыли опрос и хотите его открыть руками(без таймера), воспользуйтесь настройкой опроса.
♻️Аннулировать - удалить все голоса опроса или варианта.
🗑👥Удалить все публикации - будут удалены все посты с опросом. В Телеграмме есть ограничение, нельзя удалить посты сделанные давно. В этом случае пост будет изменён на текст "Публикация удалена" без кнопок голосования.
🗑⏰Удалить План - текущий планировщик будет удалён без возможности восстановления. Будьте осторожны с этим.
🗑📢Удалить Опрос - также выбранный опрос будет безвозвратно удалён.
Опубликовать по таймеру
Кнопка 👥Опубликовать в откроет меню для выбора групп/каналов где необходимо будет опубликовать опрос по таймеру:
Если вы уже добавляли ранее каналы и чаты, тогда здесь вы увидите список ваших чатов/каналов, если нет - нажмите кнопку Добавить и добавьте их. Подробнее про добавление бота в каналы и чаты можно почитать здесь. Если вы не можете добавить бота в канал, читайте здесь.
Каждый чат/канал отображается двумя кнопками: первая кнопка это выбор чата для публикации, а вторая справа с текстом Unpin - для того чтобы указать боту на необходимость открепить сообщение в чате во время выполнения задания.
Если вам необходимо Открепить уже закреплённое сообщение - нажмите кнопку Unpin, и тогда левая кнопка с именем чата пропадёт. Чтобы отменить это действие - нажмите на эту кнопку ещё раз:
Если же вам необходимо Опубликовать опрос по таймеру, тогда нажимать на левую кнопку с именем чата. И у вас на месте кнопки Unpin появится кнопка Pin, выбрав которую вы укажите боту что опубликованный опрос необходимо буде закрепить в чате:
Многоуровневый таймер
Если вы хотите в одном планировщике указать несколько разных действий на разные даты, вы можете это сделать добавляя сколько угодно шагов таймера, нажимая кнопку ➕⏰ в главном меню планировщика:
Чтобы проще было понять для чего нужный эти шаги в многоуровневом таймере, попробую привести два примера.
Пример 1. Необходимо утром опрос опубликовать и закрепить в pin. Вечером того же дня закрыть возможность голосования и отправить себе результаты.
Пример 2. Необходимо опубликовать опрос утром. Когда количество голосов в указанном варианте наберет нужное значение - закрыть голосование за этот(!) вариант.