Gerenciando dados de contato
Como o Intercom coleta e permite o acesso aos dados de users e visitantes?
O Intercom coleta dados de forma diferente para users logados e visitantes ou leads deslogados, dependendo de como está instalado no seu site.
Para users logados, você os identifica passando dados específicos no snippet JavaScript do Intercom—normalmente um user_id e/ou endereço de email. Isso permite que o Intercom associe atividades e atributos a um user conhecido.
Para visitantes que não fizeram login ou não compartilharam informações de identificação (como email), o Intercom ainda coleta certos dados por padrão. Isso inclui:
Datas da primeira e última visita
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 user.
Você pode acessar dados de users e visitantes através do seu workspace Intercom (nas páginas de perfil de lead/user em Contatos) ou programaticamente via API do Intercom, que permite buscar, atualizar, converter ou excluir esses dados.
O Intercom não busca users automaticamente de um site. O site deve chamar explicitamente Intercom('boot') na API JavaScript para registrar e rastrear users no Intercom. Sem essa chamada, os users 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:
Atualizar manualmente os dados de qualificação do lead nos perfis dos seus leads.
Rastrear dados de qualificação do lead capturados no seu site ou produto, e enviá-los para o Intercom via ping (assim como você faria com seus atributos personalizados).
Configurar um Workflow para coletar e atualizar automaticamente os dados dos seus leads.
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.
Se você fizer uma importação CSV ou atualizar um user 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?
Dados de qualificação são um conjunto especial de atributos que você pode atualizar nos perfis de qualificação de leads e users conforme os qualifica.
Você pode escolher quais dados aparecem nos perfis de qualificação de leads e users. Basta visitar suas configurações de qualificação no Intercom e selecionar ‘Adicionar dados’:
Existem 2 maneiras de adicionar dados daqui. Você pode:
Escolher entre os atributos personalizados que você já adicionou ao Intercom.
Clique em ‘criar novo dado’ para criar novos dados personalizados de qualificação.
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 users.
Como qualificar meus clientes com dados de qualificação?
Existem algumas maneiras de qualificar seus clientes no Intercom:
Fin Sales Agent é a abordagem recomendada para lidar automaticamente com a qualificação e nutrição de leads inbound.
Você também pode qualificar manualmente seus leads na Inbox enquanto conversa com eles.
E/ou configurar automações para coletar detalhes de contato dos seus leads, com base nos dados mais importantes para o seu negócio.
Dica:
Também é possível atualizar dados de qualificação do lead via ping (assim como você faria com seus atributos personalizados). E, você pode atualizá-los via importação CSV ou pela REST API.
Confira nossas melhores práticas sobre como escolher os dados de qualificação certos para o seu negócio.
Como editar o endereço de email de um user ou lead?
Atualizar o endereço de email de um user/lead depende de como você escolheu identificar contatos no Intercom:
Se você usar User IDs como identificadores únicos, você pode alterar o endereço de email indo até Contatos e abrindo o perfil do user/lead, depois editando o endereço de email na seção "Qualificação".
Se você não usar User IDs, o endereço de e-mail atua 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 users e leads?
Via a interface do usuário
Se você quiser remover permanentemente todos os dados associados a um user/lead para que não possam ser recuperados, pode fazer isso através da aba ‘Delete data’ nas suas configurações.
Digite o user ID ou e-mail do user que deseja excluir, depois selecione o user. Ao clicar em ‘Permanently delete’, todos os dados associados serão removidos. Configurações > Data > People > Delete Data é o caminho para chegar aqui.
Via REST API
Para excluir o user via REST API você precisará de:
Token bearer da REST API e
User ID do Intercom do user que você deseja excluir permanentemente
Se você estiver excluindo um único user, 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 user/lead tenha sido excluído, você não poderá visualizá-los na interface do Intercom.
Se você excluir um user/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 user não serão excluídos.
Quando um user ou lead é excluído, todas as suas conversas — incluindo tickets — são excluídas do workspace. Se o user 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ê tiver exportado dados de users, talvez também precise excluir esses arquivos para cumprir a legislação GDPR.
Existe uma forma de ajustar o web Messenger para verificar e atualizar um perfil existente em vez de criar um novo?
Você pode ajustar como os perfis de user são criados ou atualizados no Intercom garantindo que você está passando identificadores 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 user será criado. Para atualizar um user existente em vez de criar um novo, certifique-se de:
Sempre passar o mesmo user_id para users que retornam.
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).
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, 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 user ou trecho da sua implementação atual.
Como remover uma tag de um user?
Isso pode ser feito na página de perfil do user em Contacts. No lado esquerdo da página de perfil do user, você verá o menu de dados do user com "User tags." Você pode remover a tag passando o mouse sobre ela e clicando no ícone [X].
Como adicionar notas de user?
Notas de user podem ser adicionadas tanto no perfil do user quanto na seção de detalhes do Inbox.
Importante: Qualquer colega que possa criar notas de user 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 user em perfis de contato.
Posso criar novos users com o mesmo user ID e/ou e-mail de um user excluído?
Isso só é possível após o período de carência de 7 dias, porque os users excluídos ainda existem no banco de dados com esses user IDs/e-mails. Se você precisar urgentemente criar novos users com o mesmo user ID/e-mail daqueles que foram excluídos no período de carência de 7 dias, você pode:
Usar nossa REST API para atualizar o user ID (
externnal_id)/e-mail, por exemploUser ID = 123->User ID = 123_deleteEntão exclua o(s) user(s) novamente.
Agora crie o(s) user(s) com o user ID/e-mail desejado, por exemplo
User ID = 123.
Posso criar um link direto para o perfil de um user?
Você pode criar links para perfis de user simplesmente adicionando o User ID ou endereço de e-mail do seu user à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 user. Se você não usar 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 para 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 users.
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.compara clientes dos EUAapp.eu.intercom.compara clientes da UEapp.au.intercom.compara 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 do Intercom for uma pequena porcentagem 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 (por exemplo, uBlock, Ghostery, Adblock, NoScript e o modo de navegação privada 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, por isso 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?
Você pode pedir aos seus users que desativem bloqueadores de JavaScript. Pesquisar por detecção de bloqueador de JavaScript ou detecção de Adblock fornecerá muitos recursos sobre como fazer isso.
Se você acredita que está faltando detalhe do 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 a 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 você deseja usar.
Você também pode preencher o objeto avatar na sua instalação do Messenger.
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 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 que 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 atestado HIPAA, o que significa que agora ajudamos nossos clientes a cumprir suas obrigações de ePHI, pois armazenamos e processamos dados de maneira 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 descrito nos termos de serviço do Intercom.
Temos um relatório de atestado 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 é um 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 atestado HIPAA, os administradores atuais do Intercom podem fazer login no workspace do 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 aqueles que não têm acesso a um workspace do Intercom atualmente. 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 posteriormente.
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 (por exemplo, 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ê estiver 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 aplicativo dentro de vinte segundos não são contabilizadas.
Nosso SDK Android está disponível aqui e possui regras semelhantes.
Sessões web móveis (ou seja, Safari e Chrome no celular) 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, portanto, também não incrementará as sessões da empresa.
Portanto, se enquanto parte de uma empresa um determinado user tem 300 sessões e depois esse user sai dessa empresa, essas 300 sessões ainda farão parte do total de sessões da empresa, mesmo depois que ele sair.
Importante:
Se um user estiver associado a várias empresas, não sabemos qual empresa atualizar as sessões, a menos que tenhamos um company_id. Portanto, para que as sessões da empresa sejam atualizadas, a atualização do user deve conter o objeto company.
Os dados da empresa devem ser enviados como parte do ping do user para que a sessão web da empresa aumente.
O valor “company last seen” só é atualizado quando há uma requisição de ping com o user. Se seu user fizer login apenas com dados de user, apenas o "last seen" do user será atualizado, e não o "company last seen".
Como o Intercom rastreia o primeiro e o último nome dos meus users?
O Intercom automaticamente divide seu atributo de nome em primeiro nome e sobrenome. Por exemplo:
Se o nome for "Joe Bloggs", o Intercom o rastreia como Primeiro nome: "Joe", Sobrenome: "Bloggs".
Se o nome for "MÁRCIA HELENA MAIA DE LIMA", o Intercom registra como Primeiro nome: "MÁRCIA" Sobrenome: "HELENA MAIA DE LIMA"
Se o nome for "Dr. Drew Bloggs", o Intercom registra como Primeiro nome: "Drew" Sobrenome: "Bloggs"
Se o nome for "Joe Bloggs, CBA", o Intercom registra como Primeiro nome: "Joe" Sobrenome: "Bloggs" - "CBA" ainda será mostrado no nome completo de Joe no Intercom.
Se o nome for "Bloggs, Joe", o Intercom registra como Primeiro nome: "Joe" Sobrenome: "Bloggs"
Se o nome for "Dr Bloggs", o Intercom registra Primeiro nome como "não existe" Sobrenome "Bloggs"
Para definir um nome do meio, use o formato: "Sobrenome, Primeiro nome Nome do meio". Se o nome for "Bloggs, Joe Drew", o Intercom registra Primeiro nome como: "Joe Drew" Sobrenome: como "Bloggs"
Se um usuário não forneceu um nome, usaremos o 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 Local" 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 solicitaçõ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 as coisas.
Como a lista de usuários é atualizada em tempo real?
A presença em tempo real do usuário atualizará o ponto verde mostrado ao lado da foto do perfil de um usuário ou lead:
Quando sua lista de usuários é 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, você 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 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 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 SO para dispositivos desktop (Mac) e iPad, então o Intercom não pode distinguir entre os dois tipos de dispositivos. 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 de 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 de pessoa
Cancelou a inscrição do email
Marcou o email como spam
Teve rejeição permanente
Campanha UTM
Conteúdo UTM
Meio UTM
Fonte UTM
Termo UTM
URL de referência
Opt-ins do tipo 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 da empresa para 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.










