Felix: Telegram-бот и Mini App для мероприятий

Felix помогает подготовить заявку на мероприятие: собрать параметры, посмотреть площадки или комплекты оборудования и передать обращение менеджеру. Проект вырос из моего Event AI Agent. В актуальной версии вместе работают Telegram-бот и Mini App с двумя режимами: площадки и техническое оснащение.

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

Заявка начинается с параметров события

Для подбора площадки нужны город, тип события, количество гостей, дата, формат рассадки, предпочтительный тип пространства и бюджет. Банкет и фуршет могут требовать разной вместимости одного и того же зала. Для оборудования важны состав услуг, число участников и условия мероприятия.

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

В Mini App рядом с диалогом есть экраны события, бюджета, чеклиста и заявок. Вопросы удобно обсуждать в чате, а параметры и варианты удобнее просматривать на отдельном экране. Оба интерфейса относятся к одному процессу подготовки обращения.

Варианты берутся из каталога

В площадочном режиме итоговый подбор выполняет Python-код. Он проверяет город, тип площадки и вместимость для выбранного формата. Затем подходящие варианты ранжируются по условиям и пожеланиям. Площадка с неизвестной или недостаточной вместимостью не должна попадать в результат как подходящая для указанного числа гостей.

Бюджет используется с допуском, а неизвестные цены требуют уточнения. Если вариантов меньше, чем хотелось бы, система возвращает то, что нашла, вместо того чтобы дополнять ответ выдуманными площадками. Когда подходящего варианта нет, нужен ручной подбор.

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

Что поручено AI

Модель полезна при разборе свободного текста и уточняющем разговоре. Итоговая выдача Mini App строится на результатах отбора и расчёта в коде. Эти части можно проверять по отдельности: правильно ли понято сообщение и действительно ли найденный вариант проходит заданные условия.

Например, «встреча команды на 80 человек, нужен зал и звук» задаёт только часть параметров. Это учебный пример. Дата, формат и бюджет ещё требуют уточнения, а состав оборудования зависит от самой задачи.

В моём @ilinmaksbot первая оценка проекта собирается из ответов с кнопками и подготовленных правил. Felix показывает более сложный сценарий с каталогами и несколькими интерфейсами. Подход к выбору инструмента я разобрал в статье «Парсер, бот, сервис или агент».

Сохранить заявку и доставить её менеджеру

Сессии и обращения хранятся в Supabase. При отправке заявки из Mini App сервер проверяет подписанные данные Telegram и сохраняет контакт вместе с параметрами события. Поэтому интерфейс можно посмотреть в обычном браузере, а для отправки обращения нужно открыть приложение внутри Telegram.

Сохранение и уведомление менеджера являются разными шагами. Если запись создана, но уведомление не отправилось, обработчик возвращает сообщение о задержке. У Telegram-сценария также есть механизм повторных попыток. Это позволяет отдельно проверять наличие заявки и её доставку, вместо того чтобы считать показанный пользователю экран успеха достаточным подтверждением.

Как заказать похожий продукт

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

На странице разработки Telegram-ботов описан диалоговый сценарий, а на странице разработки Mini App работа с отдельными экранами и данными. Сам продукт доступен в Felix Event Bot; площадочный интерфейс можно посмотреть в браузере.