Skip to main content

​
Como funciona

Follow-ups são mensagens automáticas disparadas com base em regras de tempo e comportamento do lead. Eles são configurados na plataforma pela equipe e executados automaticamente pelo sistema. Via API você pode:
  • Consultar as regras configuradas e follow-ups pendentes
  • Agendar um follow-up manualmente fora do fluxo automático
  • Cancelar um follow-up antes de ele ser enviado

​
Tipos de trigger

TriggerQuando dispara
silenceLead ficou X minutos sem responder
post_handoverX minutos após transferência para consultor
post_contactX minutos após o primeiro contato

​
Tipos de conteúdo

TipoComportamento
fixed_messageEnvia exatamente o texto configurado no campo message
ai_objectiveA IA gera uma mensagem contextualizada com base no objective

​
Passo 1 — Liste as configurações

curl https://api.cordialy.ai/integrations/v1/followups/configs \
  -H "X-API-Key: SUA_KEY"

[
  {
    "id": "cfg-001",
    "name": "Reativação após silêncio",
    "is_active": true,
    "trigger_type": "silence",
    "trigger_delay_minutes": 60,
    "followup_type": "ai_objective",
    "objective": "Reativar o lead e entender por que parou de responder",
    "max_attempts": 3,
    "min_interval_minutes": 1440
  }
]

​
Passo 2 — Agende um follow-up

curl -X POST https://api.cordialy.ai/integrations/v1/followups/scheduled \
  -H "X-API-Key: SUA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "LEAD_ID",
    "config_id": "cfg-001",
    "scheduled_at": "2026-06-25T10:00:00.000Z"
  }'
Se scheduled_at for omitido, o sistema usa agora + trigger_delay_minutes da configuração.

​
Passo 3 — Cancele se necessário

Cancele quando o lead já respondeu ou converteu antes do disparo: 
curl -X DELETE https://api.cordialy.ai/integrations/v1/followups/scheduled/FOLLOWUP_ID \
  -H "X-API-Key: SUA_KEY"
Só é possível cancelar follow-ups com status pending. Se o follow-up já foi enviado, não há reversão.

​
Monitorar follow-ups pendentes

# Todos os pendentes da loja
curl https://api.cordialy.ai/integrations/v1/followups/scheduled \
  -H "X-API-Key: SUA_KEY"

# Pendentes de um lead específico
curl "https://api.cordialy.ai/integrations/v1/followups/scheduled?lead_id=LEAD_ID" \
  -H "X-API-Key: SUA_KEY"

​
Padrões de uso

Quando um negócio é fechado no seu CRM, cancele os follow-ups pendentes para não incomodar o cliente:
async function onNegocioFechado(deal) {
  // Atualiza status na Cordialy
  await atualizarLead(deal.leadId, { status: 'converted' });

  // Cancela follow-ups pendentes
  const followups = await listarFollowups(deal.leadId);
  const pendentes = followups.filter(f => f.status === 'pending');

  await Promise.all(pendentes.map(f => cancelarFollowup(f.id)));
}
Após uma reunião no calendário, agende automaticamente um follow-up para o dia seguinte:
// Webhook do Google Calendar / Nylas
async function onReuniaoFinalizada(evento) {
  const amanha = new Date();
  amanha.setDate(amanha.getDate() + 1);
  amanha.setHours(10, 0, 0, 0);

  await agendarFollowup({
    lead_id: evento.leadId,
    config_id: CONFIG_POS_REUNIAO,
    scheduled_at: amanha.toISOString(),
  });
}
Quando um cliente abandona o carrinho no e-commerce, agende um follow-up com desconto:
async function onCarrinhoAbandonado(carrinho) {
  // Espera 2 horas antes de disparar
  const scheduledAt = new Date(Date.now() + 2 * 60 * 60 * 1000);

  await agendarFollowup({
    lead_id: carrinho.leadId,
    config_id: CONFIG_CARRINHO_ABANDONADO,
    scheduled_at: scheduledAt.toISOString(),
  });
}