Passar para o conteúdo principal

Perguntas Frequentes sobre Contatos

Escrito por Matthew Pelyhes

Gerenciando dados de contato

Como faço para buscar um contato usando atributos?

Você pode encontrar um contato na interface do Intercom filtrando por qualquer um de seus atributos — incluindo número de telefone, endereço de e-mail ou user ID.

  1. Vá para Contacts.

  2. Clique em + Adicionar filtro.

  3. Selecione o atributo pelo qual deseja buscar (por exemplo, Phone, Email ou User ID).

  4. Defina a condição para É ou Contém.

  5. Digite o valor e pressione Enter.

O registro de contato correspondente aparecerá na lista.

Como o Intercom coleta e permite o acesso aos dados de usuários e visitantes?

O Intercom coleta dados de forma diferente para usuários logados e visitantes ou leads deslogados, dependendo de como está instalado no seu site.

  • Para usuários logados, você os identifica passando dados específicos no snippet JavaScript do Intercom — normalmente um user_id e/ou endereço de e-mail. Isso permite que o Intercom associe atividade e atributos a um usuário conhecido.

  • Para visitantes que não fizeram login ou não compartilharam informações de identificação (como um e-mail), o Intercom ainda coleta certos dados por padrão. Isso inclui:

    • Datas de primeiro e último acesso

    • Data do último contato (seu ou de um colega)

    • Número de sessões na web

    • Idioma e versão do navegador

    • Configuração de idioma preferido

    • URLs visitadas

    • Cidade e país

    • Sistema operacional

Esses dados do visitante estão vinculados a um cookie intercom-id ou intercom-session até que o visitante seja identificado ou convertido em um usuário.

Você pode acessar dados de usuários e visitantes através do seu workspace Intercom (nas páginas de perfil de lead/usuário em Contacts) ou programaticamente via Intercom API, que permite buscar, atualizar, converter ou excluir esses dados.

O Intercom não busca automaticamente usuários de um site. O site deve chamar explicitamente Intercom('boot') na API JavaScript para registrar e rastrear usuários no Intercom. Sem essa chamada, os usuários não aparecerão no sistema.

Como os dados de qualificação do meu lead são atualizados?

Existem três maneiras de atualizar os dados de qualificação do seu lead no Intercom. Você pode:

O que acontece quando múltiplos pontos de dados competem?

Dados editados manualmente são a fonte principal de dados

Dados editados manualmente nunca são sobrescritos por dados coletados por ping ou bot.

Para limpar os dados de qualificação que você adicionou manualmente, basta passar o mouse sobre esses dados e selecionar a opção de re-sincronização. Isso permitirá que você comece a coletar dados automaticamente novamente.

Nota: Se você fizer uma importação CSV ou atualizar um usuário via REST API, isso substituirá os dados editados manualmente.

Dados de ping são a fonte secundária de dados

Dados de ping nunca são sobrescritos por dados coletados por bot.

Dados de bot são considerados terciários

Dados coletados por bot só são adicionados ao perfil do lead quando o atributo de dados está vazio.

O que é dado de qualificação?

Dado de qualificação é um conjunto especial de atributos que você pode atualizar nos perfis de qualificação de leads e usuários conforme os qualifica.

Você pode escolher quais dados aparecem nos perfis de qualificação de leads e usuários. Basta visitar suas configurações de qualificação no Intercom e selecionar ‘Adicionar dados’:

Existem 2 maneiras de adicionar dados daqui. Você pode:

Você também pode ‘Adicionar’ ou ‘Remover’ quaisquer dados que desejar, e isso mudará os dados de qualificação que aparecem nos perfis de leads e usuários.

Como qualifico meus clientes com dados de qualificação?

Existem algumas maneiras de qualificar seus clientes no Intercom:

Dica:

Como edito o endereço de e-mail de um usuário ou lead?

Atualizar o endereço de e-mail de um usuário/lead depende de como você escolheu identificar contatos no Intercom:

  • Se você usa User IDs como identificadores únicos, você pode alterar o endereço de e-mail indo até seus Contatos e abrindo o perfil do usuário/lead, depois editando o endereço de e-mail na seção "Qualification".

  • Se você não usa User IDs, o endereço de e-mail funciona como identificador único e não pode ser alterado. Nesse caso, recomendamos arquivar o usuário/lead existente e criar um novo com o endereço de e-mail correto.

