Тема

Намерения ​

Намерение — это категория, в которую MaxBotStat относит входящее сообщение. Например:

  • greeting — пользователь поздоровался;
  • payment — спросил про оплату;
  • complaint — выразил недовольство;
  • support_request — попросил помощь.

Назначение — двигатель сегментации:

  • Воронки: этап «дошёл до оплаты» = намерение payment.
  • Рассылка: только тем, у кого было намерение complaint.
  • Аналитика: топ-категории, динамика во времени.

Создание намерения ​

Бот → Намерения → Создать. Поля:

ПолеОписание
Имятехнический ключ (без пробелов)
Описаниедля команды
Цветдля подсветки в кабинете
Активноможно временно выключить
Правилаусловия срабатывания

Правила ​

Правила задаются как группы условий:

  • Внутри группы условия соединены логическим И (должны выполниться все).
  • Группы между собой соединены логическим ИЛИ (срабатывает любая).

Это даёт двухуровневую логику (DNF): «(A И B) ИЛИ (C И D)».

Типы условий ​

  • Слова в сообщении пользователя — подстроки в тексте входящего сообщения (без учёта регистра), любое из перечисленных слов засчитывается.
  • Нажатая кнопка — значение callback (callback_data в Telegram, payload в MAX) или подпись [button] ….
  • Текст в предыдущем сообщении бота — подстрока в тексте последнего исходящего сообщения бота этому пользователю (без учёта регистра).

Примеры ​

«Юзер пишет про оплату» — одна группа из одного условия:

Группа 1: слова = ["оплат", "купить", "цена"]

«Юзер нажал кнопку Да в ответ на вопрос Хотите узнать цену?» — одна группа из двух условий:

Группа 1: текст бота = "хотите узнать цену"  И  кнопка = ["yes"]

«Согласие на цену любым способом» — две группы:

Группа 1: текст бота = "хотите узнать цену"  И  кнопка = ["yes"]
ИЛИ
Группа 2: текст бота = "хотите узнать цену"  И  слова = ["да", "ок", "хочу"]

Применение ​

После сохранения намерение применяется:

  • к новым сообщениям — сразу при их поступлении;
  • к историческим — пересчёт запускается автоматически при сохранении правил.

Сводка ​

В разделе Сводка намерений:

  • сколько контактов попало в каждое намерение;
  • сколько сообщений;
  • топ-сообщения, сработавшие на правило (для проверки качества).

Открытый API ​

bash
curl "https://app.maxbotstat.ru/api/v1/bots/<botId>/intents" \
     -H "X-API-Key: mbs_..."
json
{
  "data": [
    {
      "id": "67d4...",
      "name": "payment",
      "description": "Вопросы про оплату",
      "color": "#16a34a",
      "is_active": true,
      "users_count": 312,
      "messages_count": 845,
      "created_at": "2025-09-01T10:00:00Z"
    }
  ]
}

Рекомендации ​

  • Не плодите намерения — лучше 5–7 широких категорий, чем 50 узких.
  • Давайте намерениям понятные имена (payment_question, не i7).
  • Сначала пробуйте одну группу с одним условием. Усложняйте только если ловит лишнее.
  • Помните: один и тот же текст может попасть в несколько намерений — это часто полезно (payment + complaint).

MaxBotStat

© 2026 MaxBotStat