Как запустить конкурс
Пошагово на примере «Рулетки»: от входа на сайт до вручения призов. Первый запуск займёт 5–10 минут.
Что понадобится
- аккаунт ВКонтакте;
- сообщество, в котором вы администратор;
- открытые комментарии к записям сообщества;
- включённые сообщения сообщества — если будете выдавать призы кодом.
1 Войдите через VK ID
Нажмите «Войти» в шапке сайта. В окне входа отметьте согласие с условиями — кнопка «Войти через VK ID» станет активной. ВКонтакте спросит, какие права выдать сервису: подтвердите, без них бот не сможет публиковать пост и картинки от имени сообщества. После входа откроется раздел «Мои конкурсы».

2 Подключите сообщество
Откройте раздел «Группы». Справа, в блоке «Подключить новую», — сообщества, где вы администратор; если их много, найдите нужное поиском. Нажмите «Подключить»: ВКонтакте покажет, какой доступ просит бот, — публикация записей и комментариев, сообщения сообщества, фотографии и документы. Разрешите, и вы вернётесь на сайт, а группа появится слева, в «Подключённых группах», с отметкой «Доступ есть».

Группу можно подключить и прямо из формы конкурса — пунктом «Подключить новую группу» в списке групп. Заполненная форма при этом не потеряется.
3 Выберите конкурс
Откройте каталог и выберите механику. Для примера возьмём «Рулетку»: участник пишет кодовое слово под постом, а бот отвечает, выиграл он или нет. На странице механики нажмите «Создать конкурс» — откроется форма, уже заполненная настройками готового конкурса.

4 Настройте конкурс
В форме всё уже заполнено — обязательно только выбрать группу и вписать призы. Остальное меняйте по желанию.
Группа
В поле «Группа» выберите сообщество, где пройдёт конкурс. Сама форма группу не выбирает, даже если она одна, — чтобы пост случайно не ушёл не туда.

Призы
Впишите название и количество каждого приза; «Добавить приз» добавит ещё строку. Ниже выберите, как победитель получит приз:
- «В комментарии под постом» — бот поздравит победителя под постом и попросит написать в сообщения сообщества. Приз вручаете сами и отмечаете «Вручён» в карточке конкурса.
- «Кодом в личные сообщения сообщества» — бот даст победителю код в ответе под постом. Победитель присылает код в сообщения сообщества, бот проверяет его и подтверждает, а вам приходит оповещение. Сообщения сообщества должны быть включены.

Настройки игры
- «Кодовое слово» — что участник пишет в комментарии, чтобы крутить рулетку. По умолчанию «крутить»; регистр не важен, слово может стоять внутри фразы.
- «Приз каждую N-ю попытку» — как часто выпадает выигрыш: в среднем один приз на N попыток. Под полем форма сама считает, на сколько комментариев хватит призов: 12 призов при N = 10 разойдутся примерно за 120 попыток.
- «Картинки ответов бота» — барабан, который бот прикладывает к ответу: при выигрыше три одинаковые иконки, при промахе разные. Можно взять готовый набор или загрузить свои иконки и картинки.

Правила
«Попыток на участника» — сколько раз каждый может сыграть, «Пауза между попытками» — сколько секунд ждать между ходами. В «Условиях и бонусных попытках» включите лайк, репост или подписку: за каждое действие участник получит бонусные попытки, а с галочкой «обязательно» бот не примет ход, пока условие не выполнено. Бонус и обязательность не зависят друг от друга: на скриншоте лайк даёт +3 попытки, а подписка обязательна и тоже даёт +3.

Пост конкурса
Текст, который бот опубликует в группе. Слова в фигурных скобках — переменные, при публикации бот подставит вместо них настоящие значения: {twist_word} — кодовое слово, {prizes} — число призов, {retries.max} — число попыток. Наведите на переменную, чтобы увидеть подсказку, кликните — она вставится в текст. В ленте без раскрытия видны первые строки: напишите там, что разыгрываете и что нужно сделать. Картинку добавьте кнопкой «Выбрать картинку», а ниже проверьте превью «Так пост увидят в ленте».

