Templates Jinja

Os templates Jinja permitem montar mensagens dinâmicas usando dados do atendimento, do cliente, do contrato e das faturas consultadas no ERP.

Eles aparecem em configurações como mensagens de fatura, mensagens de desbloqueio em confianca, templates de fallback e campos dinâmicos de templates Meta.

Recursos combináveis

Templates Jinja podem ser combinados com Text Rotation para variar saudações, frases curtas e mensagens automáticas sem perder variáveis como {{ cliente.nome }}, {{ delay(5) }} e demais blocos Jinja.

Sintaxe básica

Use {{ variavel }} para inserir o valor de uma variável:

Olá {{ cliente.nome }}, sua fatura vence em {{ fatura.vencimento }}.

Também e possível usar aliases diretos quando o contexto de fatura está disponível:

Linha Digitável: {{ linhadigitavel }}
Vencimento: {{ vencimento }}
Link do Boleto: {{ link }}

Quebra de mensagem

Use {{ quebra_de_linha }} para dividir o texto em mensagens separadas.

Olá {{ cliente.nome }}.
{{ quebra_de_linha }}
Segue sua fatura:
Linha Digitavel: {{ fatura.linhadigitavel }}

Cada parte sera enviada como uma mensagem independente.

Atraso entre mensagens

Use {{ delay(segundos) }} para aguardar antes de enviar a próxima parte do template.

Estou localizando suas faturas...
{{ delay(3) }}
{{ quebra_de_linha }}
Encontrei a fatura do contrato {{ contrato.id }}.

O limite maximo por atraso e 120 segundos.

Envio de mídia por URL

Existem duas formas comuns de enviar mídia por URL em templates:

1. Usar {file={{ variavel }}} quando a URL precisa ser renderizada pelo Jinja.
2. Informar uma URL pública direta quando o campo ou canal de envio aceita mídia por URL.

Exemplo com URL renderizada a partir da fatura:

Ola {{ cliente.nome }}, segue sua fatura.
{{ quebra_de_linha }}
Linha Digitavel: {{ fatura.linhadigitavel }}
{{ quebra_de_linha }}
{file={{ fatura.link }}}

Depois do render, o sistema interpreta o resultado como:

{file=https://seudominio.com/boleto.pdf}

Exemplo com URL pública direta:

Segue o arquivo solicitado:
{{ quebra_de_linha }}
{file=https://seudominio.com/arquivos/manual.pdf}

Quando o recurso aceitar URL direta em um campo próprio de mídia, também é possível informar apenas a URL pública:

https://seudominio.com/arquivos/manual.pdf

informação

A URL precisa ser pública e acessível pelo servidor/canal de envio. No WhatsApp Cloud API, a URL original é repassada para envio de mídia quando possível.

Variaveis de cliente

Disponiveis em contextos de fatura e ERP:

Variavel	Descricao
{{ cliente.nome }}	Nome do cliente
{{ cliente.name }}	Alias do nome do cliente
{{ cliente.cpfcnpj }}	Documento autenticado
{{ cliente.email }}	E-mail do cliente
{{ cliente.telefone }}	Telefone do cliente
{{ cliente.erp_id }}	Identificador do cliente no ERP, quando disponivel
{{ customer.nome }}	Alias de cliente.nome
{{ customer.cpfcnpj }}	Alias de cliente.cpfcnpj

Variaveis de contrato

Variavel	Descricao
{{ contrato.id }}	ID do contrato selecionado
{{ contrato.contrato_id }}	Alias do ID do contrato
{{ contrato.endereco_logradouro }}	Logradouro do contrato
{{ contrato.endereco_numero }}	Numero do endereco
{{ contrato.tipo_servico }}	Tipo de servico
{{ contrato.status }}	Status do contrato
{{ contract.id }}	Alias de contrato.id
{{ contrato_id }}	ID do contrato em formato direto

Variaveis de fatura

Use fatura para a fatura atual dentro do envio de faturas:

Variavel	Descricao
{{ fatura.linhadigitavel }}	Linha digitavel do boleto
{{ fatura.vencimento }}	Data de vencimento
{{ fatura.link }}	Link da fatura/boleto
{{ fatura.valor }}	Valor da fatura, quando o ERP retornar
{{ fatura.id }}	ID da fatura, quando o ERP retornar
{{ fatura.status }}	Status da fatura, quando o ERP retornar
{{ invoice.linhadigitavel }}	Alias de fatura.linhadigitavel
{{ invoices }}	Lista de faturas renderizavel em Jinja

As chaves da fatura tambem sao expostas diretamente quando existem:

Linha Digitavel: {{ linhadigitavel }}
Vencimento: {{ vencimento }}
Link: {{ link }}

Filtro de data

Use |data_br para formatar datas em dd/mm/aaaa quando o valor for uma data reconhecida:

Vencimento: {{ fatura.vencimento|data_br }}

Exemplo completo de fatura

Ola {{ cliente.nome }}.
{{ quebra_de_linha }}
Contrato: {{ contrato.id }}
Vencimento: {{ fatura.vencimento|data_br }}
Linha Digitavel: {{ fatura.linhadigitavel }}
{{ quebra_de_linha }}
{file={{ fatura.link }}}

Boas praticas

• Use {{ quebra_de_linha }} quando a mensagem ficar muito longa.
• Use {file={{ fatura.link }}} apenas quando a URL apontar diretamente para um arquivo publico.
• Prefira variaveis com escopo, como {{ cliente.nome }} e {{ fatura.link }}, para deixar o template mais claro.
• Teste templates com faturas reais de homologacao antes de ativar em producao.