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 cadastro 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 Abrir ferramenta de importação CSV.
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 qualquer 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 cadastro dos seus users. Clique em ‘Selecionar esta coluna’ para cada uma e depois em ‘Confirmar’.

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 tanto email quanto 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 de qualquer user existente que esteja 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 ‘Confirmar’ 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 você 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 uma 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 com 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 tanto user_id quanto email no Intercom, enviar email em uma importação CSV é suficiente para corresponder ao registro do user no Intercom.

Importar 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 contatos, 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.

Como baixar um relatório de erros para uma importação CSV

Quando uma importação CSV de contatos tem linhas com falhas, você pode baixar um relatório de erros: um arquivo CSV listando todos os erros da importação, para que você possa corrigir todas as linhas com falhas de uma vez e reimportar.

Vá para Configurações > Dados > Importações & exportações e abra Importações CSV.
Encontre sua importação na lista. Um spinner aparece na coluna do relatório de erros enquanto o relatório está sendo preparado.
Clique em Baixar relatório de erros para baixar o arquivo CSV.

O relatório de erros da importação CSV inclui o seguinte para cada erro:

Número da linha da planilha, que corresponde à linha no seu próprio arquivo. Os números das linhas contam a linha do cabeçalho e quaisquer linhas em branco, então a linha 7 no relatório é a linha 7 na sua planilha.
User ID e Email do contato naquela linha.
Coluna que causou o erro.
Tipo de erro, em linguagem simples, como "Email inválido", "Email ausente", "Tipo de dado incompatível", "Tamanho máximo excedido" ou "Múltiplos registros correspondentes".

Cada erro é listado, então uma linha com 2 erros aparece duas vezes no relatório de erros.

Nota: Apenas o colega que executou a importação CSV pode baixar seu relatório de erros, e o relatório é mantido por 30 dias. O relatório de erros não aparece na página de exportações CSV, e nenhum email é enviado quando estiver pronto. Importações feitas antes do lançamento do relatório de erros ainda mostram o resumo da importação anterior.

O que significa o erro "Múltiplos registros correspondentes"?

O erro "múltiplos registros correspondentes" geralmente ocorre quando há vários 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ê precisará 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 email for fornecido durante importações, o Intercom tenta corresponder pelo campo fornecido. Porém, discrepâncias podem ocorrer quando ambos os campos estão inconsistentes ou atribuídos de forma diferente.
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 muda.

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 pelo email.
  - Se apenas um user ID for fornecido, o sistema corresponde pelo user ID.
  - Quando ambos forem fornecidos, o user ID tem precedência; se não houver correspondência pelo 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 identificadores corretos de user_id e email.
- Desligue o SDK (Intercom('shutdown')) antes dos logouts para evitar duplicação.
Verifique as configurações de conversão de Leads:
- Use user IDs consistentes durante os logins para converter leads ativos em users sem duplicação. Consulte nosso guia de autenticação de users para mais detalhes.
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 campos external_id de forma eficaz sem causar duplicação.

Importe seus dados de usuários para o Intercom