Como posso excluir permanentemente usuários e leads?

Via a interface do usuário

Se você quiser remover permanentemente todos os dados associados a um usuário/lead para que não possam ser recuperados, pode fazer isso através da aba ‘Delete data’ nas suas configurações.

Digite o ID do usuário ou e-mail do usuário que deseja excluir, depois selecione o usuário. Ao clicar em ‘Permanently delete’, todos os dados associados serão removidos. Configurações > Dados > Pessoas > Delete Data é o caminho para chegar aqui.

Via REST API

Para excluir o usuário via REST API você precisará de:

  1. Token bearer da REST API e

  2. User ID do Intercom do usuário que você deseja excluir permanentemente

Se você estiver excluindo um único usuário, pode usar nossa documentação do endpoint Delete contact. Nessa página, você precisará inserir seu token Bearer e o User ID do Intercom nos campos respectivos:

Importante:

  • Uma vez que um usuário/lead é excluído, você não pode visualizá-lo na interface do Intercom.
    Se você excluir um usuário/lead por engano, entre em contato conosco em até 7 dias e podemos recuperar as informações. Após 7 dias, esses dados serão destruídos permanentemente.

  • Avaliações CSAT e comentários de um usuário não serão excluídos.

  • Quando um usuário ou lead é excluído, todas as suas conversas — incluindo tickets — são excluídas do workspace. Se o usuário for restaurado, suas conversas e tickets também serão restaurados. Conversas históricas de contatos arquivados ou excluídos ainda serão incluídas em seus relatórios.

  • Se você exportou dados de usuários, talvez também precise excluir esses arquivos para cumprir a legislação GDPR.

Existe uma forma de ajustar o Messenger web para verificar e atualizar um perfil existente em vez de criar um novo?

Você pode ajustar como os perfis de usuários são criados ou atualizados no Intercom garantindo que você está passando identificadores de usuário consistentes. O Intercom usa o user_id como identificador principal quando fornecido, e se estiver ausente, usa o endereço de e-mail.

Se um novo user_id for passado — mesmo com o mesmo e-mail — um novo usuário será criado. Para atualizar um usuário existente em vez de criar um novo, certifique-se de:

  1. Sempre passar o mesmo user_id para usuários que retornam.

  2. Se você estiver usando o web messenger com código personalizado, certifique-se de que a lógica do seu app atribua corretamente o user_id e/ou e-mail ao inicializar o Intercom (via JavaScript API ou REST API).

  3. Evite usar diferentes user_ids para o mesmo e-mail, pois isso gera perfis duplicados que não podem ser mesclados.

Se você estiver vendo duplicatas, você pode:

  • Limpar manualmente ou via API.

  • Audite sua implementação da API para garantir que identificadores consistentes estão sendo enviados.

Para mais ajuda, por favor nos forneça um exemplo de usuário ou trecho da sua implementação atual.

Como remover uma tag de um usuário?

Isso é algo que você pode fazer na página de perfil do usuário em Contatos. No lado esquerdo da página de perfil do usuário, você verá o menu de dados do usuário com "User tags." Você pode remover a tag passando o mouse sobre ela e clicando no ícone [X].

Como adicionar notas de usuário?

Notas de usuário podem ser adicionadas tanto no perfil do usuário quanto na seção de detalhes na Inbox.

Importante: Qualquer colega que possa criar notas de usuário também pode excluí-las, e atualmente não há como restringir isso. A permissão "Can delete replies and notes from a conversation" não controla a capacidade de excluir notas de usuário em perfis de contato.

Posso criar novos usuários com o mesmo user ID e/ou e-mail de um usuário excluído?

