Variáveis de nome permitem personalizar mensagens e templates no Intercom puxando dados de atributos do usuário, como primeiro nome. Este guia explica como usar variáveis de nome, aborda problemas comuns e oferece soluções para garantir interações personalizadas e sem falhas.
Personalize mensagens e templates para cada cliente.
Melhore o engajamento do cliente com conteúdo dinâmico.
Evite cumprimentos estranhos quando os dados do nome estiverem ausentes.
Como usar variáveis de nome
Personalize mensagens em templates e macros
Use
#fnou#{{first_name|fallback:"INSIRA O VALOR PADRÃO AQUI"}}em macros ou templates de mensagem para inserir o primeiro nome do cliente, com um valor padrão caso o nome esteja ausente.Em e-mails HTML, use
##{{ first_name | fallback:"INSIRA O VALOR PADRÃO AQUI" }}para personalizar nomes. Defina um valor padrão para exibir quando o nome não estiver disponível.No seu workspace do Intercom, selecione variáveis nas opções de placeholder do editor de texto para inserir e personalizar atributos de nome.
Personalize mensagens de post
Abra o Post no modo de edição.
Coloque o cursor onde deseja que o nome apareça.
Insira o atributo “first name” pelo menu de texto.
Clique no ícone amarelo de aviso para definir um valor padrão (ex.: “Olá”).
Salve as alterações para garantir que users vejam seu nome ou uma saudação padrão.
Use variáveis de nome em macros
Abra o menu de ação e crie uma macro.
Personalize o texto da sua macro e selecione Inserir atributo → First name.
Para usar a macro, pressione
SHIFT + #ao responder e selecione sua macro salva.
Solução de problemas e melhores práticas
Problemas comuns e soluções
O primeiro nome do user aparece diferente: Isso geralmente acontece quando o nome é puxado de um atributo personalizado em vez do atributo padrão de nome do Intercom. Certifique-se de que seu fluxo use o atributo padrão de nome.
O atributo de nome está em branco: O atributo de nome não é obrigatório ao criar ou atualizar users. Se não definido, permanece vazio. Sempre forneça um valor de nome ao armazenar registros de users.
Nome presente na resposta da API mas não visível no Intercom: Se uma requisição Ping do seu site ou integração enviar um campo de nome vazio, isso pode sobrescrever o nome existente do user com um valor em branco. Garanta que as requisições Ping incluam o nome correto.
iOS users aparecem como “User” no Intercom: O Intercom atribui identificadores temporários (como “User m4m2”) quando iOS users entram em contato sem serem identificados por e-mail ou ID de user. Identifique users durante o login passando seu e-mail ou ID único de user.
Posts cumprimentam users com “Hi First Name” em vez do nome real: Isso acontece quando a saudação está codificada. Use o atributo dinâmico "first name" do Intercom com uma opção de fallback.
Melhores práticas
Sempre use o atributo padrão "first name" a menos que configurações personalizadas sejam essenciais.
Defina valores padrão em todas as comunicações para garantir consistência quando os dados do nome estiverem ausentes.
Para SDKs, identifique users o mais cedo possível usando um identificador estável, como um endereço de e-mail.
Revise regularmente as configurações da API para evitar sobrescritas por campos vazios.
Perguntas frequentes
Por que o primeiro nome do user aparece diferente no Intercom?
Isso geralmente acontece quando o nome é puxado de um atributo personalizado em vez do atributo padrão de nome. Use o atributo padrão "first name" para garantir precisão.
Por que o atributo de nome às vezes está em branco?
O atributo de nome não é obrigatório. Se não definido, permanece vazio. Sempre forneça um valor de nome ao armazenar contatos no Intercom.
Por que um nome está presente na resposta da API mas não é visível no Intercom?
Uma requisição Ping com campo de nome vazio pode sobrescrever o nome existente. Certifique-se de que as requisições Ping sempre incluam o nome correto.
Por que iOS users aparecem como “User” no Intercom?
O Intercom atribui identificadores temporários quando iOS users não são identificados por e-mail ou ID de user. Identifique users durante o login para evitar isso (ex.: via endereço de e-mail).
Por que um Post cumprimentou users com “Hi First Name”?
Isso acontece quando a saudação está codificada. Use atributos dinâmicos com fallback para exibir o nome real.