🪟 Лидогенератор — Админ

🧭 Меню WebApp (вкладки сверху)

• Дашборд — сводка за сегодня: сколько сообщений проверено, сколько релевантных, сколько лидов создано.
• Источники — чаты для мониторинга, синхронизация с Telegram, промпты фильтра, ручное добавление чата.
• Сообщения — журнал обработанных сообщений с фильтрами и деталями по клику.
• Настройки — ваша роль, статус WebApp, управление списком админов (только superadmin).
• Справка — эта инструкция.

📊 Дашборд

Показывает метрики за текущий календарный день (по часовому поясу устройства). Обновляется при открытии и раз в минуту, пока приложение открыто.

• Проверено — все сообщения, прошедшие через AI-фильтр.
• Релевантных — сообщения, признанные целевыми по промпту.
• Лидов создано — записи, отправленные или подготовленные для Bitrix24.

📺 Источники

• Синхронизировать сейчас — подтянуть группы/каналы из user-сессии Telegram в список мониторинга.
• ✕ Удалить — навсегда убрать чат и добавить в исключения (не вернётся при синке, пока не снимете блокировку).
• Выкл / Вкл — временно отключить мониторинг без удаления из списка.
• Промпт — индивидуальные критерии «целевого» сообщения для чата; без своего — используется глобальный.
• Глобальный промпт — правила отбора по умолчанию для всех источников без своего промпта.
• Добавить чат — резервный ручной ввод ID (для групп обычно отрицательный, например -1001234567890).

💬 Сообщения

Лента обработанных сообщений с фильтрами: период, релевантность, статус Bitrix, источник, поиск по тексту или username. Нажмите на карточку — откроются детали, контекст и ссылка в Telegram.

• Bitrix: отправлено — лид уже ушёл в CRM.
• Bitrix: ждёт — в очереди на отправку.
• Bitrix: нет — в Bitrix не планировалось (нерелевантно или отфильтровано).

⚙️ Настройки

Доступ к API только из Telegram Mini App (заголовок initData). Прямое открытие URL в браузере не работает.

• Superadmin может добавлять и удалять админов по Telegram user ID.
• Админы из .env (WEBAPP_SUPERADMIN_IDS, ADMIN_BOT_ADMIN_IDS) отображаются как «фиксированные» и не удаляются из интерфейса.

🔐 Роли доступа

🚀 Как открыть админку

1. Разверните admin_api по HTTPS и укажите ADMIN_MINI_APP_URL в .env.
2. В Telegram откройте админ-бота и выполните /admin_app.
3. Нажмите кнопку «Открыть админ-панель» — откроется это Mini App.

🤖 Админ-бот (резерв)

В режиме ADMIN_BOT_FALLBACK_ONLY=true полное управление — через WebApp. В боте остаются:

• /admin_app — открыть эту панель
• /leadgen_stats — краткая статистика в чате
• /state — состояние воркера
• /addchat <id> — быстро добавить чат
• /help — эта же справка в Telegram