
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

