Se você é um cliente atual do Intercom, pode importar seus users das seguintes fontes:

Nota:

Se você só precisa adicionar alguns users de cada vez, como pessoas que conheceu em um evento, pode criá-los diretamente da lista de pessoas.
Não é possível importar atributos de empresa ou dados de empresa para o Intercom via importação CSV.

Todos os métodos permitem importar nome de usuário, email, userID e data de inscrição no formato DD/MM/AAAA, ISO 8601 ou um timestamp Unix. Note que se usar DD/MM/AAAA não pode enviar o horário.

Importações CSV também permitem criar atributos personalizados para users (inclua uma coluna para cada).
Mixpanel inclui last_seen.
MailChimp importa o IP do user.

Comece agora

Primeiro, faça login na sua conta Intercom e clique em 'New users or leads' na lista de pessoas.

Então, selecione 'Import people':

Em seguida, escolha o método que deseja usar para importar users e siga os passos da importação.

Você também pode acessar todas essas opções em Configurações > Dados > Importações & exportações:

Se você importar users para o Intercom e eles corresponderem imediatamente aos critérios de uma mensagem ativa, receberão essa mensagem na hora.

Como importar users de um CSV

Passo a passo:

Se você selecionou a opção de importação CSV, basta seguir os passos abaixo para importar seus users:

Complete os passos 1 e 2 descritos acima na seção 'Import users any time'. Certifique-se de clicar em Open CSV Import tool.
Selecione Import users para importar uma lista de users logados ou clientes do seu produto. Ou escolha ‘Import leads’ para importar uma lista de leads para seu workspace Intercom.
Arraste e solte seu arquivo CSV e clique em Upload. O limite máximo de tamanho do arquivo é 20 mb. Divida o arquivo se for maior que isso.

Requisitos importantes do formato CSV:

A coluna de user ID deve estar formatada como user_id (minúsculo com underline)
Você pode identificar users usando um dos seguintes:
- user_id (recomendado)
- Coluna de email
Se ambos estiverem presentes, user_id tem prioridade
user_id é obrigatório se nenhum email for fornecido
Uso inconsistente de user ID e email como identificadores pode levar à criação de users duplicados. Para melhores resultados:
- Garanta que cada registro inclua tanto user ID quanto email sempre que possível.
- Lembre-se que o user ID tem prioridade se ambos forem fornecidos, o que ajuda a evitar contas duplicadas.

Melhor prática: Inclua as colunas user_id e Email no seu arquivo CSV para melhor gerenciamento dos users.

4. O Intercom agora solicitará que você selecione as colunas relevantes que contêm os emails, IDs, nomes completos e datas de inscrição dos seus users. Clique em ‘Select this column’ para cada uma e depois em ‘Confirm’.

Todos os users ou leads no seu CSV devem ter um endereço de email. Entradas duplicadas podem ocorrer quando leads e users com o mesmo email são tratados como entidades separadas. Para evitar isso, garanta a sincronização dos dados de user e lead durante as importações.

Importar um CSV com email e user_id pode criar duplicatas se o perfil existente não tiver user_id.

Os contatos são identificados na seguinte ordem: Intercom ID → user_id → email. Se um perfil de user não tiver user_id definido, e seu CSV incluir email e user_id, o Intercom não fará a correspondência pelo email, tratará o user_id como um novo identificador e criará um contato duplicado. Para evitar isso, garanta que os valores de user_id sejam consistentes e definidos para todos os users antes da importação. Use a API para atualizar user_id dos users existentes que estiverem sem antes da importação CSV.

5. Se você adicionou colunas adicionais, o Intercom solicitará que você dê um nome específico para seus atributos personalizados. Clique em ‘Confirm’ depois de nomear seu atributo personalizado.

6. Marque sua lista CSV com um termo memorável, como ‘New Sign-Ups 2015’

7. Depois de importado, você pode buscar na lista de Users do Intercom por ‘tag: New Sign-Ups 2015.’ Agora você está pronto para fazer coisas como enviar uma mensagem única para todos da lista ou criar um segmento para esse grupo e enviar uma mensagem Proativa direcionada.

Você precisará adicionar o código do país no início dos seus números de telefone. Por exemplo, para números dos EUA, adicione ‘+1’ ou ‘001’.

Nota: Se estiver importando contatos para usar com mensagens WhatsApp, apenas o número de telefone não é suficiente. Cada linha do seu CSV deve incluir um identificador de contato — seja um endereço de email ou um user_id. Importar um CSV com apenas números de telefone não funcionará para mensagens WhatsApp de saída.

Nota: As tags podem levar alguns minutos para serem aplicadas completamente após a conclusão da importação. Por favor, aguarde um pouco para que todas as tags sejam aplicadas aos users importados.

