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 endereço de 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 de workspace ou colega com acesso a Contatos. A deduplicação baseada em API requer credenciais de API. A fusão de Leads em Users pode ser feita via API do 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 mesclar perfis sem emails, o que ajuda a unificar automaticamente os perfis de 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 levar a 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 do 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 mesclará automaticamente o novo Lead no perfil de User existente. Se o Lead já existir, a mesclagem 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 uma importação CSV. Use a API para atualizar o user_id de qualquer user existente que esteja sem ele.
Principais estratégias para evitar duplicatas
Ative "Mesclagem 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 mesclar contatos com base no atributo Telefone.
Use um único e estável
user_iddo seu sistema como identificador principal, combinado com um email.Certifique-se de 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 Contatos > Pessoas > Todos os users e aplique o filtro User ID tem qualquer valor. A visualização filtrada mostra o user_id de cada user, como no exemplo abaixo:
Atualmente não é possível mesclar dois Users no Intercom. Você pode mesclar um Lead em um User, mas não pode mesclar dois users. Ao mesclar 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 mesclar um Lead em um User
Identifique o perfil do User que você deseja manter.
Converta o Lead no perfil do User usando o endpoint da API "merge a lead and a user" ou manualmente via Inbox.
Se existirem duplicatas, mescle os Leads adicionais no perfil do User.
Uma vez mesclado, 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. 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:
Listar Users
Encontrar as duplicatas
Para a duplicata que você 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. Uma vez exportados, 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 de Contatos com base nessa marcação.
Users arquivados ficam ocultos da sua lista de Contatos, mas não são excluídos permanentemente. Você pode desarquivá-los a qualquer momento em Contatos > Pessoas > Todos os 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 Telefone em formato internacional para correspondência precisa.
Monitore e limpe regularmente: Exporte dados periodicamente para identificar duplicatas e limpar perfis.
Adote um sistema fonte da 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 errado (duplicado) de user, você pode reatribuí-la manualmente:
Adicione o user correto como participante na conversa.
Remova o perfil incorreto de user da conversa.
Leia toda a conversa e descubra como limpar duplicatas, aqui no Intercom Community.
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.