Isso só é possível após o período de carência de 7 dias, porque os usuários excluídos ainda existem no banco de dados com esses user IDs/e-mails. Se você precisar urgentemente criar novos usuários com o mesmo user ID/e-mail daqueles que foram excluídos no período de carência de 7 dias, você pode:

  1. Use nossa REST API para atualizar o user ID (externnal_id)/e-mail, por exemplo User ID = 123 -> User ID = 123_delete

  2. Então exclua o(s) usuário(s) novamente.

  3. Agora crie o(s) usuário(s) com o user ID/e-mail desejado, por exemplo User ID = 123.

Posso criar um link direto para o perfil de um usuário?

Você pode criar links para perfis de usuários simplesmente adicionando o User ID ou endereço de e-mail do seu usuário às URLs abaixo.

User ID:

https://app.intercom.com/apps/YOUR_APP_ID/users/show?user_id=THE_USER_ID

O User ID aqui é o ID que você definiu para o usuário. Se você não usa User IDs, precisará de uma URL um pouco diferente onde pode usar o Intercom ID que todos os Users possuem:

https://app.intercom.com/apps/YOUR_APP-ID/users/show?id=INTERCOM_ID


O Intercom ID de um User pode ser encontrado na URL ao visualizar a página de perfil dele no Intercom:

Endereço de e-mail:

https://app.intercom.com/apps/YOUR_APP_ID/users/show?email=THE_USER_EMAIL

Essa URL funcionará apenas para endereços de e-mail únicos - são endereços que existem uma única vez na sua lista de usuários.

Workspaces Regionais

Se você tem um workspace regional nas regiões da UE ou AU, certifique-se de adaptar suas URLs para isso.

Você pode identificar em qual região de dados você está hospedado olhando a URL do seu workspace:

  • app.intercom.com para clientes dos EUA

  • app.eu.intercom.com para clientes da UE

  • app.au.intercom.com para clientes australianos

Por que estou perdendo users que aparecem no meu próprio sistema?

Seus users podem ter instalado um plugin/extensão de navegador que bloqueia JavaScript e usa a EasyList ou lista similar. Isso é especialmente provável se o número de users ausentes no Intercom for pequeno e ocorrer raramente.

Por que uma extensão ou plugin de bloqueio de anúncios bloquearia o Intercom?

Embora o Intercom não seja um provedor de anúncios, plugins de bloqueio de anúncios (ex.: uBlock, Ghostery, Adblock, NoScript e modo de navegação privativa do Firefox) oferecem opções para bloquear JavaScript que inclui funcionalidades de rastreamento.

Como o Intercom comunica detalhes da conversa e oferece a capacidade de enviar atributos e eventos sobre o comportamento dos seus Users, estamos incluídos em algumas dessas listas secundárias. Embora existam muitas listas, a maioria dos bloqueios do Intercom é causada pela nossa inclusão na lista EasyList.

O que é EasyList?

EasyList é uma assinatura suplementar opcional que remove completamente todas as formas de rastreamento da internet, incluindo web bugs, scripts de rastreamento e coletores de informações, protegendo assim seus dados pessoais data.

No Intercom, respeitamos a privacidade do cliente quando solicitada, então não contestamos nossa inclusão aqui, mas você certamente pode pedir que seus users desativem plugins como este ou adicionem uma exceção para seu site para melhor desempenho.

Como posso manter os dados no Intercom sincronizados com meu sistema para esses users?

  1. Você pode pedir para seus users desativarem bloqueadores de JavaScript. Pesquisar por detecção de bloqueador de JavaScript ou detecção de Adblock fornecerá muitos recursos para isso.

  2. Você pode sincronizar seu backend com a Intercom API. Existem vários wrappers de API que podem se adequar bem à sua aplicação, incluindo: Ruby, Node, PHP, Java, Go

Se você acredita que está perdendo detalhes de user no Intercom por outros motivos, sinta-se à vontade para entrar em contato para investigar possíveis problemas de integração.

Posso adicionar uma foto de perfil ou imagem de avatar para um lead ou user?

Você pode definir a imagem de avatar de um contato no Intercom usando a REST API seguindo estes passos:​

1. Recupere o ID do contato no Intercom fazendo uma chamada para o endpoint Search for Contacts

