Docs/ Rules, context & knowledge

Variáveis

{{valores}} tipados e reutilizáveis que são resolvidos em rascunhos, modelos e regras.

As variáveis permitem que você defina um valor uma vez e o referencie em qualquer lugar — rascunhos, modelos, prompts de IA e condições de regras — para que você nunca cole a mesma informação duas vezes e cada referência permaneça sincronizada.

Definindo uma variável

As variáveis existem em quatro escopos: global (configurações da sua conta), pasta (uma pasta de contexto), perfil (um perfil de cliente) e fio (uma substituição pontual em uma conversa específica). Você referencia qualquer variável com a mesma sintaxe independentemente do escopo: {{nome_variavel}}.

Os nomes de variável são em minúsculas com underscores. Podem conter strings curtas — uma URL, um número, um nome, uma data. Não são projetadas para conteúdo de vários parágrafos; use modelos para isso.

Nomeie as variáveis para que sejam legíveis

Use nomes descritivos que se leem naturalmente em uma frase: {{link_calendario}}, {{nivel_plano}}, {{data_renovacao}}. Evite abreviações que o confundirão daqui a seis meses.

Variáveis integradas

AI Emaily resolve as seguintes variáveis automaticamente. Você não precisa defini-las — elas estão sempre disponíveis em qualquer contexto.

VariávelResolve paraExemplo de saída
{{first_name}}Primeiro nome do destinatário (do contato)Maya
{{name}}Nome completo do destinatário (do contato)Maya Patel
{{date}}Data de hoje, formatada conforme localidade13 de junho de 2026
{{day}}Dia da semana, formatado conforme localidadeSábado
{{time}}Hora local atual (fuso horário do remetente)9:41 AM

Saída sensível à localidade

{{date}}, {{day}} e {{time}} usam as configurações de localidade e fuso horário da sua conta. Os destinatários em localidades diferentes veem o mesmo momento absoluto renderizado na sua localidade, o que é intencional — você está dizendo a eles que horas são para você.

Ordem de resolução

Quando o mesmo nome de variável existe em mais de um nível de escopo, o escopo mais específico vence. O agente resolve nesta ordem, parando na primeira correspondência:

  1. 1

    Fio

    Um valor fixado na conversa atual substitui tudo. Use variáveis no nível do fio para exceções pontuais — um preço especial, um prazo personalizado — sem alterar seus padrões globais ou de perfil.

  2. 2

    Contato

    Variáveis definidas em um contato individual (nível de endereço). Útil para detalhes pessoais que diferem do perfil da empresa.

  3. 3

    Perfil

    Variáveis do perfil de cliente ativo (com escopo de domínio ou endereço). Estas são a fonte principal para fatos específicos do cliente, como {{data_renovacao}} ou {{nivel_conta}}.

  4. 4

    Pasta

    Variáveis definidas na pasta de contexto à qual o perfil pertence. Compartilhadas entre todos os perfis naquela pasta — boas para valores de toda a categoria, como {{email_suporte}} ou {{tipo_contrato}}.

  5. 5

    Global

    Seus padrões no nível da conta. Cada sessão de redação tem acesso aos globais: seu {{link_calendario}}, {{nome_empresa}}, {{pagina_precos}} e quaisquer outros valores que você queira disponíveis em qualquer lugar.

Resolução na prática — {{renewal_date}}
Escopo do fionão definido
Escopo do contatonão definido
Escopo do perfil (acmecorp.com)2026-09-01
Escopo da pastanão definido
Escopo globalnão definido
→ resolvido como: 2026-09-01 (do perfil)

Usando variáveis em modelos e prompts

Cole {{nome_variavel}} em qualquer parte do corpo de um modelo, no valor de uma condição de regra ou em uma instrução de prompt de IA. As variáveis são resolvidas antes de a IA gerar o texto, portanto o modelo vê o valor real — não o marcador de posição.

Se uma variável for referenciada mas não tiver valor em nenhum escopo, o agente a sinaliza como não resolvida antes do envio, em vez de deixar um {{marcador}} bruto no seu e-mail.

Olá {{first_name}},

Só um lembrete de que sua assinatura {{account_tier}} renova em {{renewal_date}}. Como sempre, seu link dedicado é {{calendar_link}} caso queira conversar antes disso.

Atenciosamente,

{{sender_name}}

Variáveis não resolvidas bloqueiam o envio

Se um {{marcador}} não puder ser resolvido no momento do envio, AI Emaily irá parar e mostrar qual variável está faltando e em qual escopo ela era esperada. Isso evita que marcadores brutos cheguem aos seus destinatários.

Frequently asked

Feature overview

Rules & Brain

Ready to try it?

Start Free Trial