Templates

Templates ajudam a montar mensagens e payloads de API de forma dinamica usando dados do contexto.

Quando usar templates

• Personalizar mensagens por contato
• Montar payloads para API externa
• Reaproveitar blocos de texto em fluxos parecidos

Exemplo de mensagem dinamica

Errado

Ola {{nome}}, seu pedido {{pedidoId}} foi confirmado.

Se nome e pedidoId nao existirem no contexto raiz, o resultado quebra.

Correto

Ola {{trigger.contact.name}}, seu pedido {{variaveis.pedidoId}} foi confirmado.

Exemplo de payload

{
	"customer": "{{trigger.contact.name}}",
	"phone": "{{trigger.contact.phone}}",
	"amount": "{{variaveis.valorTotal}}"
}

Valide o payload final no simulador antes de publicar.

Cenario WhatsApp com integracao de CRM

Template de mensagem para o cliente:

Ola {{trigger.contact.name}}, recebi seu pedido sobre "{{trigger.message.text}}".
Ja estou validando seus dados e retorno em instantes.

Template de payload para API externa:

{
	"channel": "{{trigger.channel}}",
	"contactId": "{{trigger.contact.id}}",
	"contactPhone": "{{trigger.contact.phone}}",
	"summary": "{{variaveis.intentResumo}}",
	"rawMessage": "{{trigger.message.text}}"
}

Preview no FlowBuilder

Este exemplo abre direto no FlowBuilder embedado. A visualizacao em Fluxo/JSON, simulacao e operacoes do flow ficam dentro do proprio editor.

Nao foi possivel carregar o preview embedado automaticamente.

Estrategia de fallback em template

Se um campo opcional pode vir vazio, trate isso antes no flow:

1. Use Set Variable para preparar valor final.
2. No template, referencie apenas variavel ja saneada.
3. Em falta de dado critico, responda com mensagem padrao e encaminhe para fila humana.

Exemplo de mensagem de fallback:

Nao consegui validar seus dados agora. Vou te encaminhar para nosso atendimento humano.

Dicas

• Crie templates pequenos e composiveis.
• Evite logica complexa dentro do template.
• Valide o payload final no simulador antes de publicar.
• Nao use template para corrigir problema de contexto; corrija no node anterior.

Proximo passo

Se seu template depende de regra, avance para JSONLogic.