Дополнительные настройки
Этот блок свёрнут, и для первого конкурса его можно не трогать. В нём:
- «Отложенная публикация» — пост выйдет в указанное время, а до этого конкурс будет в статусе «Запланирован»;
- «Завершить автоматически» — дата окончания; если пусто, конкурс идёт, пока не закончатся призы, но не дольше 60 дней;
- «Подписка на группу партнёра» — условие подписаться на другое сообщество;
- «Утешительные призы» — их получат самые активные участники без выигрыша, когда конкурс завершится;
- «Возвращение игроков» — новые попытки по расписанию, чтобы участники возвращались;
- «Ответы бота» — все тексты бота, их можно переписать под стиль сообщества.
5 Запустите
Нажмите «Создать конкурс» внизу формы. Сервис проверит доступ к сообществу и сразу опубликует пост, а если задано время — положит его в отложенные записи ВКонтакте. Конкурс появится в «Моих конкурсах», и бот начнёт следить за комментариями.
Настройки запущенного конкурса не меняются. Если нужно что-то поправить, остановите его и нажмите «Повторить конкурс» — откроется форма с теми же настройками.
6 Как играют участники
Участник пишет под постом кодовое слово. Бот проверяет новые комментарии каждые полминуты и отвечает от имени сообщества, обычно в течение минуты: промах и сколько попыток осталось или выигрыш с кодом приза. К ответу прикладывается картинка барабана.
Комментарий должен состоять только из кодового слова, регистр не важен. Если это не так, бот подскажет слово и попытку не спишет. Если попытки закончились, идёт пауза или не выполнено обязательное условие — бот так и ответит. Бонусные попытки за лайк, репост и подписку начисляются сами.

7 Следите и вручайте призы
В «Моих конкурсах» — все ваши конкурсы со статусом, числом участников и победителей. Значок справа в строке повторяет конкурс с теми же настройками.

Откройте конкурс, чтобы увидеть подробности: сколько участников и победителей, сколько призов уже выдано и сколько осталось, когда конкурс завершится сам. Ссылка «Открыть в VK» ведёт к посту.

Ниже — таблица «Участники»: кто сколько раз играл, какие условия выполнил и что выиграл. Переключатель «Победители» оставит только выигравших. У приза, выданного кодом, видно, прислал ли победитель код: «ожидает — победитель ещё не написал код» или «код получен». Если приз выдаётся в комментарии, вместо статуса будет кнопка «Вручён» — нажмите её, когда отдадите приз.

О новых победителях, полученных призах и завершении конкурса сообщит колокольчик в шапке. Внизу карточки конкурса — кнопки «Пауза», «Остановить» и «Повторить конкурс».
8 Завершение
Конкурс завершается сам, когда разыграны все призы, наступила дата из «Завершить автоматически» или прошло 60 дней. Остановить его раньше можно кнопкой «Остановить». Бот опубликует под постом итоговый комментарий; если вы добавили утешительные призы, в нём будут самые активные участники. Ещё сутки после завершения бот отвечает тем, кто продолжает писать под постом.
Если что-то не так
Бот не отвечает на комментарии
Подождите минуту: бот проверяет комментарии раз в полминуты. Если ответа так и нет, откройте «Группы» и нажмите «Проверить доступ» — если доступ отозван, появится кнопка «Переподключить». Ещё проверьте, что комментарии к записям в сообществе открыты: если бот не может их прочитать, об этом придёт оповещение в колокольчике.
Победитель прислал код, а статус не меняется
Код нужно прислать в сообщения того сообщества, где проходит конкурс. Проверьте, что сообщения сообщества включены, а код скопирован полностью. Когда бот подтвердит код, победитель получит ответ, а у приза появится отметка «код получен».
Можно ли изменить конкурс после запуска?
Нет, настройки запущенного конкурса не меняются. Остановите его и нажмите «Повторить конкурс» — откроется форма с теми же настройками, поправьте нужное и запустите заново. Если нужно просто приостановить игру, есть кнопка «Пауза».
Нужно ли что-то настраивать в самом сообществе?
Комментарии к записям должны быть открыты, а для выдачи призов кодом — включены сообщения сообщества. Больше ничего: Callback API и Long Poll не нужны.
Чем отличаются другие механики?
Запуск у всех одинаковый: вход, группа, форма, публикация. Отличается блок «Настройки игры». Например, в «Угадай где приз» вы задаёте число ячеек на поле, участники пишут номер ячейки, а в посте есть ссылка на страницу поля, где видно, какие ячейки уже открыты.
Сколько это стоит?
Сейчас сервис бесплатный: идёт открытое тестирование. Платные тарифы появятся позже, их условия мы опубликуем заранее.
Попробуйте на своей группе
Сервис пока бесплатный. Остались вопросы — напишите нам.