Sales

Sales (Воронка продаж)

Управление воронкой продаж для Telegram ботов: квизы, сегментация, агентские промпты, follow-up сообщения и аналитика конверсий.

Скриншот

Концепция

Воронка продаж интегрирована в Telegram ботов. Конфигурация происходит двумя способами:

1. Главный способ: вкладка Sales в настройках конкретного бота (Telegram → выбрать бота → вкладка Sales)
2. Обзорная панель: отдельная страница Sales с общей аналитикой по всем воронкам

Каждый бот может иметь свою независимую воронку с:

• Квизом (вопросы с вариантами ответа)
• Сегментами (распределение пользователей по путям)
• Агентскими промптами (уникальные AI-ассистенты для каждого сегмента)
• Follow-up правилами (автоматические напоминания)
• Отзывами (social proof)

Standalone страница Sales

Обзорная панель со статистикой по всем воронкам.

Вкладки

Вкладка	Описание
Funnel	Общая статистика воронки по всем ботам
Segments	Просмотр всех сегментов
Quiz	Просмотр всех квиз-вопросов
Testimonials	Управление отзывами

Метрики воронки (Funnel)

Метрика	Описание
Total Leads	Общее количество лидов
Converted Leads	Конвертированные лиды (завершили воронку)
Conversion Rate	Процент конверсии (converted / total * 100%)
Avg Response Time	Среднее время ответа бота

Настройка воронки в боте

Основная конфигурация происходит в Telegram → [Бот] → Sales.

Agent Prompts (Агентские промпты)

Системные промпты для каждого сегмента воронки. Каждый промпт — это отдельная AI-личность с уникальным поведением.

Поле	Описание
Prompt Key	Уникальный идентификатор промпта
Name	Название промпта (например, "DIY Sales Agent")
Description	Описание промпта
System Prompt	Текст системного промпта для LLM
Temperature	Температура генерации (0.0 - 1.0)
Max Tokens	Максимальная длина ответа
Enabled	Включён/отключён
Order	Порядок отображения

Пример промпта

{
  "prompt_key": "diy_agent",
  "name": "DIY Sales Agent",
  "description": "Для пользователей, которые хотят собрать бота сами",
  "system_prompt": "Ты — технический консультант. Помогаешь пользователям с выбором стека...",
  "temperature": 0.7,
  "max_tokens": 500,
  "enabled": true,
  "order": 1
}

Quiz Questions (Квиз)

Вопросы с вариантами ответа, отображаемые в Telegram как inline-кнопки.

Поле	Описание
Question Key	Уникальный ключ вопроса
Text	Текст вопроса
Order	Порядок отображения (1, 2, 3...)
Options	Массив вариантов ответа (см. ниже)

Структура Option

{
  "label": "До 100k ₽",
  "value": "low",
  "icon": "📉"
}

Поле	Описание
label	Текст кнопки
value	Значение для match_rules
icon	Emoji-иконка

Segments (Сегменты)

Правила распределения пользователей по путям на основе ответов квиза.

Поле	Описание
Segment Key	Уникальный идентификатор сегмента
Name	Название сегмента
Path	Путь сегмента (см. ниже)
Match Rules	JSON правила матчинга по ответам квиза
Agent Prompt	Ссылка на prompt_key из Agent Prompts
Description	Описание сегмента

Доступные пути (Path)

Path	Описание
diy	DIY-клиенты (хотят собрать сами)
basic	Базовый продукт
custom	Кастомная разработка
qualified	Квалифицированный лид
unqualified	Неквалифицированный лид
needs_analysis	Требуется анализ потребностей

Пример сегмента

{
  "segment_key": "diy_segment",
  "name": "DIY Клиенты",
  "path": "diy",
  "match_rules": {
    "budget_q1": "low",
    "experience_q2": "advanced"
  },
  "agent_prompt": "diy_agent",
  "description": "Пользователи с опытом и ограниченным бюджетом"
}

Follow-up Rules (Автоматические сообщения)

Триггеры для отправки автоматических сообщений через заданное время.

Поле	Описание
Rule Key	Уникальный идентификатор правила
Name	Название правила
Trigger	Триггер: segment_enter, payment, inactivity
Delay Hours	Задержка перед отправкой (часы)
Message Template	Шаблон сообщения (поддерживает переменные: {name}, {segment})
Max Sends	Максимальное количество отправок
Enabled	Включено/отключено

Пример правила

{
  "rule_key": "diy_followup_24h",
  "name": "DIY Follow-up 24h",
  "trigger": "segment_enter",
  "delay_hours": 24,
  "message_template": "Привет, {name}! Нужна помощь с настройкой?",
  "max_sends": 1,
  "enabled": true
}

Testimonials (Отзывы)

Social proof для повышения доверия.

