Как настроить бота с адвент-календарём в PuzzleBot

Адвент-календарь — удобный формат, который превращает ожидание праздника в цепочку маленьких радостей и полезных шагов.

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

Для компаний адвент-календарь — это инструмент вовлечения: он помогает удерживать внимание аудитории каждый день, знакомить с продуктами в ненавязчивом формате, повышать лояльность и стимулировать возвращения к бренду. Через ежедневные «окошки» можно давать полезный контент, мини-игры, бонусы, промокоды, обучающие задания.

Концепция бота-адвент-календаря легко трансформируется в бота для романтических свиданий, подарков или челленджей. Техническая механика остаётся неизменной — меняется только идея и текстовое наполнение.

Разберём по шагам, как создать бота с адвент-календарём на PuzzleBot:

1. Откройте бот @BotFather в Telegram.
2. Введите команду /newbot.
3. Введите название вашего бота.
4. Придумайте уникальный никнейм бота, который оканчивается на Bot или _bot (например, @DevGrow_Bot).
5. Скопируйте токен и сохраните.
6. Введите команду /mybots и выберите созданного бота.
7. Нажмите на кнопку «Редактировать бота».
8. Нажмите на кнопку «Редактировать ботпик» и загрузите аватарку.
9. Нажмите на кнопку «Вернуть боту», «Редактировать» ботпик».
10. Нажмите на кнопку «Редактировать описание» и напишите сообщение.
(данное сообщение пользователь видит до запуска бота, ответ на вопрос: Что может сделать этот бот?; ограничение до 512 символов)
11. Нажмите на кнопку «Вернуться к боту» , затем «Редактировать ботпик».
12. Нажмите на кнопку «Редактировать описание изображения» и загрузите фото-описание бота.
(ограничение: размер 640х360 или размер GIF 320х180, 640х360 или 960х540)
13. Нажмите на кнопку «Вернуться к боту», затем «Редактировать ботпик».
14. Нажмите на кнопку «Редактировать информацию» и запишите информацию о боте (ограничение до 120 символов).

Понадобится 31 персональная переменная — по одной на каждый день, чтобы фиксировать, открыт ли подарок.

1. Откройте раздел «Переменные».
2. Нажмите кнопку «+ Добавить переменную».
3. В поле «Название переменной» введите, например, d1.
4. Нажмите «Сохранить».

Аналогичным образом создайте переменные d2, d3, …, d31 (повторите шаги 2–4 для каждого дня).

Чтобы ограничить открытие одним подарком в день, создадим категорию.

1. Откройте раздел «Модерация».
2. Нажмите кнопку «+» в правом верхнем углу.
3. В появившемся окне введите название категории, например: «1 день – 1 подарок».
4. Нажмите «Создать категорию».

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

Для работы адвент-календаря понадобится сценарий, который каждый день в 10:00 по МСК будет напоминать пользователю забрать подарок, а в 23:59 по МСК — отключать категорию, контролирующую открытие подарка.

Создадим сценарий:

1. Откройте раздел «Сценарии».
2. Нажмите кнопку «+Добавить сценарий» в правом верхнем углу.
3. Нажмите на три точки и выберите Переименовать, например: «напоминалка».
4. Нажмите галочку, чтобы сохранить.

Настроим 2 поста в сценарии:
Для начала создадим команду, которая будет напоминать и удаляться, при вызове следующей, для этого откройте вкладку «Конструктор».

1. Нажмите «+»
2. Выберите «Обычная команда»
3. Впишите название команды
4. Раскройте дополнительные настройки и активируйте поле «Удалить текущую команду после вызова следующей»
5. Добавить блок «Текст» и напишите сообщение
6. Закройте команду и выгрузите изменения в бот

Вернитесь в раздел Сценарии и откройте созданный сценарий для настройки.

1 пост: в 10:00 по МСК - напоминает открыть подарок, если еще не открыт.

1. Нажмите «+Добавить пост» и настройте по образцу:

• Тип отправки Через
• Выберите В точное время Часы: 10 Минут: 0
• Включите повторение поста и активируйте все дни недели

2. Раскройте дополнительные настройки и в блоке категорий включите отправку для пользователей, у которых нет категории «1 день – 1 подарок». Если пользователь получил подарок до 10:00МСК, в этот день напоминание ему не отправится.
*При желании можно добавить эффект - активируйте «Отправить с эффектом» и выберите эффект.
3. Раскройте Действия и выберите Отправить команду или условие и укажите созданную ранее команду.
4. Переведите пост из Черновика в Запланированные - нажмите на кнопку

2 пост: в 23:59 по МСК - отключает категорию контроля открытия подарка.

1. Нажмите «+Добавить пост» и настройте по образцу:

• Тип отправки Через
• Выберите В точное время Часы: 23 Минут: 59
• Включите повторение поста и активируйте все дни недели

2. Раскройте Действия и выберите Изменить категорию - отключите категорию «1 день - 1 подарок»
3. Переведите пост из Черновика в Запланированные - нажмите на кнопку

Для отключения напоминалок, создадим сценарий в котором настроим один пост:

1. Раскройте Действия и выберите Изменить сценарии - отключите сценарий с напоминалкой
2. Добавьте блок Текст и напишите сообщение
3. Переведите пост из Черновика в Запланированные - нажмите на кнопку

Для работы бота настраиваем:
1 команду для запуска с кнопкой для вызова календаря и отправляем в закреп, чтобы кнопка была на виду
1 команду с календарем
3 команды с условиями - для проверки доступа (доступ к календарю с 1 декабря; доступ к выбору подарка; доступ к подарку 31 декабря)
30 кнопок условий - для открытия подарков и отображения в клавиатуре
31 команду с подарками
4 команды с уведомлениями - которые будут удаляться при вызове следующей команды (доступ откроется 1 декабря; можно открыть 1 подарок в день; этот подарок можно открыть только 31 декабря; за следующим подарком приходи завтра)