Платформа мероприятий в Telegram: билеты с QR, оплата в USDT и нетворкинг

У организатора конгрессов гости, билеты и партнёры живут в разных местах: чат события, сайт под одно мероприятие, сайт под другое, таблица у менеджера. Я свёл это в одно приложение внутри Telegram, где гость покупает билет, получает QR и находит других участников, а команда видит заказы, проходы и начисления партнёрам.

Задача

Заказчик давно проводит деловые мероприятия в нескольких странах. Аудитория говорит по-русски и по-английски, часть гостей приходит по приглашению других участников. На созвоне он перечислил, что ему нужно: бот на двух языках, партнёрская программа с двумя линиями, продажа билетов, рассылки по расписанию, а потом один сайт вместо нескольких.

Код я сначала не писал. Собрал презентацию на 13 слайдов: экраны афиши, программы и билета, кабинет гостя с QR, балансом и нетворкингом. Отдельный слайд занял фирменный стиль. Его я вынес в файл токенов: тёмно-синий фон, золото с металлическим градиентом, тёплые огни, заголовки антиквой Cormorant, текст в Inter. Старые материалы организатора были в другой гамме, их за основу не брал. По этим токенам потом собрано приложение.

Что я сделал

Основу взял из своей образовательной платформы, сделанной раньше: FastAPI, SQLite и одностраничное приложение без сборщика. Это сэкономило авторизацию, панель и выкладку. Дальше дописал то, что нужно событиям.

Вход. В Telegram гость входит по подписи мини-приложения, сервер её проверяет, поддельная подпись получает 401. Команда заходит в панель по логину и паролю. На демо есть гостевой вход без Telegram, он выключается одной настройкой. Язык берётся из Telegram: русский или английский.

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

Заказ. Гость выбирает категории и количество. В панели задаётся лимит мест на каждую категорию, больше остатка купить нельзя, одного вида не больше 10 билетов, пустой заказ не принимается. Про продажу билетов с телефона я писал в статье про бот регистрации, QR и check-in.

Оплата в USDT. Гость переводит сумму и вставляет хэш транзакции. Заказ уходит на проверку, место за ним держится. Организатор сверяет перевод и подтверждает оплату в панели, после этого выдаются билеты.

Билеты и вход. На каждое место отдельный электронный билет со своим кодом и QR. QR ведёт на страницу проверки: человек из команды открывает её, и первый проход отмечается. Повторный проход по тому же билету виден как повтор, с именем того, кто пропускал в первый раз.

Нетворкинг. Гость сам включает визитку с именем и компанией. Список видят только владельцы билетов на это событие. Выключил показ, и визитка пропала. Как можно развить подбор знакомств, описано в статье про ИИ-нетворкинг на конференции.

Партнёрская программа. У каждого гостя есть своя ссылка. Пригласивший закрепляется при первом входе и потом не меняется. Начисления идут по двум линиям и только с оплаченных заказов. Билет, выданный организатором бесплатно, ничего не начисляет. Партнёр видит баланс и подаёт заявку на вывод, сумма замораживается до выплаты, команда отмечает выплату в панели. Устройство такого кабинета я разбирал в статье про личный кабинет партнёра.

Рассылки и напоминания. Рассылки из панели и два автоматических напоминания владельцам билетов: за сутки и за 3 часа до начала. Повторно одно и то же напоминание не уходит. Почему это влияет на зал, есть в статье про доходимость до мероприятия.

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

Что было сложно

Первое: оплата без платёжного шлюза. Шлюза для приёма криптовалюты в демо нет, поэтому перевод сверяет человек, а система закрывает дыры вокруг этой ручной проверки. Слишком короткий хэш отклоняется сразу. Пока заказ на проверке, места за ним держатся и не продаются второй раз. Подтвердить оплату может только команда, гость получает 403. Кнопка тестовой оплаты работает только для демо-гостя.

Второе: лимиты мест после продаж. Остаток учитывает и заказы на проверке, и уже выданные билеты, а тест отдельно пробует купить сверх остатка после выдачи.

Третье: контакты гостей. Деловые люди не хотят, чтобы их контакты видел любой, кто открыл приложение. Поэтому визитка показывается только по согласию и только тем, у кого есть билет на то же событие. Без билета список закрыт.

Четвёртое: ничего не выдумывать в контенте. Точного времени деловой части нет, и я не стал его ставить «для красоты». Перечни включённого в билеты взяты из афиш организатора, цены тоже его.

Что получилось

Тест идёт одним сценарием: вход по реферальной ссылке, заказ, хэш, подтверждение, выдача трёх билетов, начисления двум линиям, проход и повтор на входе, визитки, лист ожидания, вывод денег партнёру, статистика и напоминание за 3 часа. Сейчас это демо, им можно пройти путь гостя и команды. Как платформа поведёт себя на живом потоке гостей, станет видно после запуска.

Что дальше

Чтобы выйти из демо, от организатора нужны токен бота и адрес кошелька. Потом добавлю раздел спикеров и задания для гостей, включу бота и выключу гостевой вход. Запуск привязан к ближайшему крупному событию организатора. Следующим этапом идёт один сайт на той же базе вместо нескольких старых, с той же афишей и теми же билетами.

Частые вопросы

Нужно ли гостю что-то устанавливать?

Нет. Приложение открывается из бота в Telegram. Команда работает в панели через браузер.

Как проверяют билеты на входе?

Сотрудник сканирует QR телефоном и видит имя гостя. Первый проход отмечается, повторный показывается как повтор. Код, которого нет в базе, не находится.

Можно ли принимать оплату не только в USDT?

Можно добавить другие способы, заказ и билеты от этого не меняются. В демо сделан только USDT с ручным подтверждением, другие способы я не подключал и не проверял.

Коротко о главном

Для события нужна одна база на всё: афиша, места, оплата, билеты, проход, визитки и начисления партнёрам. Тогда лимит мест, повторный проход и начисление за бесплатный билет проверяются одним тестом. Презентация и токены стиля до кода сэкономили переделки: экраны и цвета были определены до первой строки кода.

Платформа пока работает как демо. Если вы проводите мероприятия и хотите продавать билеты и вести гостей в мессенджере, я соберу такой бот с мини-приложением. Напишите в Telegram, MAX или VK.