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:
| Parte | Conteúdo |
|---|---|
| State | message (string, obrigatório), company_size (number), source (string) |
purchase_intent | probability — 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. |
priority | score — low, medium, high, critical |
route | choice — 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 |
| Composto | lead_score = 2 × purchase_intent + 1 × priority + 1 × p(route = sales), de 0 a 1 — veja Compostos |
| Políticas | 1. 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"
}
}'{
"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:
| Lead | action | action_reason |
|---|---|---|
Uma oferta de fornecedor: route = spam | block | { "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 = other | escalate (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
contextda 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,sdrenurturecom 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.7emroute: abaixo disso, vale a ação de fallback. -
Ajuste o
lead_scoremudando os pesos, ou adicione termos — uma probabilidade− 3 × spam, uma notacompany_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.
Criar com o agente
Descreva uma decisão em palavras simples e deixe o agente da Dcision montá-la no construtor visual — depois continue refinando pelo chat enquanto vê cada mudança.
Roteamento de suporte
Roteie mensagens de suporte para o departamento certo, avalie a urgência e escale para uma pessoa quando necessário, com o template Roteamento de suporte.