Variáveis de nome permitem personalizar mensagens e templates no Intercom puxando dados de atributos dos users, 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 tranquilas com clientes.
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 UM VALOR ALTERNATIVO AQUI"}}em macros ou templates de mensagem para inserir o primeiro nome do cliente, com um valor alternativo caso o nome esteja ausente.Em e-mails HTML, use
{{ first_name | fallback:"INSIRA UM VALOR ALTERNATIVO AQUI" }}para personalizar nomes. Defina um valor alternativo 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 alternativo (ex.: “Olá”).
Salve as alterações para garantir que os users vejam seu nome ou uma saudação alternativa.
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 customizado em vez do atributo padrão de nome do Intercom. Certifique-se de que seu fluxo usa o atributo padrão de nome.
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.
Variável de nome está em branco na primeira mensagem do Workflow de uma nova conversa: Isso pode acontecer mesmo quando o nome do cliente já é conhecido de uma conversa anterior na mesma sessão do navegador. Uma mensagem do Workflow acionada por "customer opens a new conversation in the Messenger" pode disparar antes que o SDK JavaScript do Intercom termine de identificar o user e gravar seu nome, então o valor
{{Name}}ainda não está disponível naquele exato momento e aparece em branco. Uma vez que as informações do user são salvas, o nome fica disponível para mensagens posteriores na mesma conversa. Não há garantia de primeira parte que{{Name}}será preenchido a tempo para a primeira mensagem — defina um valor alternativo na variável para que a saudação ainda soe natural se isso acontecer.Users iOS aparecem como “User” no Intercom: O Intercom atribui identificadores temporários (como “User m4m2”) quando users iOS entram em contato sem serem identificados por e-mail ou ID de user. Identifique os users durante o login passando seu e-mail ou ID único.
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.
Ao enviar e-mails para múltiplos destinatários com "Enviar separadamente" ativado, a variável de nome não personaliza o nome de cada destinatário; em vez disso, o valor alternativo ou um espaço em branco pode aparecer.
Melhores práticas
Sempre use o atributo padrão "first name" a menos que configurações customizadas sejam essenciais.
Defina valores alternativos em todas as comunicações para garantir consistência quando os dados de nome estiverem ausentes.
Para SDKs, identifique os 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 customizado 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 users iOS aparecem como “User” no Intercom?
O Intercom atribui identificadores temporários quando users iOS não são identificados por e-mail ou ID de user. Identifique os 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.

