Pular para o conteúdo
NovoVeja como

Como Usar Variáveis de Personalização no FirstSales

Use {{merge tags}} com fallbacks, campos padrão e personalizados, e saiba quando recorrer à escrita por IA do Autopilot em vez de tokens de template.

  1. Como funcionam as merge tags

    A personalização usa merge tags envolvidas em chaves duplas: {{first_name}}, {{company_name}}. No momento do envio, cada tag é substituída pelo valor daquele contato, então um único template atende a todos de forma individual.

    Uma primeira linha padrão fica assim: Hi {{first_name}},. É assim que você envia em escala sem soar como um disparo em massa.

  2. As variáveis padrão que você pode usar

    Todo contato carrega estes campos como tags:

    • Pessoa: {{first_name}}, {{last_name}}, {{full_name}}, {{email}}, {{phone}}, {{job_title}}, {{headline}}, {{linkedin_url}}, {{timezone}}.
    • Empresa: {{company_name}}, {{company_website}}, {{company_domain}}, {{company_industry}}, {{company_size}}, {{company_linkedin}}.
    • Localização: {{city}}, {{state}}, {{country}}.

    Mais duas tags de envio para você, o remetente: {{sender_name}} e {{sender_company}}.

  3. Sempre defina um fallback

    E se um contato não tiver primeiro nome? Adicione um fallback depois de um pipe: {{first_name|there}} renderiza “there” quando o campo está vazio. Use isso em qualquer lugar onde um espaço em branco soaria estranho:

    • Hi {{first_name|there}},
    • at {{company_name|your company}}

    O FirstSales também organiza pontuação solta quando um valor está vazio, mas um bom fallback é o que mantém a frase natural.

  4. Insira tags no editor

    No editor de e-mail você não precisa digitar tags manualmente. Use a barra de ferramentas Insert merge tag ou o menu de barra / para escolher um campo de uma lista pesquisável: incluindo seus campos personalizados. As tags inseridas aparecem como chips, então são fáceis de ver e não podem ser quebradas por um caractere perdido.

    O editor também verifica tags quebradas e avisa se você colocar uma merge tag dentro de uma URL de link.

    Insira tags no editor
  5. Use campos personalizados para qualquer coisa extra

    Precisa de um dado que não é um campo padrão: um evento recente, um produto que eles usam? Adicione um campo personalizado aos seus contatos e referencie-o como uma tag snake_case, ex.: {{recent_funding}}. Campos personalizados são resolvidos a partir dos dados de cada contato, assim como os padrão (eles não podem reutilizar o nome de um campo padrão).

    É assim que você personaliza algo específico da sua prospecção, não apenas dados firmográficos genéricos.

  6. Merge tags vs escrita por IA do Autopilot

    Duas coisas diferentes compartilham a ideia de “personalização”:

    • Campanhas de Template usam as merge tags {{ }} acima: você escreve o texto, as tags preenchem as lacunas.
    • Campanhas Autopilot fazem a IA escrever cada e-mail usando ganchos de personalização sobre o contato: não é templating de merge tag.

    Então, se você quer controle preciso sobre o texto, use o modo Template com merge tags; se quer que a IA componha o texto por contato, use o Autopilot. Note que não há spintax: o pipe | é apenas para fallbacks, não para alternativas de spin aleatórias.

Dicas de especialista

  • Nunca envie uma tag sem fallback

    Use {{first_name|there}}, não {{first_name}} sozinha. Um contato com um campo faltando transforma uma tag nua em um espaço vazio estranho diante de um prospect real.

  • Insira pelo menu, não digite

    Use a barra de ferramentas Insert merge tag ou o menu / para que as tags virem chips que o editor pode validar. Chaves digitadas à mão são a causa mais comum de uma tag quebrada que é enviada literalmente.

  • Campos personalizados personalizam o que importa

    Tags firmográficas são o básico. Um campo personalizado ({{recent_funding}}, {{signup_source}}) é o que faz um e-mail parecer pesquisado em vez de mala direta.

  • Sem spintax: escolha Template ou Autopilot

    Não existe sintaxe de spin {a|b}. Para variação de texto, escreva variantes A/B reais em uma campanha Template ou deixe a IA do Autopilot compor cada e-mail.

Perguntas frequentes

Qual é a sintaxe de uma merge tag?

Chaves duplas ao redor do nome do campo: {{first_name}}, {{company_name}}. Espaços em branco dentro são tolerados ({{ first_name }}), e os valores são preenchidos por contato no momento do envio.

Como defino um padrão quando um campo está vazio?

Adicione um fallback depois de um pipe: {{first_name|there}} ou {{company_name|your company}}. O texto após o | é usado sempre que o campo daquele contato estiver vazio.

Quais variáveis estão disponíveis?