2. Use o ID do Intercom para fazer uma chamada para o endpoint Update Contact e preencha o objeto avatar com a URL da imagem do contato que deseja usar.

Posso adicionar atributos personalizados para colegas de equipe no meu workspace?

Não. Embora existam atributos como 'location' ou 'name' no perfil de um colega de equipe, você não pode criar um novo atributo personalizado para eles como pode para seus end-users.


Entendendo os dados de contato

O Intercom está em conformidade com a HIPAA?

O que é HIPAA?

A Health Insurance Portability and Accountability Act (HIPAA) é um conjunto de padrões do setor para proteger informações de saúde protegidas (PHI) e informações eletrônicas de saúde protegidas (ePHI).

Os clientes devem poder confiar que seus dados de saúde estão sendo tratados com segurança e sua privacidade digital respeitada. A HIPAA é um dos padrões que eles usam para orientação e consistência.

O Intercom está em conformidade?

O Intercom concluiu com sucesso um exame de atestação HIPAA, o que significa que agora ajudamos nossos clientes a cumprir suas obrigações de ePHI, pois armazenamos e processamos dados de forma consistente com os padrões HIPAA.

Se sua empresa precisa estar em conformidade com a HIPAA, podemos firmar um acordo de associado comercial com sua organização. Isso requer a assinatura do plano Expert do Intercom, pois os recursos de conformidade HIPAA, incluindo o BAA, estão disponíveis apenas nesse nível. Sem um BAA assinado, transmitir ePHI pelo Intercom é estritamente proibido conforme os termos de serviço do Intercom.

Temos um relatório de atestação HIPAA que cobre tanto a Regra de Segurança HIPAA quanto a Regra de Notificação de Violação HITECH que podemos compartilhar com você. É confidencial, então se você ainda não é usuário do Intercom, será necessário assinar um NDA (Acordo de Confidencialidade) antes de recebê-lo.

E agora?

Para acessar nosso relatório de atestação HIPAA, administradores atuais do Intercom podem fazer login no workspace Intercom para baixar e visualizar o relatório, junto com outros documentos de segurança e conformidade. Eles podem ser encontrados em Configurações de segurança.

Este relatório também está disponível mediante solicitação e sob NDA para quem não tem acesso a um workspace Intercom. Entre em contato pelo Messenger ou enviando um e-mail para security@intercom.com.

Para firmar um BAA (acordo de associado comercial) com o Intercom, você pode entrar em contato com nossa equipe de suporte pelo Messenger ou enviar um e-mail para team@intercom.io. Se você faz parte dos programas Startup ou Early Stage do Intercom, atualizar para o plano Expert encerrará seus benefícios especiais do programa, que não poderão ser restabelecidos depois.

Como é definida uma sessão web?

Incrementamos a contagem de sessões de um user quando uma das seguintes situações ocorre:

1. O user não enviou um ping para o Intercom por mais de 30 minutos e depois retorna.

2. O user esteve ativo (enviando um ping para o Intercom a cada 30 minutos ou menos) por mais de 24 horas.

3. O papel do user muda (ex.: visitante se torna um lead, ou lead se torna um user).

4. É o primeiro ping do user.

Visitas (para visitantes e leads) são incrementadas da mesma forma que sessões web.

Como é definida uma sessão móvel?

Se você está usando nosso iOS SDK, incrementamos a contagem de sessões iOS na primeira vez que um user é registrado e subsequentemente em cada UIApplicationDidBecomeActiveNotification que é acionado quando um user abre seu app, desde que ocorram com intervalo de vinte segundos. Aberturas de app dentro de vinte segundos não são contadas.

Nosso SDK Android está disponível aqui e possui regras similares.

Sessões web móveis (ou seja, Safari e Chrome no móvel) são capturadas como sessões web, não como sessões móveis.

Como são definidas as sessões de empresa?

Incrementamos a contagem de sessões de uma empresa sempre que um user inicia uma nova sessão no contexto dessa empresa. Por exemplo, se um user faz login após 1 dia apenas com dados de user, isso atualizará a sessão do user.

Então, dentro de 30 minutos, ele envia outro ping com dados de user e empresa. Isso não incrementará as sessões do user, então também não incrementará as sessões da empresa.

