Квалификация лидов

Оценивайте намерение купить, задавайте приоритет, ранжируйте по оценке лида и направляйте входящие лиды в продажи, SDR или прогрев — и блокируйте спам — с шаблоном Lead Qualification.

Цель: каждый входящий лид (контактная форма, чат, e-mail) за несколько сотен миллисекунд получает оценку намерения купить, приоритет, оценку лида и команду-получателя, а очевидный спам никогда не попадает в вашу CRM. Шаблон сочетает три паттерна: маршрутизацию по намерению, маршрутизацию с порогом уверенности и композитную оценку.

Создание решения

В приложении откройте Шаблоны → Квалификация лидов → Создать решение. Черновик содержит:

ЧастьСодержимое
Statemessage (string, обязательное), company_size (number), source (string)
purchase_intentprobability — реальное намерение купить в ближайшие 30 дней? Да: просит цены, демо, коммерческое предложение или дату старта. Нет: просто смотрит, студент, поставщик или спам.
priorityscore — low, medium, high, critical
routechoice — sales (высокое намерение, готов говорить с продажами), sdr (некоторое намерение, нужна квалификация), nurture (ранняя стадия, отправить контент), spam (спам, предложение поставщика или нерелевантное), other
Композитlead_score = 2 × purchase_intent + 1 × priority + 1 × p(route = sales), от 0 до 1 — см. Композиты
Политики1. route = spam → block · 2. уверенность purchase_intent ниже 0.6 → escalate

Проверьте его в Playground, затем нажмите Опубликовать v1.

Вызов

curl -X POST https://api.dcision.io/v1/decisions/lead-qualification \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lead-8421" \
  -d '{
    "state": {
      "message": "We need pricing for 500 users and want to start next month.",
      "company_size": 500,
      "source": "website"
    }
  }'
200 OK
{
  "decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
  "execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
  "schema": "lead-qualification",
  "version": 1,
  "result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
  "confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
  "scores": { "priority": 2.81 },
  "composites": { "lead_score": 0.8414 },
  "action": "continue",
  "action_reason": { "type": "default" },
  "metrics": { "latency_ms": 412, "engine": "jev", "model": "jev-1.13.0", "estimated_cost_usd": 0.00001575, "input_tokens": 375, "output_tokens": 36 }
}

Другие исходы, которые вы увидите:

Лидactionaction_reason
Предложение поставщика: route = spamblock{ "type": "policy", "rule": 0 }
Неоднозначное сообщение: purchase_intent = 0.45 (уверенность 0.1)escalate{ "type": "policy", "rule": 1 }
Ничего не подходит — отклик на вакансию: route = otherescalate (действие fallback){ "type": "other_option", "question": "route" }

Уверенность вероятности равна |2p − 1|, поэтому правило 2 эскалирует каждый лид, у которого purchase_intent находится между 0.2 и 0.8, — см. Уверенность и вероятности.

Действия по результату

async function qualify(lead) {
  const response = await fetch("https://api.dcision.io/v1/decisions/lead-qualification", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.DCISION_API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": `lead-${lead.id}`,
    },
    body: JSON.stringify({ state: { message: lead.message, company_size: lead.companySize, source: lead.source } }),
  });
  if (!response.ok) return crm.assign(lead, "sdr"); // on errors, a person decides
  const { action, result, composites, execution_id } = await response.json();

  switch (action) {
    case "block":
      return crm.discard(lead, { reason: "spam", execution_id });
    case "escalate":
      return crm.assign(lead, "sdr", { note: "needs review", execution_id });
    default: {
      const sla = { critical: "1h", high: "4h", medium: "1d", low: "3d" }[result.priority];
      return crm.assign(lead, result.route, { sla, score: composites.lead_score, execution_id });
    }
  }
}

Сортируйте очередь каждой команды по lead_score, чтобы сначала работать с лучшими лидами. Поля, которые решение не объявляет, всё равно передаются движку, поэтому можно добавить контекст вроде country или page, не меняя схему.

Настройка

  • Опишите свой бизнес в context решения: что вы продаёте, кому, ваш ценовой диапазон. Он отправляется с каждым лидом.

  • Уточните границы между sales, sdr и nurture с помощью исключений ("not for existing customers", "no budget or timeline mentioned"). Если Playground отмечает почти ничью, описания пересекаются.

  • Эскалируйте критичные лиды человеку, даже когда маршрутизация уверенная:

    { "field": "priority", "on": "output", "operator": "gte", "value": "critical", "action": "escalate" }
  • Эскалируйте по взвешенному уровню, чтобы ловить лиды, которые тяготеют к critical, даже когда наиболее вероятный уровень — high: { "field": "priority", "on": "score", "operator": "gte", "value": 3.5, "action": "escalate" }.

  • Требуйте уверенной маршрутизации с "minConfidence": 0.7 для route: ниже этого порога применяется действие fallback.

  • Настройте lead_score, меняя его веса, или добавьте слагаемые — вероятность − 3 × spam, оценку company_fit, — а затем маршрутизируйте по нему: { "field": "lead_score", "operator": "gte", "value": 0.8, "action": "continue" }.

  • Повторяйте реальные лиды: в разделе Выполнения откройте запуск и нажмите Повторить эти входные данные в Playground, чтобы проверить, что правка его улучшает, прежде чем публиковать v2.

На этой странице