Se você instalou o Intercom Messenger e ele não está aparecendo corretamente, aqui estão algumas formas comuns de corrigir isso.
Este artigo cobre qualquer integração web. A integração web envolve adicionar o trecho de código JavaScript em uma página ou pode ser feita de forma mais automática, como nossos apps WordPress e Shopify que só requerem clicar e autorizar.
Uma regra geral é que, se você vê o ping do Intercom no console web, então o código deve estar instalado corretamente.
1. Você tem uma assinatura que inclui o Messenger?
Você não poderá usar o Messenger se não tiver um teste ou assinatura Intercom.
2. Você ativou o tráfego de usuários?
Certifique-se de que você ativou o tráfego de usuários para o Messenger em Configurações > Canais > Messenger > Instalar.
3. Você instalou corretamente o trecho de código JavaScript do Intercom?
Existem duas formas de instalar o Intercom Messenger usando JavaScript:
Instale o Intercom para visitantes ou leads, para que você possa conversar com visitantes desconectados.
Instale o Intercom para users, para que você possa conversar com users conectados.
Você deve garantir que está usando o trecho de código JavaScript correto no lugar certo.
Se você seguiu os guias acima para instalar o trecho, mas ainda não vê o Messenger, aqui estão os próximos passos:
No trecho de código JavaScript, certifique-se de que você substituiu o espaço reservado “
app_id” pelo seu ID do workspace.Você precisa adicionar o trecho logo antes do fim da tag de fechamento
</body>no seu site ou no seu app.
Nota: Se você estiver usando uma Single Page Application (SPA), consulte o Guia de Integração SPA para passos específicos para integrar o Messenger em um ambiente SPA.
4. Se você estiver usando o Google Tag Manager para instalar o Messenger, está apontando para a região correta?
Para uma configuração correta do GTM, certifique-se de que o script GTM está colocado na seção <head> do seu HTML e que as tags estão configuradas e publicadas corretamente. Para mais informações, consulte o Guia de Instalação GTM.
Este app usa um método sem código para instalar o Intercom Messenger. Se você for usar o GTM com um workspace regional, precisará passar "api_base" como um atributo de dados personalizado, na seção "rastreando dados personalizados sobre seus users" com o valor regional:
Confira este artigo para mais informações.
5. Qual APP_ID você está usando? Você tem múltiplos apps?
Você digitou incorretamente ou tem múltiplos apps? Verifique o app_id na requisição ping (No Chrome: clique com o botão direito na página > Inspecionar > Rede); se não vir o ping, recarregue a página.
Você também pode tentar verificar intercomSettings no console, mas isso só se aplica para apps não single-page. Apps single-page podem não ter intercomSettings definido.
6. Há um ping na página?
Abra o console e tente um método rápido de carregar o Messenger com Intercom('show');
Se isso não funcionar, procure a requisição ping (provavelmente você precisará recarregar a página para vê-la). Se não vir nenhuma requisição ping, provavelmente o trecho do Intercom não está instalado ou não está instalado corretamente.
7. Você tem as configurações corretas do Messenger ativadas?
Existem várias formas de personalizar o Messenger e adicionar camadas extras de segurança. No entanto, algumas configurações podem impedir o carregamento do Messenger se configuradas incorretamente.
Ao instalar o Messenger, é possível escondê-lo do seu público antes do lançamento:
Você está mostrando o lançador do Messenger para as pessoas certas?
Em Configurações do Messenger, você pode "Controlar o volume das suas conversas recebidas" e configurar o lançador do Messenger para mostrar a visitantes ou users, ou se eles corresponderem a certos dados.
Se você escolher mostrar o Messenger para visitantes ou users que correspondam a certos dados, seus clientes (e você) precisarão corresponder a esses dados para ver o Messenger aparecer. Por exemplo, se você quiser mostrar o Messenger apenas para users com status "VIP", somente users com esses dados verão o Messenger.
Você aplicou uma configuração de segurança do Messenger, mas não configurou corretamente?
O Messenger não carregará se a autenticação JWT / Verificação de Identidade estiver configurada incorretamente. Além disso, a API do Messenger deve estar ativada nas configurações do seu app para que a interface Switch funcione corretamente. Se a API do Messenger estiver desativada, o Switch não carregará e pode exibir uma página em branco.
Com JWTs, você precisa gerar um token único para as requisições do seu user e fornecê-lo ao iniciar o user. Esse token único é gerado usando sua chave secreta da API do Messenger e, no mínimo, o ID externo único do seu user.
Com a Verificação de Identidade, você usa a chave secreta das suas configurações de segurança do Intercom para gerar um hash único para cada um dos seus users conectados, que você envia junto com os outros dados do user para o Messenger.
Se você aplicar uma configuração de segurança do Messenger sem enviar corretamente tokens ou hashes pela sua integração do Messenger para cada user, o Messenger não carregará para eles. Da mesma forma, se você aplicar a Verificação de Identidade com tokens ou hashes inválidos para cada user, o Messenger falhará ao carregar.
A maneira mais fácil de ver se isso é a causa do seu problema é abrir o console do navegador e procurar mensagens de erro específicas.
Leia mais sobre como solucionar erros específicos de JWT aqui ou erros de Verificação de Identidade aqui 📚
Você está em um domain confiável?
Em Mantenha seu Messenger seguro, você pode listar os domains confiáveis onde instalou o Intercom.
Se esses domains foram adicionados incorretamente ou o domain em que você está não está listado, o Messenger não carregará e você verá um erro 403 no console do navegador.
Passos para encontrar erros de domain confiável no console:
Abra o console, clique em Rede e depois atualize a página.
Filtre as requisições de rede escrevendo "ping".
Clique na aba Resposta.
8. Você está usando um domain de sufixo público?
Instalar o Intercom no seu site depende do Messenger poder criar um cookie de primeira parte para seu domain, como *.customer-domain.com. Isso falhará (com navegadores modernos) em qualquer domain registrado como sufixo público, como firebaseapp.com ou herokuapp.com. Veja a lista completa de domains de sufixo público aqui.
9. Você vê um erro 409 sinalizado no console?
Se você vê um erro 409 sinalizado no console, isso indica um conflito. Normalmente, esse conflito é causado por múltiplos users existentes com o mesmo endereço de email e o Intercom não sabe qual deles você está tentando logar.
Para resolver isso, você pode:
Use um
user_idcomo identificador único ao logar seus users.
Outras coisas para verificar
Você usa uma extensão de bloqueio de anúncios ou modo de navegação privada?
Algumas extensões de bloqueio de anúncios também bloqueiam JavaScript que inclui funcionalidades de rastreamento, como o Messenger. Descubra por que isso acontece e o que fazer a respeito aqui.
Você modificou o trecho de código JavaScript do Intercom ou aplicou estilos personalizados ao messenger?
Alterar o código de instalação ou aplicar seu próprio CSS aos elementos do Intercom pode ter resultados inesperados, então recomendamos não fazer isso. Se você tem um caso específico em mente, converse com nossa equipe de suporte no Messenger. Podemos te orientar. 😄 Além disso, certifique-se de que o parâmetro hide_default_launcher no objeto intercomSettings não esteja definido como true a menos que seja intencional. Ajuste ou remova esse parâmetro se ele conflitar com as regras de visibilidade especificadas.
Você está usando o plugin do WordPress?
Se você estiver usando o plugin do Intercom WordPress para conversar apenas com visitantes desconectados, será necessário sair do painel administrativo do WordPress antes de visitar seu site para ver o Messenger aparecer.
Você também deve ter o WordPress 4.2.0 e PHP 5.6 ou superior para que o Messenger carregue corretamente quando instalado com o plugin.
Certos temas do WordPress não incluem o elemento footer onde o trecho de código JavaScript do Intercom é inserido pelo plugin. Se você usar um tema sem footer, precisará instalar o Intercom com o trecho de código JavaScript diretamente nas suas páginas do WordPress.
Outras formas de verificar erros
Você pode verificar o console do seu navegador para quaisquer outros erros se o Messenger ainda não estiver carregando corretamente. Veja como verificar em cada navegador web:
No Chrome, use o atalho de teclado ctrl + shift + J (Windows) ou command + option + J (Mac) para abrir o console do desenvolvedor.
No Firefox, use o atalho de teclado ctrl + shift + K (Windows) ou command + option + K (Mac). A caixa de ferramentas aparecerá na parte inferior da janela do navegador, com o Console Web ativado.
No Edge, use a tecla F12 para acessar as Ferramentas de Desenvolvedor F12. Uma vez nas Ferramentas de Desenvolvedor F12, navegue até a aba Console.
No Safari, você precisará ativar o menu Desenvolver. Abra o menu Safari na barra de menus do Mac e selecione “Preferências”. Depois, navegue até a aba Avançado e marque a caixa "Mostrar menu Desenvolver na barra de menus". Agora você pode usar o atalho de teclado command + option + C para abrir o console do desenvolvedor.
Se você ainda estiver com problemas para carregar o Messenger, converse conosco no Messenger e teremos prazer em ajudar!
E se o Messenger não estiver aparecendo na minha própria inbox e eu não conseguir contatar o suporte?
Foi decidido esconder o Messenger em algumas situações dentro da Inbox para que ele não conflite com a barra lateral/Copilot. A solução é ir para uma página diferente no app e abrir o lançador do Messenger de lá.
Nota: Se você não conseguir acessar as configurações do Messenger, certifique-se de que você tem a permissão "Pode acessar configurações do Messenger" ativada.