Tema
Transformar texto (template) · template_transform
Referência do nó
Kind
template_transformCategoriaDadosPara que serve
Pensa numa carta de formulário onde você preenche o nome, o endereço e o valor — e o texto inteiro é gerado automaticamente. O Transformar texto (template) faz o mesmo com dados do seu fluxo: você escreve um modelo com "espaços reservados" e ele preenche tudo na hora, gerando o texto final pronto para usar.
Quando usar
- Montar mensagens personalizadas com nome, data, valor e outros dados do cliente
- Limpar/normalizar um texto antes de enviar (remover um marcador interno, aparar espaços)
- Combinar a saída de um nó anterior (ex.: resposta de um agent) com texto fixo
- Aplicar um valor padrão quando uma variável vier vazia
Atenção
Diferente do que o nome sugere, este nó não é um interpretador Jinja2 completo. Ele suporta apenas substituição de variável com um pipeline de filtros simples — não existem blocos {% if %}/{% endif %}, {% for %}/{% endfor %} nem comentários {# ... #}. Um template com esses blocos não falha nem avisa: o nó apenas os deixa como texto literal na saída. Se você precisa de lógica condicional, use um nó Condição (if_else) antes/depois deste, não dentro do template.
Passo a passo
- Arraste o nó **Transformar texto (template)** para o canvas.

Paleta de nós aberta no canvas do Flow Builder, com as categorias disponíveis para localizar e arrastar o nó desejado
- No editor de template, escreva seu modelo usando
{{ variavel }}para inserir valores. - Encadeie filtros com
|quando precisar transformar o valor antes de inserir — ex.:{{ variavel | trim }}. - Em **Variáveis de entrada**, mapeie cada nome usado no template (`variavel`) para o dado do fluxo que deve preenchê-lo (ex.: a saída de um nó anterior).
- Visualize o resultado clicando em **Pré-visualizar** (se disponível) ou rode um teste rápido.
- A saída do template fica disponível como
{{nome_do_no.output}}para os próximos nós.
Campos
| Campo | O que faz |
|---|---|
| Template | O modelo de texto com tokens e filtros opcionais |
| Variáveis de entrada | Valores do fluxo que você quer usar dentro do template |
| Nome da saída | Como a string gerada ficará acessível nos nós seguintes |
Sintaxe suportada — o essencial
| Sintaxe | Para que serve |
|---|---|
{{ valor }} | Inserir o conteúdo de uma variável |
{{ valor | trim }} | Remove espaços/quebras de linha do início e fim |
{{ valor | upper }} / {{ valor | lower }} | Maiúsculas / minúsculas |
{{ valor | replace('de', 'para') }} | Substitui todas as ocorrências de um trecho por outro |
{{ valor | default('texto padrão') }} | Usa o texto padrão só quando valor vier vazio |
{{ valor | trim | replace('x', 'y') }} | Filtros podem ser encadeados, aplicados da esquerda para a direita |
Não suportado: blocos {% if %}/{% for %}, comentários {# ... #}, e filtros fora da lista acima (ex.: title, capitalize, join) — um filtro desconhecido é ignorado silenciosamente (o valor passa adiante sem aquele filtro).
Exemplo
Remover um marcador técnico da resposta de um agent antes de enviar ao contato (padrão usado para o agent sinalizar o desfecho da conversa sem vazar isso para o cliente):
{{ texto | replace('[DESFECHO:QUALIFICADO]', '') | replace('[DESFECHO:DESQUALIFICADO]', '') | trim }}Com Variáveis de entrada mapeando texto para a saída do nó do agent (ex.: nó_agent.text).
Dica
Use {{ valor | default('não informado') }} para evitar que a variável apareça vazia na mensagem final.
Atenção
Se a variável referenciada em Variáveis de entrada não resolver (nó anterior não executou nesse ramo, nome errado, etc.), o token vira string vazia na saída — não um erro visível. Teste sempre com o teste rápido (single-run) antes de publicar o fluxo — veja Testar e Publicar.
Saiba mais
- Testar e Publicar — rode um teste rápido antes de publicar o fluxo
