Etapas e canais
Cada etapa da régua responde três perguntas: quando disparar (gatilho), o que fazer (ação) e por onde falar (canais). Esta página detalha as opções de cada uma.
Quando: gatilhos e offsets
O gatilho ancora a etapa numa data da cobrança, com um offset em dias:
| Gatilho | Significado | Exemplo |
|---|---|---|
Antes do vencimento (before_due) | X dias antes de vencer | Lembrete amigável a -3 dias |
No dia do vencimento (on_due) | No próprio dia | "Vence hoje" |
Após o vencimento (after_due) | X dias de atraso | Cobrança firme a +5, oferta a +15 |
Após a emissão (after_issue) | X dias após emitir | Confirmação de recebimento da fatura |
Após o pagamento (after_payment) | X dias após pagar | Agradecimento/confirmação |
A verificação diária compara a data de hoje com o gatilho de cada etapa ativa, em ordem de posição. Uma etapa executa no máximo uma vez por cobrança: se já disparou, não repete. Etapas after_due usam os dias em atraso recalculados no dia — se a cobrança entrou na régua já com 20 dias de atraso, as etapas de +3, +5 e +10 elegíveis disparam sob os mesmos limites de contato por pessoa (você não bombardeia o devedor; veja Compliance de contato).
O que: tipos de ação
| Ação | O que acontece |
|---|---|
Notificação (notification) | Envia mensagem pelos canais da etapa, com o template escolhido |
Oferta de negociação (negotiation_offer) | Cria uma oferta de acordo para a cobrança (desconto de 10%, até 3 parcelas, válida por 7 dias), visível no portal do devedor |
Tarefa manual (manual_task) | Abre uma tarefa de follow-up para a equipe, prioridade alta, prazo de 24h |
Negativação (negativation) | Cria um registro de negativação pendente + tarefa urgente de revisão humana — nada vai ao birô sem aprovação |
Protesto (protest) | Cria um registro de protesto pendente + tarefa urgente de revisão humana |
Judicial (judicial) | Abre tarefa urgente de encaminhamento ao jurídico |
Negativação, protesto e judicial nunca executam sozinhos: são workflows com revisão humana obrigatória. Cobrança com trava jurídica (legal hold) pula essas etapas automaticamente.
Por onde: canais
Uma etapa de notificação pode usar um ou mais canais: e-mail, SMS, WhatsApp, voz (ligação) e manual. O destinatário é resolvido pelo cadastro do cliente:
- E-mail — primeiro e-mail cadastrado;
- SMS e voz — telefone marcado como celular (ou o primeiro da lista);
- WhatsApp — telefone marcado como WhatsApp; sem ele, cai no celular.
Se o cliente não tem contato para o canal, aquele canal é simplesmente pulado — os demais seguem. Cada combinação cobrança + etapa + canal tem uma chave de idempotência: mesmo com jobs concorrentes, a mesma mensagem nunca sai duas vezes.
:::caution Voz ainda não dispara O canal de voz (ligação) aparece na configuração, mas ainda não é disparado — hoje é um canal planejado, sem efeito no envio. Uma etapa só de voz não gera contato. Para ligações, use uma tarefa manual e registre o retorno. Os canais que efetivamente enviam hoje são e-mail, SMS e WhatsApp (o canal manual apenas registra que o contato será feito por uma pessoa). :::
Tom e template
Cada etapa carrega um tom (amigável, neutro, firme, urgente) e um template de mensagem com variáveis interpoladas — nome do cliente, valor atualizado, dias de atraso, link de pagamento. Sem template, o sistema envia um lembrete genérico com a descrição da cobrança; na prática, você sempre vai querer um template por etapa.
Condições da etapa
Etapas podem carregar condições adicionais registradas junto da etapa; elas são preservadas no snapshot da versão publicada, e o resultado da avaliação de cada condição fica gravado na execução da etapa (conditionsResult) — você consegue responder "por que essa mensagem saiu (ou não saiu)?" olhando o registro. Independentemente de condição, a supressão ativa sempre vence: nenhuma condição de etapa passa por cima de um opt-out ou de uma disputa aberta.