Leva apenas alguns minutos para instalar o Messenger no seu site. Depois de instalado, você poderá dar boas-vindas, orientar e suportar clientes à medida que eles se tornam users leais do seu aplicativo.
Os dois passos necessários para uma instalação completa e segura do Messenger são:
Você precisará de uma versão de teste ou assinatura do Intercom para instalar o Messenger.
Instalação inicial do Messenger para users na web
Primeiro acesse Configurações > Canais > Messenger > Instalar e escolha Instalar para web.
Escolha como instalar o Messenger
Selecione como deseja instalar escolhendo um dos métodos a seguir:
Trecho de código
React
Angular
Vue
Ember
WordPress
Google Tag Manager
Shopify
Segment
Cada método fornece etapas específicas quando selecionado. Muitos desses métodos oferecem uma instalação via NPM para facilitar para você.
Peça ajuda ao seu desenvolvedor (opcional)
Se necessário, você pode pedir a um colega (como um engenheiro) para completar a instalação. Basta clicar em Convidar colega.
Depois de inserir o e-mail deles, um convite por e-mail será enviado permitindo que eles entrem no espaço de trabalho da sua equipe.
O colega convidado receberá um lite seat nos planos Advanced / Expert e um full seat nos planos Essential. Eles terão as permissões mínimas necessárias para instalar o Messenger:
Pode gerenciar configurações gerais e de segurança
Pode gerenciar configurações do Messenger
Pode gerenciar dados do workspace
Instale você mesmo
Se você selecionou Trecho de código, React, Angular, Vue, Ember ou Shopify como método de instalação, você terá a opção de concluir a instalação para:
Para users com login - Instale o Messenger para users logados. O Messenger mostrará informações como nomes de clientes e conversas anteriores entre dispositivos.
Para visitantes do site sem login - Instale o Messenger para visitantes anônimos que não estão logados. As conversas serão salvas no navegador via cookie.
Recomendamos instalar o Messenger para users e visitantes.
Você deve então "Habilitar conexão com o messenger".
Importante: Se isso estiver desativado, todas as solicitações ao Intercom falharão. As APIs do Messenger não são habilitadas por padrão. Como você pode ver quando acessa a página de instalação do Messenger, os exemplos de código ficam acinzentados até ativar esse interruptor. Isso ativa as APIs do Messenger para seu workspace e garante que comece a aceitar tráfego. Você precisará habilitar isso para começar com qualquer tráfego de users.
Depois de configurar seu Messenger, também recomendamos protegê-lo com JWTs!
Instale o Intercom pelo método escolhido
Agora siga as instruções fornecidas para o método selecionado. Por exemplo, se você selecionou WordPress, verá as instruções abaixo para esse método.
Se você selecionou o método Trecho de código, React, Angular, Vue, ou Ember, você receberá um pacote NPM contendo um trecho de código para copiar e colar no código-fonte do seu aplicativo. Esse trecho vem pré-preenchido com seu ID de workspace exclusivo, então está pronto para uso.
Você também pode encontrar o pacote diretamente no site da NPM.
Existem vários outros templates disponíveis, como incluir o trecho de código em um app Node.js/Rails (Ruby)/Django (Python 3) ou PHP. Você também pode incluir o trecho em um aplicativo de página única ou usar a gem do Rails para instalar o trecho. Para Single-Page Applications (SPAs), siga o guia de instalação para SPA para lidar com sua natureza dinâmica.
Clique em Copiar código e cole-o antes da tag </body> em cada página em que você deseja que o Messenger apareça no seu app.
Em seguida, edite o código para enviar ao Intercom o endereço de email ou user_id e a data de cadastro do usuário que está atualmente logado.
Após adicionar o código, abra seu app e o Messenger aparecerá.
Encerrar sessões de users ao fazer logout
Certifique-se também de chamar o método shutdown do Intercom para limpar as conversas dos seus clientes quando eles fizerem logout do seu app.
Qualquer user que use um computador e navegador compartilhados com outra pessoa poderá ver o histórico de conversas do usuário que fez login mais recentemente até que o cookie expire. Por isso, é muito importante encerrar corretamente o Intercom quando a sessão de um user no seu app terminar (via logout manual ou automático).
Importante:
Você pode identificar users com um user_id ou endereço de email.
Se você enviar um user_id e um endereço de email, o user_id terá prioridade ao identificar seus users.
Se você optar por usar user_id, o endereço de email ainda pode ser usado para identificar seus users no Intercom, então recomendamos habilitar a verificação de identidade.
Você também pode enviar ao Intercom atributos personalizados sobre seus users.
Se você estiver usando o
zoomCSS na sua página, certifique-se de que os widgets do Intercom não o estejam recebendo.Sempre passe
user_id,emaileuser_hashdinamicamente do seu servidor para o user atualmente logado — nunca codifique ou armazene em cache a identidade de um único user no trecho. Se um visitante estiver desconectado, omita totalmente esses campos para que sejam rastreados como visitante anônimo em vez de identificados como outro user.
Opções de aparência
A primeira opção permite escolher se deseja mostrar ou ocultar o messenger para o público do seu site antes do lançamento. Caso contrário, o padrão é mostrar o messenger.
A segunda opção linka para as Configurações do Messenger, onde você pode alterar as cores e o tema do messenger.
Verificar a instalação
Você pode verificar se a instalação foi bem-sucedida clicando em Verificar instalação. Esse botão oferece uma notificação de sucesso se o Messenger foi encontrado com sucesso ou indica se algo deu errado.
Se você instalou o Intercom Messenger e ele não está aparecendo corretamente, aqui estão algumas maneiras comuns de corrigir. A solução adicional inclui verificar restrições do navegador como bloqueadores de anúncios ou navegação privada que podem bloquear o Messenger, além de evitar domínios de sufixo público para garantir a visibilidade adequada.
Agora continue para a próxima etapa do processo de instalação e proteja seu messenger com JWTs.
Nota: Sem a Segurança do Messenger, seus users verão apenas os últimos 14 dias do histórico de conversas no Messenger. Saiba mais →
Aprenda como:
Instalando o Intercom para um cliente
Se você não tiver acesso ao workspace do Intercom, você pode pegar o código JavaScript aqui 👇 Você precisará substituir manualmente WORKSPACE_ID pelo ID de workspace exclusivo da sua conta Intercom.
<script>
var APP_ID = "WORKSPACE_ID"; // Replace this with your workspace ID
window.intercomSettings = {
app_id: APP_ID,
name: "Jane Doe", // Full name
email: "customer@example.com", // Email address
created_at: 1312182000 // Signup date as a Unix timestamp
};
</script>
<script>(function(){var w=window;var ic=w.Intercom;if(typeof ic==="function"){ic('reattach_activator');ic('update',w.intercomSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Intercom=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://widget.intercom.io/widget/' + APP_ID;var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}})();</script>
O valor para created_at deve ser a data em que um cliente se inscreveu no seu app, site ou serviço, enviada como um Unix timestamp.
Instalando o Intercom para workspaces hospedados na UE e AU
Para instalar o Intercom se você estiver usando nossa hospedagem na UE ou AU, você precisará fornecer um parâmetro adicional api_base. Os valores para isso estão listados na tabela abaixo.
Região de hospedagem de dados |
|
Estados Unidos (US) | |
União Europeia (EU) | |
Austrália (AU) |
Instalar o Intercom em um ambiente desktop
Tecnicamente é possível incluir o Intercom em um aplicativo desktop, no entanto, nós não oferecemos suporte oficial para ambientes desktop. O Intercom Messenger foi projetado e desenvolvido para rodar em um ambiente web (lista de navegadores suportados). Esses ambientes web suportam funcionalidades específicas que nosso Messenger depende (por ex. Javascript e CSS).
Electron e tecnologias similares permitem construir aplicativos desktop usando tecnologia web, e é possível instalar o Intercom nesses tipos de aplicativos - existem até bibliotecas comunitárias para ajudar a instalar o Intercom em ambientes Electron, entretanto, não é algo que suportamos oficialmente.