Qualificação de leads

Dê nota à intenção de compra, defina uma prioridade, ranqueie com um lead score e encaminhe leads recebidos para vendas, SDRs ou nutrição — e bloqueie spam — com o template de qualificação de leads.

Objetivo: todo lead recebido (formulário de contato, chat, e-mail) recebe uma nota de intenção de compra, uma prioridade, um lead score e um time de destino em poucas centenas de milissegundos, e spam óbvio nunca chega ao seu CRM. O template combina três padrões: roteamento por intenção, roteamento por confiança e pontuação composta.

Crie a decisão

No app, abra Templates → Qualificação de leads → Criar decisão. O rascunho contém:

ParteConteúdo
Statemessage (string, obrigatório), company_size (number), source (string)
purchase_intentprobability — intenção real de comprar nos próximos 30 dias? Sim: pede preço, uma demo, um orçamento ou uma data de início. Não: só olhando, estudante, fornecedor ou spam.
priorityscore — low, medium, high, critical
routechoice — sales (alta intenção, pronto para falar com vendas), sdr (alguma intenção, precisa de qualificação), nurture (estágio inicial, enviar conteúdo), spam (spam, oferta de fornecedor ou irrelevante), other
Compostolead_score = 2 × purchase_intent + 1 × priority + 1 × p(route = sales), de 0 a 1 — veja Compostos
Políticas1. route = spam → block · 2. confiança de purchase_intent abaixo de 0,6 → escalate

Teste no Playground e então clique em Publicar v1.

Chame

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 }
}

Outros resultados que você vai ver:

Leadactionaction_reason
Uma oferta de fornecedor: route = spamblock{ "type": "policy", "rule": 0 }
Uma mensagem ambígua: purchase_intent = 0,45 (confiança 0,1)escalate{ "type": "policy", "rule": 1 }
Nada se encaixa — uma candidatura a vaga: route = otherescalate (a ação de fallback){ "type": "other_option", "question": "route" }

A confiança de uma probabilidade é |2p − 1|, então a regra 2 escala todo lead cujo purchase_intent esteja entre 0,2 e 0,8 — veja Confiança e probabilidades.

Aja sobre o resultado

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 });
    }
  }
}

Ordene a fila de cada time por lead_score para trabalhar os melhores leads primeiro. Campos que a decisão não declara ainda são repassados ao engine, então você pode acrescentar contexto como country ou page sem mudar o schema.

Ajuste

  • Descreva o seu negócio no context da decisão: o que você vende, para quem, a sua faixa de preço. Ele é enviado com cada lead.

  • Deixe mais nítidas as fronteiras entre sales, sdr e nurture com exclusões ("não para clientes atuais", "sem orçamento ou prazo mencionado"). Se o Playground sinalizar um quase empate, as descrições se sobrepõem.

  • Escale leads críticos para uma pessoa mesmo quando o roteamento tem confiança:

    { "field": "priority", "on": "output", "operator": "gte", "value": "critical", "action": "escalate" }
  • Escale pelo nível ponderado para pegar leads que tendem a crítico mesmo quando high é o nível mais provável: { "field": "priority", "on": "score", "operator": "gte", "value": 3.5, "action": "escalate" }.

  • Exija roteamento confiante com "minConfidence": 0.7 em route: abaixo disso, vale a ação de fallback.

  • Ajuste o lead_score mudando os pesos, ou adicione termos — uma probabilidade − 3 × spam, uma nota company_fit — e então roteie por ele: { "field": "lead_score", "operator": "gte", "value": 0.8, "action": "continue" }.

  • Rode leads reais de novo: em Execuções, abra uma execução e use Rodar esta entrada de novo no Playground para conferir se uma edição a melhora antes de publicar a v2.

Nesta página