Telegram и VK гостей, бонус за профиль¶

Редакция Pro

Гостевой бот Telegram/VK входит в редакцию Pro. Подробнее — Редакции и лицензия.

Гость может привязать к своему аккаунту в клубе Telegram и VK, а за полностью заполненный профиль получить бонус (сумму задаёте вы). Вам это даёт каналы для рассылок: новости и акции уходят гостю прямо в Telegram.

Чтобы всё заработало, нужно три настройки — займёт около 15 минут.

Пока настройки не сделаны

Гости ничего не видят: карточка «Заполните профиль» появляется в приложении игрока только после шагов 1 и 2. Обещать бонус, который нельзя получить, мы не будем.

Что считается «профиль заполнен на 100%»¶

Пункт	Как гость его выполняет
Имя	вписывает в профиле
Дата рождения	вписывает в профиле (один раз — исправить может только администратор)
Телефон подтверждён	при регистрации звонком/SMS или у администратора
Telegram	кнопка «Привязать» → открывается бот клуба → «Start»
VK	кнопка «Привязать» → вход через VK ID

Бонус начисляется один раз на бонусный счёт. Если гость отвяжет соцсеть и привяжет снова — второго бонуса не будет. Один Telegram или VK можно привязать только к одному гостю: «нафармить» бонус на нескольких аккаунтах не получится.

Шаг 1. Гостевой бот Telegram¶

Это отдельный бот для гостей — не тот, что присылает вам сводки (см. Telegram-бот). Бот владельца умеет управлять клубом, гостям его давать нельзя.

В Telegram откройте @BotFather → /newbot.
Имя — например «Клуб Шелдон», username — например sheldon_club_bot (должен заканчиваться на bot).
Скопируйте присланный токен.
Админка → Настройки → Боты и уведомления → карточка «Гостевой бот» → вставьте токен → Сохранить токен.
Подождите до минуты: статус карточки станет «работает», рядом — @имя бота. Там же видно, сколько гостей уже привязали Telegram и VK и задано ли правило бонуса.

Совет: в @BotFather задайте боту аватарку клуба и описание (/setuserpic, /setdescription) — гость увидит их, когда откроет бота.

Шаг 2. Приложение VK ID¶

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

Та же инструкция с уже подставленными адресами вашего клуба есть в админке: Настройки → ВКонтакте, блок «Как подключить VK ID».

Откройте id.vk.ru/about/business/go и войдите своим аккаунтом VK → «Добавить приложение».
«Кем управляется» — выберите себя (или сообщество клуба) → «Далее».
Название — имя клуба (его увидит гость при входе), платформа — Web.
«Базовый домен» — адрес приложения игрока без https:// (например pwa.вашклуб.ru).
«Доверенный Redirect URL» — https://<адрес приложения игрока>/profile/vk.
Сохраните, скопируйте ID приложения (число) → админка → Настройки → ВКонтакте → «ID приложения VK ID» → Сохранить настройки.

«Защищённый ключ» и «сервисный ключ» из кабинета VK не нужны — никуда их не вставляйте.

Шаг 3. Сумма бонуса¶

Админка → Лояльность → Автобонусы → Добавить → тип «Профиль заполнен на 100%» → сумма (например, 100 ₽) → Активно → Создать.

Без этого правила гости всё равно могут привязывать Telegram и VK (вам — канал рассылок), просто без обещания бонуса.

Где это видно¶

Приложение игрока → Профиль: полоска прогресса «Заполните профиль — получите 100 ₽ бонусами», кнопки «Привязать» и «отвязать».
Лаунчер на ПК клуба → Профиль: тот же прогресс и QR-код — гость сканирует его телефоном и привязывает соцсети там (на ПК клуба входить в свои соцсети не нужно).
Админка → карточка гостя: строки «Telegram» и «VK».
Рассылки (Маркетинг) по каналу Telegram уходят через гостевого бота тем, кто его привязал.

Если что-то не так¶

Симптом	Что сделать
Карточка «Гостевой бот» дольше минуты «запускается» или «ошибка»	проверьте токен (скопирован целиком?); если токен верный — скорее всего не работает прокси для Telegram, обратитесь к поставщику
Гость нажал Start, а бот ответил «чтобы привязать — откройте приложение»	гость открыл бота сам, а не кнопкой «Привязать» в профиле: бот не знает, кто это. Пусть нажмёт «Привязать» в приложении
Гость пишет «Ссылка устарела»	ссылка живёт 10 минут и срабатывает один раз — пусть нажмёт «Привязать» ещё раз
«Этот Telegram / VK уже привязан к другому гостю»	так и есть: пусть отвяжет его в том аккаунте, где он привязан (или администратор проверит, нет ли у гостя второго аккаунта)
VK: «не подтвердил вход»	в приложении VK ID не добавлен Redirect URL из шага 2 или адрес с опечаткой
Гость ошибся с датой рождения	исправьте в админке → карточка гостя → Редактировать