Então, se durante o período em que faz parte de uma empresa um determinado usuário tiver 300 sessões e depois esse usuário sair dessa empresa, essas 300 sessões ainda farão parte do total de sessões da empresa, mesmo após a saída.

Importante:

  • Se um usuário estiver associado a várias empresas, não sabemos quais sessões da empresa atualizar, a menos que tenhamos um company_id. Portanto, para que as sessões da empresa sejam atualizadas, a atualização do usuário deve conter o objeto company.

  • Os dados da company devem ser enviados como parte do ping do usuário para que a sessão web da company aumente.

  • O valor “company last seen” só é atualizado quando há uma requisição ping com o usuário. Se seu usuário fizer login apenas com dados do usuário, apenas o "last seen" do usuário será atualizado, e não o "company last seen".

Como o Intercom rastreia o primeiro e o último nome dos meus users?

O Intercom dividirá automaticamente seu atributo de nome em primeiro nome e último nome. Por exemplo:

  • Se o nome for "Joe Bloggs", o Intercom rastreia como Primeiro nome: "Joe", Último nome: "Bloggs".

  • Se o nome for "MÁRCIA HELENA MAIA DE LIMA", o Intercom rastreia como Primeiro nome: "MÁRCIA" Último nome: "HELENA MAIA DE LIMA"

  • Se o nome for "Dr. Drew Bloggs", o Intercom rastreia como Primeiro nome: "Drew" Último nome: "Bloggs"

  • Se o nome for "Joe Bloggs, CBA", o Intercom rastreia como Primeiro nome: "Joe" Último nome: "Bloggs" - "CBA" ainda será exibido no nome completo de Joe no Intercom.

  • Se o nome for "Bloggs, Joe", o Intercom rastreia como Primeiro nome: "Joe" Último nome: "Bloggs"

  • Se o nome for "Dr Bloggs", o Intercom rastreia Primeiro nome como "não existe" Último nome "Bloggs"

  • Para definir um nome do meio, use o formato: "Último nome, Primeiro nome Nome do meio". Se o nome for "Bloggs, Joe Drew", o Intercom rastreia Primeiro nome como: "Joe Drew" Último nome: como "Bloggs"

Se um usuário não forneceu um nome, usaremos seu endereço de e-mail ou user_id para identificá-lo. Se esses campos também estiverem em branco, geraremos um pseudônimo único para ele, no formato: "Objeto Cor de Localização" como "Estéreo Rosa de Atlanta".

Como o Intercom rastreia se um usuário está online no momento?

O Intercom usa presença em tempo real para registrar se um usuário está online no seu app. A presença em tempo real funciona com base em requisições periódicas de heartbeat vindas do usuário (via Messenger).

O usuário envia esses heartbeats a cada 30 segundos e é marcado como offline quando não recebemos um heartbeat em 2 minutos. Mesmo nos níveis mais baixos, nem sempre detectamos imediatamente a perda de conexão assim que o usuário fecha o navegador - ainda é necessário a ausência de algum tipo de tráfego de heartbeat após um intervalo de timeout para declarar que a conexão caiu. Usuários navegando de página em página piscariam online e offline constantemente se pudéssemos detectar conexões caindo de forma confiável e não suavizássemos um pouco.

Como a lista de users é atualizada em tempo real?

A presença em tempo real dos users atualizará o ponto verde mostrado ao lado da foto do perfil de um user ou lead:

Quando sua lista de users é atualizada automaticamente, ela não traz novas pessoas, apenas atualiza o status online (o ponto verde) de quem já está lá. Você precisará atualizar manualmente para trazer novos users ou atualizar outros valores.

Como criar filtros para datas no futuro?

Se você quiser criar filtros para datas no futuro, precisa usar números negativos.

Por exemplo, se quiser enviar uma mensagem automática para clientes 3 dias antes do fim da assinatura, você criaria um atributo personalizado "subscription_ends_at" e filtraria por "mais de -3 dias atrás" e "menos de 0 dias atrás." Isso corresponderá a todos os users cuja assinatura está para acabar em 3 dias.

