Nem toda regra cabe bem em uma condição simples. Às vezes você precisa calcular um score, normalizar um telefone, validar um documento, montar um payload ou transformar dados antes de seguir. O nó Código existe para essas situações em que o workflow precisa de lógica determinística e controlada.
Quando o código ajuda
O nó Código é útil quando a regra não deve depender de interpretação do modelo. Se a conta precisa somar pontos, verificar faixas, formatar campos ou retornar um objeto estruturado, código costuma ser mais previsível do que uma instrução em linguagem natural.
Ele também ajuda a preparar dados para etapas seguintes. Depois de extrair variáveis, você pode calcular prioridade, montar uma mensagem resumida ou criar um resultado que será usado por uma Divisão lógica.
- Calcular score de lead.
- Normalizar telefone, data ou documento.
- Validar campos antes de uma integração.
- Montar payload para outro nó.
- Combinar múltiplas variáveis em uma decisão.
Vantagens no workflow
A vantagem principal é previsibilidade. Um cálculo de prioridade precisa retornar o mesmo resultado para os mesmos dados. Um prompt pode variar, mas uma regra em código bem escrita não deveria variar.
Outra vantagem é separar responsabilidades. O nó Conversa fala com a pessoa. O nó Extrair variável coleta dados. O nó Código transforma esses dados. A Divisão lógica decide a rota. Essa separação deixa o fluxo mais fácil de testar e explicar.
- Reduz ambiguidade em regras numéricas.
- Facilita validações antes de chamar APIs.
- Evita prompts cheios de regra técnica.
- Ajuda a reutilizar o mesmo resultado em várias rotas.
Quando evitar
Código não é o lugar certo para escrever diálogo. Se você está tentando colocar frases, objeções e tom de voz dentro do código, o nó correto provavelmente é Conversa. Código também não deve guardar segredo, token ou credencial.
Se a regra começa a ficar grande demais, talvez ela pertença a um serviço externo com logs, testes e versionamento. O nó Código deve ser pequeno, legível e focado em uma transformação específica.
- Evite para diálogos longos.
- Evite para regras críticas sem fallback.
- Evite colocar credenciais no workflow.
- Evite miniaplicações difíceis de manter.
Exemplo de uso
Um agente de vendas pode extrair cargo, tamanho da empresa e interesse. Em seguida, o nó Código calcula um score simples. Se o contato é decisor, tem time grande e demonstrou interesse alto, o score sobe. Depois a Divisão lógica decide se vai para agendamento ou nutrição.
Esse padrão deixa o critério de qualificação claro. Em vez de depender de uma frase genérica como "se parecer bom", o time define uma regra objetiva e pode ajustá-la depois com base nas transcrições.
- Extrair variável coleta cargo, tamanho e interesse.
- Código calcula score.
- Divisão lógica roteia por faixa de score.
- Encerramento confirma o próximo passo adequado.