Campos padrão de contato (nome, e-mail, telefone, cargo, headline, LinkedIn, fuso horário; nome/site/domínio/setor/tamanho/LinkedIn da empresa; cidade/estado/país) mais as tags de remetente {{sender_name}} e {{sender_company}}, e qualquer campo personalizado que você adicionar.

Posso personalizar com dados personalizados?

Sim. Adicione um campo personalizado aos seus contatos e referencie-o como uma tag snake_case (ex.: {{recent_funding}}). Ele é resolvido a partir dos dados de cada contato como um campo padrão, e não pode reutilizar o nome de um campo padrão.

Como insiro uma tag sem erros de digitação?

Use a barra de ferramentas Insert merge tag ou o menu de barra / no editor para escolher um campo de uma lista pesquisável. As tags aparecem como chips, e o editor verifica tags quebradas ou uma tag colocada por engano dentro de um link.

O FirstSales suporta spintax?

Não: não há spintax / alternância de spin {a|b}. O caractere pipe é apenas para valores de fallback. Para variedade de texto, use variantes A/B em uma campanha Template ou a escrita por IA do Autopilot.

Qual a diferença disso para a personalização por IA no Autopilot?

Merge tags preenchem lacunas no texto que você escreve (modo Template). O Autopilot, em vez disso, faz a IA compor cada e-mail a partir de ganchos de personalização sobre o contato: sem templating de merge tag. Escolha Template para redação exata, Autopilot para texto escrito por IA.

Personalização

Prospecção que continua quando você desconecta.Leads, emails, follow-ups e respostas, resolvidos.

Conecte caixas ilimitadas e deixe os agentes de IA encontrarem leads, escreverem cada email e fazerem follow-up. Ou envie seus próprios modelos no modo manual. A partir de $29/mês.

$1 por 3 dias · Cancele quando quiser · Sem contrato

Instalar com IA

Seu agente de código configura a CLI e as skills do FirstSales para você.

Prompt para Claude Code

I'm setting up FirstSales (https://firstsales.io), an AI outbound sales platform: campaigns, contacts, a reply inbox, deliverability and lead signals. Help me get my workspace sending real, good emails end to end, from Claude Code.

Read these first so you know how FirstSales works:
- Developer docs and API: https://developer.firstsales.io
- CLI: https://www.npmjs.com/package/@firstsales.io/cli
- Skills for coding agents: https://github.com/firstsalesio/firstsales-skills (read README.md and GUIDE.md)

Setup
1. Install the CLI: npm install -g @firstsales.io/cli
2. Install the FirstSales skills:
   claude plugin marketplace add firstsalesio/firstsales-skills
   claude plugin install firstsales@firstsales
3. Ask me if I already have a FirstSales account. If not, send me to https://app.firstsales.io to sign up.
4. Ask me to create an API key under Settings → API → API Keys, with only the scopes we need.
   Never ask me to paste the key into this chat. Tell me to run this in my own terminal, so the key stays hidden:
   read -rs FS_KEY && firstsales auth login --api-key "$FS_KEY"; unset FS_KEY
5. Run `firstsales whoami` and tell me which workspace and organisation we are connected to.

Then ask me about my business: what I sell, who I sell to (roles, company size, countries), my best customers, and what I use today for outbound (tools, lists, mailboxes). Walk me through:
1. Teaching FirstSales my business: website, offer, proof points and case studies in the knowledge base, so the AI writes like someone who knows the product.
2. Connecting my sending mailboxes and checking my sending domain: SPF, DKIM, DMARC and warm-up. If anything is unhealthy, tell me the exact DNS record to add.
3. Bringing in contacts: import my CSV or CRM export into a clean list, remove duplicates and bad emails, and block domains I must never email (customers, competitors, my own).
4. Building my first campaign: the right list, senders, steps and timing. Write the sequence with me, show me the drafts, and do not launch until I say yes.
5. Setting up Signals if it fits: find people engaging with LinkedIn posts about topics my buyers care about, and turn them into leads.
6. Inviting my team and giving each person the right access.

Once campaigns run, show me how to work the reply inbox from here: which replies need an answer, draft responses in my voice, and move good conversations into deals. If I use Cal.com, connect it so follow-ups can offer my booking link (not the first email).

Throughout, as you learn about my business, proactively suggest and help create:
- Reply templates for the questions and objections my prospects are likely to raise, based on my product, site and codebase if you can see them.
- Campaign ideas and segments worth testing, with the reason for each.

Safety rules:
- Show every change as a dry run (--dry-run) first and wait for my yes. Never send emails, launch campaigns or delete anything without my yes.
- Tell me before anything that spends credits, and how many.

Be opinionated. If the docs give a sensible default, just use it. Don't make me choose between five options.