Намерения (intents)

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

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

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

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

Создание intent'а

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

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

Правила

Поддерживаются:

• Ключевые слова (по регистронезависимой подстроке): оплат, купить, тариф.
• Регулярные выражения (PCRE-подмножество): ^/start( |$), \d{4,}.
• Точное совпадение: команда /buy.

Несколько правил в одном intent — OR. Несколько intents в проекте — каждое сообщение может попасть в несколько intents одновременно.

Применение

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

• к новым сообщениям сразу через прокси;
• к историческим сообщениям бота — через ручную пересборку (кнопка «Пересчитать» в админке).

Сводка

В разделе Сводка intents:

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

REST API

curl "https://capybara.maxbotstat.ru/api/v1/bots/<botId>/intents" \
     -H "X-API-Key: mbs_..."

{
  "data": [
    {
      "id": "67d4...",
      "name": "payment",
      "description": "Вопросы про оплату",
      "color": "#16a34a",
      "is_active": true,
      "users_count": 312,
      "messages_count": 845,
      "created_at": "2025-09-01T10:00:00Z"
    }
  ]
}

Best practices

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