Skip to content

Transformar texto (template) · template_transform ​

Para 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

Passo a passo
  1. 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

    Paleta de nós aberta no canvas do Flow Builder, com as categorias disponíveis para localizar e arrastar o nó desejado

  2. No editor de template, escreva seu modelo usando {{ variavel }} para inserir valores.
  3. Encadeie filtros com | quando precisar transformar o valor antes de inserir — ex.: {{ variavel | trim }}.
  4. 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).
  5. Visualize o resultado clicando em **Pré-visualizar** (se disponível) ou rode um teste rápido.
  6. A saída do template fica disponível como {{nome_do_no.output}} para os próximos nós.

Campos
CampoO que faz
TemplateO modelo de texto com tokens e filtros opcionais
Variáveis de entradaValores do fluxo que você quer usar dentro do template
Nome da saídaComo a string gerada ficará acessível nos nós seguintes

Sintaxe suportada — o essencial ​

SintaxePara 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.


Saiba mais ​