
Placeholders | Guia Completo: Como Usar Campos de Mesclagem e Valores Personalizados na Marketek
Guia Completo: Como Usar Campos de Mesclagem e Valores Personalizados na Marketek
Imagine poder enviar um e-mail para centenas de contatos, mas cada um deles recebe uma mensagem que parece ter sido escrita individualmente, chamando-o pelo nome ou mencionando detalhes específicos sobre seu último agendamento. Na Marketek, isso é possível e fácil de implementar graças aos Campos de Mesclagem e Valores Personalizados.
Essas ferramentas de personalização dinâmica são o segredo para criar comunicações mais humanas, relevantes e eficientes. Dominá-las é essencial para aumentar o engajamento, otimizar processos e manter a consistência da sua marca.
Este guia completo ensinará tudo o que você precisa saber, desde a diferença fundamental entre os dois recursos até como aplicá-los em suas automações mais avançadas.
🔊 Confira o nosso recurso de placeholders em audio:
O que você aprenderá neste guia:
1. A Diferença Crucial: Campos de Mesclagem vs. Valores Personalizados
Campos de Mesclagem (Merge Fields)
Valores Personalizados (Custom Values)
2. Campos de Mesclagem: Como Usar Dados de Contatos, Agendamentos e Mais
Onde Utilizar Campos de Mesclagem?
Catálogo de Campos de Mesclagem Comuns
3. Valores Personalizados: Como Reutilizar Informações Globais da Sua Empresa
Como Criar e Gerenciar seus Valores Personalizados
Exemplos Úteis para o Mercado Brasileiro
4. Dicas e Truques Avançados de Personalização
Inserindo Campos Dinâmicos com Segurança
Usando Campos Dinâmicos em Condições de Workflows
1. A Diferença Crucial: Campos de Mesclagem vs. Valores Personalizados
Embora ambos funcionem como "placeholders" (códigos que são substituídos por informações reais), eles servem a propósitos distintos. Entender essa diferença é o primeiro passo.
Campos de Mesclagem (Merge Fields)
O que são? São códigos que puxam dados que variam para cada registro individual. O valor deles depende do contexto específico do contato, do agendamento, do usuário, etc.
Exemplo: Ao usar
{{contact.first_name}}
em um e-mail, a plataforma substitui esse código pelo primeiro nome de cada contato que recebe a mensagem.Ideal para: Personalização individualizada.
Valores Personalizados (Custom Values)
O que são? São códigos que representam informações fixas e reutilizáveis em toda a sua conta. Você define esses valores uma única vez em um local centralizado.
Exemplo: Você cria o valor
{{custom_values.whatsapp_suporte}}
com o número do seu WhatsApp. Se um dia o número mudar, você o atualiza em um só lugar, e ele é corrigido automaticamente em todos os emails, páginas e mensagens onde foi usado.Ideal para: Eficiência, consistência e facilidade de manutenção.
Tabela Comparativa Rápida
2. Campos de Mesclagem: Como Usar Dados de Contatos, Agendamentos e Mais
Onde Utilizar Campos de Mesclagem?
Você pode usá-los em praticamente qualquer editor de texto na Marketek:
Corpo e Assunto de E-mails.
Mensagens SMS.
Páginas de Funis e Websites.
Ações dentro de Workflows (Ex: criar uma tarefa "Ligar para
{{contact.name}}
").Faturas, Chat Widget e muito mais.
Catálogo de Campos de Mesclagem Comuns
Aqui estão alguns dos exemplos mais úteis, categorizados por objeto:
Contato:
{{contact.first_name}}
- Primeiro nome{{contact.email}}
- E-mail{{contact.phone}}
- Telefone{{contact.city}}
- Cidade{{contact.custom_NomeDoCampo}}
- Valor de um campo personalizado que você criou.
Usuário (Remetente/Proprietário):
{{user.name}}
- Nome completo do usuário Marketek.{{user.email_signature}}
- Assinatura de e-mail configurada no perfil.{{user.calendar_link}}
- Link para a agenda pública do usuário.
Agendamento:
{{appointment.title}}
- Título do evento.{{appointment.start_time}}
- Data e hora de início.{{appointment.meeting_location}}
- Local físico ou link da reunião.{{appointment.reschedule_link}}
- Link para o contato reagendar.
Data/Hora Atual (para o padrão brasileiro):
{{right_now.little_endian_date}}
- Exibe a data atual no formato DD/MM/YYYY.

Criação de campos personalizados no Marketek
3. Valores Personalizados: Como Reutilizar Informações Globais da Sua Empresa
Como Criar e Gerenciar seus Valores Personalizados
Acesse as Configurações: Navegue até Configurações > Valores Personalizados.
Crie um Novo Valor: Clique em "+ Novo Valor Personalizado".
Defina Nome e Valor:
Nome: Dê um nome descritivo (ex: "Telefone Comercial Principal").
Chave (Key): A plataforma gerará a chave automaticamente a partir do nome (ex:
telefone_comercial_principal
). É esta chave que você usará no placeholder.Valor (Value): Insira a informação real (ex: "(11) 98765-4321").
Salve e Use: Salve o valor. Agora você pode usar o placeholder
{{custom_values.telefone_comercial_principal}}
em qualquer lugar.

Exemplos Úteis para o Mercado Brasileiro
{{custom_values.nome_empresa}}
- Nome Fantasia ou Razão Social.{{custom_values.cnpj_empresa}}
- CNPJ da empresa, útil para rodapés e faturas.{{custom_values.endereco_sede}}
- Endereço físico completo.{{custom_values.whatsapp_suporte}}
- Número principal de WhatsApp para contato.{{custom_values.link_site_principal}}
- URL do seu website.{{custom_values.chave_pix_padrao}}
- Chave PIX principal (use com cautela em locais seguros).{{custom_values.aviso_legal_padrao}}
- Texto de disclaimer ou política de privacidade para rodapés.
4. Dicas e Truques Avançados de Personalização
Inserindo Campos Dinâmicos com Segurança
A forma mais segura de inserir um placeholder é usando o menu/seletor de campos disponível nos editores de texto. Procure por um ícone de etiqueta ou um botão como "Campos Personalizados", navegue pelas categorias e clique no campo desejado. Isso evita erros de digitação na sintaxe.

Combinando Múltiplos Campos
Crie mensagens mais fluidas e contextuais combinando vários placeholders.
Exemplo:
"Olá {{contact.first_name}}, vi seu interesse no nosso serviço. Para agendar uma conversa com {{user.first_name}}, use este link: {{user.calendar_link}}."
Usando Campos Dinâmicos em Condições de Workflows
A mágica acontece aqui. Use a ação "If/Else" nos seus workflows para criar automações que se adaptam aos dados.
Exemplo:
Condição:
Contato > Campo Personalizado > 'Nível de Assinatura' > é > 'VIP'
Se sim: Enviar e-mail com oferta exclusiva.
Se não: Enviar conteúdo de nutrição padrão.
Essa lógica permite que suas automações sejam verdadeiramente inteligentes e personalizadas.
5. Solução de Problemas Comuns (Troubleshooting)
Meu campo aparece em branco ou com a sintaxe
{{...}}
?Aparece em branco: Quase sempre significa que o dado não existe no registro (ex: o campo "Primeiro Nome" do contato está vazio). Verifique e preencha o dado na fonte.
Aparece com a sintaxe
{{...}}
: Indica um erro de digitação no placeholder. A sintaxe é sensível a maiúsculas e minúsculas. Use sempre o menu seletor para evitar erros.
Meu Valor Personalizado não está funcionando?
A causa mais provável é um erro de digitação na chave (a parte depois de
custom_values.
). Verifique em Configurações > Valores Personalizados se a chave está correta.
Problemas com formatação de data ou moeda?
Data (DD/MM/YYYY): Para a data atual, use o campo
{{right_now.little_endian_date}}
. Para outras datas (como de agendamentos), a melhor solução é usar a ação "Date/Time Formatter" dentro de um Workflow para garantir o formato correto.Moeda (BRL): A formatação de moeda para Real (R$) não é automática. A solução mais simples é digitar "R$" manualmente antes do placeholder (ex:
R$ {{invoice.total_amount}}
).
6. Conclusão e Próximos Passos
Os Campos de Mesclagem e Valores Personalizados são ferramentas essenciais para transformar sua comunicação de genérica para pessoal e relevante. Ao dominar o uso de ambos, você economiza tempo, mantém a consistência da sua marca e, o mais importante, melhora a experiência do seu cliente.
Comece hoje a explorar o seletor de campos em seus e-mails e workflows e veja a diferença que a personalização dinâmica pode fazer.
Se você seguiu este guia e ainda tem alguma dúvida, nossa equipe de suporte está pronta para ajudar.
Clique aqui para entrar em contato com o Suporte da Marketek