Importante:

  • Para garantir que isso funcione, o atributo personalizado deve ser enviado para o Intercom como um Unix Timestamp e o tipo deve ser definido como 'Date'.

  • Atributos personalizados que terminam com "_at" são automaticamente tratados como data, e não como número. No entanto, se você nomeou seu atributo personalizado de forma diferente, pode alterar o tipo para 'Date' manualmente nas configurações do seu app em 'People Attributes'.

  • Se você estiver usando o filtro 'exatamente x dias atrás', encontraremos users que correspondem a esse filtro durante um período de 24 horas. Por exemplo, 'signed_up_at exatamente -3 dias' encontrará users cuja data de signed_up_at é de 2-3 dias a partir de agora (e não 3-4 dias a partir de agora).

Posso filtrar users em dispositivos iPad no Intercom?

Não, não é possível filtrar especificamente users em dispositivos iPad dentro do Intercom. Isso porque a Apple usa o mesmo identificador de OS para dispositivos desktop (Mac) e iPad, então o Intercom não consegue distinguir entre os dois tipos de dispositivo. Essa limitação é consistente em todos os filtros do Intercom, incluindo: Contacts, Messages, Workflows, Reports, etc.

Quais atributos personalizados padrão estão disponíveis no meu workspace?

A lista de atributos personalizados padrão é:

  • Nome

  • Conta

  • Nome da conta

  • Proprietário

  • Nome do proprietário

  • Categoria do lead

  • Avaliação da conversa

  • E-mail

  • Email domain

  • Telefone

  • User ID

  • Primeira vez visto

  • Inscrito

  • Última vez visto

  • Último contato

  • Última resposta

  • Último e-mail aberto

  • Último clique em link no e-mail

  • Sessões web

  • País

  • Região

  • Cidade

  • Fuso horário

  • Código do continente

  • Código do país

  • Idioma do navegador

  • Substituição de idioma

  • Navegador

  • Sessões do navegador

  • SO (sistema operacional)

  • Etiqueta da pessoa

  • Cancelou a inscrição do email

  • Marcou o email como spam

  • Teve hard bounce

  • Campanha UTM

  • Conteúdo UTM

  • Meio UTM

  • Fonte UTM

  • Termo UTM

  • URL de referência

  • Tipos de opt-in de assinatura

  • Última pesquisa recebida

  • Número do Whatsapp

  • Empresas

  • País do número de telefone


Solução de problemas

O que posso fazer se receber uma mensagem de erro "user already exists"?

Se você recebeu uma mensagem de erro "user already exists" devido a um contato existente com o mesmo endereço de email ou User ID/external_id, você pode localizar o contato existente usando o ID do Intercom retornado na mensagem de erro e fazendo uma chamada GET para o endpoint da API Get a contact para retornar o perfil do usuário existente.

Por exemplo, se a mensagem de erro contiver "message': 'A contact matching those details already exists with id=65a92b7ee1a4176d9ab8b357", você pode fazer uma requisição Get a contact para https://api.intercom.io/contacts/65a92b7ee1a4176d9ab8b357.

Por que meus users aparecem no Messenger sem nomes e dizendo que não correspondem mais aos filtros?

Esse comportamento ocorre ao iniciar users não identificados no mobile. Parece que nem um endereço de email nem um user ID estão sendo passados ao iniciar o Messenger para esses users no mobile, o que os torna users não identificados sem dados salvos. Para corrigir, verifique sua instalação do SDK para garantir que email/user_id está sendo passado quando os users fazem login no seu app. Você pode revisar estes docs para mais informações sobre identificação de users no mobile: iOS e Android.


"A Pessoa tem um Endereço de Email da Empresa e Não Pode ser Editada"
Instruções para resolver:

1. Remova o endereço de email do user da lista "Endereços de empresa a ignorar em conversas em grupo" nas suas configurações de Encaminhamento de Email settings.

2. Após remover o endereço de email da lista, você deverá conseguir editar o nome do user.

3. Depois de fazer as alterações necessárias, você pode adicionar o endereço de email de volta à lista, se necessário.

Respondeu à sua pergunta?