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 e manual. O destinatário é resolvido pelo cadastro do cliente:
- E-mail — primeiro e-mail cadastrado;
- SMS — 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 não é configurável O canal de voz (ligação) não pode ser escolhido em etapas: não há provedor de telefonia, e a API rejeita a criação ou edição de etapa com voz (erro de validação). Para ligações, use a ação de tarefa manual — ela abre uma tarefa de ligação para a equipe.
Réguas antigas que já tinham etapa de voz não quebram: quando a etapa dispara, em vez de uma ligação o sistema abre uma tarefa de ligação ("Ligar para [cliente]", prioridade alta) com o texto do template como roteiro, e registra a execução normalmente. Os canais que efetivamente enviam mensagens 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.