Quando você cria um Tooltip, o Intercom abre seu site para que você possa posicioná-lo e projetá-lo com o construtor de Tooltip. Este artigo ajuda se o construtor não carregar no seu site, indicar que o Messenger não está carregado ou não salvar seu Tooltip.

O construtor de Tooltip conecta-se ao Intercom através do Messenger no seu site. Se não conseguir conectar, você verá uma mensagem dizendo que o Messenger não está carregado, ou o construtor não aparecerá. Verifique o seguinte.

O Messenger deve estar instalado na página onde você está criando o Tooltip, e deve inicializar para você enquanto estiver logado. Por exemplo, se você instalou o Messenger apenas para visitantes desconectados, o construtor não carregará dentro do seu produto. Se seu site estiver configurado para que o Messenger não inicialize para administradores, certifique-se de que ele inicialize para seu login enquanto você cria o Tooltip.

Se você tiver mais de um workspace Intercom, verifique se o workspace onde está criando o Tooltip é o que está instalado na página. Compare o ID do workspace na URL do Intercom com o resultado de executar window.intercomSettings.app_id no console do navegador nessa página. Essa verificação funciona com a instalação padrão em JavaScript.

O construtor abre a URL que você escolheu para o Tooltip e só conecta a uma página no mesmo domínio. Se essa URL agora redireciona para um domínio diferente (por exemplo, depois que você mudou seu site de example.com para example.io), o construtor não consegue conectar. Tooltips não têm uma configuração para alterar a URL armazenada, então crie o Tooltip novamente no domínio atual da página.

Se seu site ou produto estiver carregado dentro de um iframe de terceiros (por exemplo, um App Shopify ou um plugin Figma), o Messenger não consegue acessar a página que o contém, e o construtor de Tooltip não funcionará.

O construtor de Tooltip usa window.opener para se comunicar com o Intercom. Se seu site enviar um cabeçalho Cross-Origin-Opener-Policy com qualquer valor diferente do padrão unsafe-none, ou se o JavaScript do seu site sobrescrever window.opener, o construtor não carregará. Defina o cabeçalho para unsafe-none ou remova-o enquanto você cria o Tooltip. Você pode alterá-lo de volta depois: isso não afeta como os Tooltips ativos aparecem para os clientes.

O construtor salva alguns valores no armazenamento de sessão do seu site (chaves começando com intercom.intercom-snippet__intersection-) para se comunicar com o Intercom. Se seu site limpar o armazenamento de sessão enquanto o construtor estiver aberto, por exemplo, chamando sessionStorage.clear() ao carregar a página em vez de apenas no logout, o construtor perde a conexão. Para verificar, execute Object.keys(sessionStorage) no console do navegador enquanto o construtor estiver aberto. Se nenhuma chave intercom.intercom-snippet__intersection- aparecer, peça aos seus desenvolvedores para limpar o armazenamento de sessão apenas no logout.

Se o construtor mostrar um erro geral ao salvar sem detalhes, verifique os deslocamentos de posição do Tooltip. Um Tooltip não salvará se seu deslocamento Superior ou Esquerdo estiver fora do intervalo de -1000 a 1000 pixels. Abra as configurações de layout no construtor de Tooltip, defina ambos os deslocamentos para valores entre -1000 e 1000 e salve novamente.