Variáveis de Workflow: Como Usar Dados Dinâmicos

Variáveis permitem que você insira dados dinâmicos em e-mails, SMS, tarefas e outras ações dos workflows da Marketek. Em vez de escrever conteúdo estático, você usa placeholders que são substituídos automaticamente pelos dados reais de cada contato no momento da execução.

O Que São Variáveis

Variáveis são marcadores de texto que referenciam dados armazenados na Marketek. Quando o workflow executa uma ação, cada variável é substituída pelo valor correspondente. Por exemplo, se você escreve “Olá, {{contact.first_name}}!” em um e-mail, o contato João receberá “Olá, João!” automaticamente.

Tipos de Variáveis

Campos do Contato

Referenciam dados do registro do contato no CRM:

• {{contact.first_name}} — Primeiro nome
• {{contact.last_name}} — Sobrenome
• {{contact.full_name}} — Nome completo
• {{contact.email}} — Endereço de e-mail
• {{contact.phone}} — Telefone
• {{contact.company_name}} — Nome da empresa
• {{contact.address1}} — Endereço
• {{contact.city}} — Cidade
• {{contact.state}} — Estado

Campos Personalizados

Referenciam campos personalizados que você criou:

• {{contact.custom_field_name}} — Substitua “custom_field_name” pelo identificador do campo.

Valores Personalizados (Custom Values)

Referenciam variáveis globais da conta, úteis para dados que se repetem em muitas comunicações:

• — Nome da sua empresa
• — Telefone principal
• — E-mail de contato
• — Site institucional

Dados do Trigger

Quando o workflow é iniciado por um trigger específico, você pode acessar dados do evento:

• {{trigger.source}} — Origem que disparou o workflow
• {{trigger.form_name}} — Nome do formulário (se o trigger for envio de formulário)
• {{trigger.appointment_date}} — Data do agendamento (se o trigger for criação de agendamento)

Variáveis de Data e Hora

• {{date.today}} — Data de hoje
• {{date.tomorrow}} — Data de amanhã
• {{date.current_time}} — Hora atual

Usando Variáveis em Ações

Você pode inserir variáveis em praticamente qualquer campo de texto das ações do workflow:

• Assunto e corpo de e-mails — Personalize cada mensagem com nome, empresa e dados relevantes.
• Texto de SMS e WhatsApp — Inclua o nome do contato e informações específicas.
• Descrição de tarefas — Forneça contexto ao usuário responsável pela tarefa.
• Dados de webhook — Envie informações dinâmicas para sistemas externos.

Valores de Fallback

Quando um campo referenciado está vazio, a variável retorna em branco. Para evitar isso, use valores de fallback — textos alternativos exibidos quando o dado original não existe. Configure o fallback na interface do editor de variáveis ao inserir o marcador.

Exemplo: em vez de “Olá, !” (quando o nome está vazio), configure o fallback para exibir “Olá, amigo!” automaticamente.

Testando Variáveis

Antes de ativar um workflow com variáveis, teste sempre:

1. Crie um contato de teste com todos os campos preenchidos.
2. Adicione o contato manualmente ao workflow.
3. Verifique se os valores foram substituídos corretamente nos e-mails, SMS e tarefas geradas.
4. Teste também com um contato que tenha campos vazios para validar os fallbacks.