Esta resposta vem do fórum da Comunidade Intercom. 👌
Tenho duplicatas de alguns users, todos com o mesmo endereço de email. Como isso aconteceu? Como posso corrigir?
Se você tem vários clientes no seu workspace Intercom com o mesmo endereço de email, pode ser porque você está passando um user_ID diferente para cada um. Além disso, o Intercom pode associar comunicações recebidas ao perfil de user mais recentemente atualizado se múltiplos perfis usarem o mesmo email. Para evitar confusão, certifique-se de que cada user seja identificado de forma única por um ID de user consistente e exclusivo.
Para quem isso se aplica: Qualquer administrador do workspace ou colega com acesso a Contacts. A deduplicação baseada em API requer credenciais API. A fusão de Leads em Users pode ser feita via API Intercom ou diretamente do Inbox.
Como o Intercom identifica users
Quando você define tanto um endereço de email quanto um user_ID para um user, o Intercom usa o user_ID como identificador único. O Intercom também pode usar identificação baseada em cookies para fundir perfis sem emails, o que ajuda a unificar automaticamente os perfis Visitor/Lead e User com base no comportamento do dispositivo. Evite alterar o user_id para um email existente, pois isso cria um novo perfil de User e pode gerar duplicatas.
Duplicatas causadas por importações CSV
No Intercom, um User é um contato identificado com um user_id definido, e um Lead é um contato não identificado — como um visitante do site que ainda não fez login.
Uma causa comum de perfis de user duplicados durante importações CSV (valores separados por vírgula) ocorre quando um perfil de user existente não tem user_id definido, mas o CSV importado inclui tanto um email quanto um user_id. Como o Intercom identifica contatos na ordem — ID Intercom, depois user_id, depois email — ele não usará o email para correspondência se um user_id estiver presente na importação. Em vez disso, cria um novo contato, resultando em duplicata. Ao importar dados via CSV, certifique-se de que o email do Lead corresponda ao email do User. O Intercom fundirá automaticamente o novo Lead no perfil de User existente. Se o Lead já existir, a fusão manual é necessária.
Para evitar perfis de user duplicados durante importações CSV, certifique-se de que os valores de user_id sejam consistentes e definidos para todos os users antes de executar a importação CSV. Use a API para atualizar o user_id de qualquer user existente que esteja sem um.
Principais estratégias para evitar duplicatas
Ative a "Fusão de Leads não verificados em Users" para consolidar Leads históricos em Users durante sessões identificadas.
Para canais baseados em telefone, ative a correspondência por telefone para fundir contatos com base no atributo Phone.
Use um único e estável
user_iddo seu sistema como identificador principal, combinado com um email.Garanta que todas as integrações (por exemplo, Messenger, API, importações CSV) usem os mesmos identificadores.
Por exemplo, se você tem dois users, ambos com o endereço de email test@example.com, mas com user_IDs diferentes, o Intercom reconhecerá esses clientes como dois users únicos.
Para ver quais users têm um user_id definido, vá para Contacts > People > All users e aplique o filtro User ID has any value. A visualização filtrada mostra o user_id de cada user, como no exemplo abaixo:
Ao fundir um Lead em um User, quaisquer dados associados ao Lead são atribuídos ao User, e o perfil do Lead é excluído.
Passos para fundir um Lead em um User
Identifique o perfil de User que você deseja manter.
Converta o Lead no perfil de User usando o endpoint da API "merge a lead and a user" ou manualmente via Inbox.
Se existirem duplicatas, fusione os Leads adicionais no perfil de User.
Uma vez fundido, o perfil do Lead é excluído permanentemente. O perfil do User mantém todo o histórico de conversas e dados anteriormente associados ao Lead.
Como identificar duplicatas
Você pode limpar os users que não deseja manter arquivando-os. Mas primeiro, você precisa descobrir qual dos dois registros deseja manter. Existem duas maneiras de fazer isso:
1. Usando nossa Rest API
Você vai querer criar um script que:
Liste Users
Encontre as duplicatas
Para a duplicata que deseja remover, faça uma solicitação para arquivá-la
2. Usando nossa Exportação CSV
A outra opção é exportar seus contatos como CSV. Depois de exportar, use uma fórmula de planilha como COUNTIF no Google Sheets ou Excel para identificar linhas com endereços de email duplicados. Alternativamente, use um complemento de deduplicação do Google Workspace Marketplace.
Depois de identificar os perfis de user duplicados que deseja remover, marque-os usando uma importação CSV e depois arquive-os na página Contacts com base nessa marcação.
Users arquivados ficam ocultos da sua lista de Contacts, mas não são excluídos permanentemente. Você pode desarquivá-los a qualquer momento em Contacts > People > All users removendo o filtro de arquivados.
Melhores práticas e recomendações
Para reduzir perfis de user duplicados no seu workspace Intercom ao longo do tempo, siga estas melhores práticas:
Padronize identificadores: Use valores consistentes de
user_ide email em todas as fontes de dados.Pré-carregue dados: Certifique-se de que os contatos importados incluam atributos como Phone em formato internacional para correspondência precisa.
Monitore e limpe regularmente: Exporte dados periodicamente para identificar duplicatas e limpar perfis.
Adote um sistema fonte de verdade: Use um sistema centralizado para emitir identificadores únicos e garantir que todas as fontes de dados estejam alinhadas.
Como mover uma conversa para o perfil de user correto?
Se uma conversa no seu inbox Intercom estiver associada ao perfil de user errado (duplicado), você pode reatribuí-la manualmente:
Adicione o user correto como participante na conversa.
Remova o perfil de user incorreto da conversa.
Leia toda a thread e descubra como limpar duplicatas, aqui na Comunidade Intercom.
Quando alguém visita seu site sem estar logado, o Intercom o rastreia como visitante anônimo usando um ID gerado pelo navegador. Se esse visitante enviar um formulário de lead ou iniciar uma conversa, o Intercom o promove a um contato Lead usando esse ID do navegador como identificador.
Como esse ID está vinculado a um navegador e sessão específicos, a mesma pessoa visitando de um dispositivo ou navegador diferente aparecerá como um novo contato — não há como o Intercom saber que é a mesma pessoa sem uma identidade verificada.
A solução recomendada é a Verificação de Identidade usando JWT (JSON Web Token). Quando ativada, seu backend envia ao Intercom um token criptograficamente assinado contendo o ID real do seu user. O Intercom trata isso como o identificador oficial, então a mesma pessoa é sempre reconhecida como o mesmo contato, independentemente do dispositivo ou navegador.
Saiba como proteger os dados que você envia via Messenger com JWT.