Поле	Описание
Author	Имя автора отзыва
Text	Текст отзыва
Rating	Оценка (1-5 звёзд)
Source	Источник (например, "Telegram", "Email")
Enabled	Включён/отключён

Hardware Specs (Технические характеристики)

Для ботов типа TZ Generator (генератор технических заданий) — конфигурация железа для рекомендаций.

Поле	Описание
GPU Models	Массив поддерживаемых GPU
Min RAM GB	Минимальный объём ОЗУ
Recommended CPU	Рекомендуемый процессор

A/B Tests (A/B тестирование)

Тестирование вариантов промптов, сообщений или потоков.

Поле	Описание
Test Key	Уникальный ключ теста
Variant A	Вариант A (промпт/сообщение)
Variant B	Вариант B (промпт/сообщение)
Active	Активен ли тест
Stats	Статистика (impressions, conversions)

Subscribers (Подписчики)

Статистика подписчиков бота.

Метрика	Описание
Total Subscribers	Общее количество подписчиков
Active Today	Активных сегодня
New This Week	Новых за неделю

Funnel Analytics (Аналитика воронки)

Раздел	Описание
Events	Список событий воронки (quiz_start, quiz_complete, segment_enter, payment_success)
Daily Report	Ежедневная статистика по событиям

GitHub Config (Интеграция с GitHub)

Настройка автоматической отправки ТЗ в GitHub Issues.

Поле	Описание
Repo URL	URL репозитория GitHub
Token	Personal Access Token
Auto Create Issue	Автоматически создавать Issue при генерации ТЗ

User Profiles (Профили пользователей)

Просмотр состояния пользователей в воронке.

Поле	Описание
User ID	Telegram User ID
Segment	Текущий сегмент
State	Состояние в FSM
Quiz Answers	Ответы на квиз

Discovery Responses (Ответы Discovery)

Ответы пользователей на discovery-вопросы (для TZ Generator ботов).

FSM (Конечный автомат)

Воронка использует состояния FSM для отслеживания прогресса пользователя:

start → quiz → segment → conversation

Состояние	Описание
start	Пользователь запустил бота
quiz	Проходит квиз
segment	Определён сегмент, общается с агентским промптом
conversation	Свободное общение

API эндпоинты

Все эндпоинты воронки находятся под /admin/telegram/instances/{id}/...

Agent Prompts

Метод	Endpoint	Описание
GET	.../prompts	Список всех промптов
POST	.../prompts	Создать промпт
PUT	.../prompts/{prompt_key}	Обновить промпт
DELETE	.../prompts/{prompt_key}	Удалить промпт

Quiz

Метод	Endpoint	Описание
GET	.../quiz	Список вопросов
POST	.../quiz	Создать вопрос
PUT	.../quiz/{question_key}	Обновить вопрос
DELETE	.../quiz/{question_key}	Удалить вопрос

Segments

Метод	Endpoint	Описание
GET	.../segments	Список сегментов
POST	.../segments	Создать сегмент
PUT	.../segments/{segment_key}	Обновить сегмент
DELETE	.../segments/{segment_key}	Удалить сегмент

Follow-ups

Метод	Endpoint	Описание
GET	.../followups	Список правил
POST	.../followups	Создать правило
PUT	.../followups/{rule_key}	Обновить правило
DELETE	.../followups/{rule_key}	Удалить правило

Testimonials

Метод	Endpoint	Описание
GET	.../testimonials	Список отзывов
POST	.../testimonials	Создать отзыв
PUT	.../testimonials/{id}	Обновить отзыв
DELETE	.../testimonials/{id}	Удалить отзыв

Hardware Specs

Метод	Endpoint	Описание
GET	.../hardware	Получить конфигурацию железа
PUT	.../hardware	Обновить конфигурацию

A/B Tests

Метод	Endpoint	Описание
GET	.../abtests	Список тестов
POST	.../abtests	Создать тест
PUT	.../abtests/{test_key}	Обновить тест
DELETE	.../abtests/{test_key}	Удалить тест

Subscribers

Метод	Endpoint	Описание
GET	.../subscribers	Статистика подписчиков

Funnel Events

Метод	Endpoint	Описание
GET	.../events	Список событий воронки
GET	.../funnel	Общая статистика воронки
GET	.../funnel/daily	Ежедневная статистика

Discovery

Метод	Endpoint	Описание
GET	.../discovery	Ответы на discovery-вопросы

User Profiles

Метод	Endpoint	Описание
GET	.../users	Профили пользователей в воронке

GitHub Config

Метод	Endpoint	Описание
GET	.../github-config	Получить конфигурацию GitHub
PUT	.../github-config	Обновить конфигурацию

RBAC

• Admin — полный доступ ко всем воронкам
• User/Web — только свои боты (по owner_id)
• Guest — только чтение

---

← Telegram | CRM →