Posso atualizar dados de user com importação CSV?

Sim. Você pode atualizar valores e adicionar novos atributos para users existentes. Todas as importações CSV exigem uma coluna com endereços de email dos users. Algumas observações:

Você pode atualizar o email de um user enviando o mesmo user_id e um endereço de email diferente. Atualizaremos o user com esse user_id no Intercom para refletir o novo email.
Você não pode atualizar o user_id definindo um novo valor para ele e usando o email existente - isso criaria um novo registro.
Se você usar user_id e email no Intercom, enviar email em uma importação CSV é suficiente para corresponder ao registro do user no Intercom.

Importe users via Rest API

É possível importar users, junto com atributos personalizados, via REST API. Depois de importar users, você também pode adicionar dados históricos de eventos para seus users via Events API.

Confira este tutorial que explica como importar dados de contato de users e leads de um arquivo JSON usando as APIs do Intercom.

Veja seu Histórico de Importação de Dados

Você pode ver seu histórico de importação de dados na seção de configurações do Intercom.

O que significa o erro "Multiple records match"?

O erro "multiple records matched" geralmente ocorre quando há múltiplos users no seu sistema com o mesmo endereço de email. Isso cria um conflito porque o sistema não consegue determinar qual user atualizar. Para resolver isso, você precisa garantir que cada user tenha um endereço de email ou user ID único.

Você pode preencher identificadores corretos usando a API do Intercom atualizando sistematicamente os campos external_id para mesclar duplicatas e esclarecer correspondências.

Entendendo as causas de users duplicados

Perfis duplicados de users no Intercom podem surgir por vários motivos. A hierarquia de identificadores no Intercom (Intercom ID > User ID > Email) tem papel importante. Quando user_id único e estável não é fornecido, duplicatas podem ocorrer. Por exemplo, enviar valores diferentes de user_id para o mesmo email ou iniciar users sem user_id leva à duplicação. Transições de sessões anônimas para logadas, sobreposição de endereços de email e mudanças nos identificadores de user agravam a situação. Problemas específicos da plataforma, como integrações WhatsApp onde perfis são gerados usando apenas números de telefone, também contribuem para o problema.

Identificadores de User Inconsistentes:
- Se email e user ID forem usados de forma inconsistente, duplicatas podem ocorrer. Email serve como identificador único apenas se user ID não for fornecido. Portanto, dois users podem compartilhar o mesmo email se tiverem user IDs diferentes. Isso pode acontecer após atualizações no backend ou mudanças na geração de user ID.
Comportamentos de Integração:
- Integrações de apps como Shopify podem criar users onde não há correspondência exata, usando o ID de email como identificador único em vez de reconciliar user IDs.
Lógica de Correspondência Durante Uploads:
- Se apenas user ID ou endereço de email for fornecido durante importações, o Intercom tenta corresponder ao campo fornecido. No entanto, discrepâncias podem ocorrer quando ambos os campos são incompatíveis ou atribuídos de forma inconsistente.
Sobreposição de Users e Leads:
- Leads e users são tratados como objetos diferentes, mesmo quando compartilham o mesmo endereço de email, o que pode levar a duplicatas.

Inicialização incorreta do SDK ou transição de estado anônimo para logado sem atualizações adequadas frequentemente leva à duplicação. Por exemplo, atribuir um user_id aleatório para navegação anônima pode criar novos perfis quando a sessão transita.

Prevenção de users duplicados

Padronize Identificadores de User:
- Garanta que sua configuração atribua consistentemente valores de user ID e email. Por exemplo:
  - Se apenas um email for fornecido, o sistema corresponde com base no email.
  - Se apenas um user ID for fornecido, o sistema corresponde com base no user ID.
  - Quando ambos são fornecidos, user ID tem precedência; se não houver correspondência por user ID, o sistema corresponde pelo email.
Inicialização adequada do SDK:
- Para users anônimos, inicialize o SDK apenas com o app_id.
- Após login, atualize os perfis com os identificadores corretos de user_id e email.
- Desligue o SDK (Intercom('shutdown')) antes do logout do user para evitar duplicação.
Verifique as Configurações de Conversão de Leads:
- Use IDs de user consistentes durante os logins para converter leads ativos em users sem duplicação. Consulte nosso guia de autenticação de users para mais informações.
Adapte-se aos Requisitos Específicos da Plataforma:
- Exemplo: Para WhatsApp, certifique-se de que configurações como "Identify existing users" estejam ativadas e tente capturar identificadores de email cedo para consistência.
Precauções na Migração:
- Ao migrar para novos sistemas de ID (ex: UUIDs), utilize a API do Intercom para atualizar e gerenciar os campos external_id de forma eficaz sem causar duplicação.

Importe seus dados de users para o Intercom