Воронки

Воронка — это упорядоченный список «этапов», по которым проходит пользователь. Например:

1. Пришёл по /start.
2. Дошёл до выбора тарифа.
3. Оплатил.

MaxBotStat считает, сколько контактов добралось до каждого этапа, и показывает конверсию.

Этапы

Этап описывается условием на сообщение. Поддерживаются:

• Текст: точное совпадение или подстрока.
• Команда: /start, /help, /buy.
• Намерение: пользователь сказал что-то, что попадает в категорию (см. Намерения).

Пример воронки «Покупка тарифа Pro»:

№	Название	Условие
1	Старт	команда /start
2	Открыл каталог	намерение catalog
3	Выбрал тариф Pro	текст содержит pro
4	Подтвердил оплату	намерение payment_confirm

Настройка

Бот → Воронки → Создать воронку. Дайте имя, добавьте этапы по одному. Каждое условие срабатывает на входящих сообщениях (direction='in').

Расчёт

MaxBotStat для каждого контакта проверяет:

1. было ли у него хоть одно сообщение, удовлетворяющее условию этапа N;
2. если да — он считается «дошедшим» до этапа N.

Конверсия N → N+1 = count(дошёл до N+1) / count(дошёл до N).

TIP

Порядок имеет значение: «дошёл до 3» неявно означает «прошёл 1 и 2». В кабинете вы увидите наглядную воронку с уменьшающимся «горлышком».

Открытый API

Конфигурация воронки и расчёт доступны через закрытые методы кабинета (с сессионным ключом):

GET  /api/bots/:id/funnel/config
PUT  /api/bots/:id/funnel/config
GET  /api/bots/:id/funnel

В открытом API /api/v1/... воронок пока нет — данные считаются по закрытому API кабинета.

Что попадает в шаги

• Только входящие сообщения. Ответы бота не считаются «прохождением этапа».
• Время прохождения этапа = время первого подходящего сообщения.
• Если пользователь повторно «прошёл» этап (написал то же самое второй раз) — это не считается ещё раз.

Связь с UTM

Воронку можно фильтровать по источнику в кабинете: «конверсия пользователей с utm_source=instagram». Полезно для сравнения каналов трафика.