Aprenda como adicionar um banner de consentimento de cookies ao seu Help Center usando integração direta com Consent Management Platform (CMP) ou Google Tag Manager (GTM). Este guia cobre requisitos, instruções passo a passo e considerações importantes para manter conformidade e funcionalidade.
Antes de começar
Importante:
Você deve configurar um custom domain para seu Help Center. Este processo não funcionará com o domain padrão da Intercom (ex.: intercom.help).
Habilitar scripts personalizados removerá o Intercom Messenger e o Google Analytics do seu Help Center somente se você fornecer um script personalizado. Se quiser continuar usando Messenger e Google Analytics com scripts personalizados, deve incluí-los no seu script personalizado. Veja a seção Como adiciono o Intercom Messenger ao meu script personalizado? abaixo para detalhes.
Nota: Help centers sem scripts personalizados continuarão carregando Intercom Messenger e Google Analytics normalmente, mesmo com o recurso ativado para seu workspace.
O script personalizado que você fornecer será executado apenas na seção
<head>da página do seu Help Center.Quando scripts personalizados estão habilitados para seu workspace:
Help centers com scripts personalizados: Apenas seus scripts personalizados serão carregados. Scripts padrão da Intercom (Messenger, Google Analytics) não serão carregados.
Help centers sem scripts personalizados: Continuarão carregando scripts padrão da Intercom (Messenger, Google Analytics) normalmente.
Como diferentes CMPs se integram
Todos os CMPs podem funcionar com seu Help Center — a abordagem de implementação varia conforme seu provedor.
OneTrust
Possui integração embutida com o Help Center.
O botão de configurações de cookies conecta-se automaticamente ao modal do OneTrust.
Seu script precisa incluir sua configuração do OneTrust.
Nenhum código adicional para manipulação do botão é necessário.
Outros CMPs (Usercentrics, Cookiebot, CookieYes, etc.)
Requerem código adicional da sua equipe de desenvolvimento.
Seu script deve conectar-se ao botão de configurações de cookies do Help Center.
Veja a seção Botão de configurações de cookies abaixo para detalhes.
Botão de configurações de cookies
O Help Center cria automaticamente um botão de configurações de cookies com o ID ot-sdk-btn que os visitantes usam para gerenciar suas preferências.
Com OneTrust
O botão conecta-se automaticamente ao modal de consentimento do OneTrust.
Nenhum código adicional é necessário.
Com outros CMPs
Seu script deve incluir código que escute cliques neste botão.
Quando clicado, seu código aciona a exibição das configurações do seu CMP.
Sem esse código, o botão não funcionará.
Nota: Sua equipe de desenvolvimento precisa adicionar um event listener para o elemento ot-sdk-btn. A implementação específica depende da API do seu CMP — consulte a documentação do seu provedor para a função correta para abrir as configurações de consentimento.
Como implementar um banner de consentimento de cookies
Você tem duas opções para adicionar o banner de cookies:
Opção 1: Integração direta com CMP
Esta opção requer um script da sua equipe de engenharia que implemente a Consent Management Platform (CMP) escolhida.
Passo 1: Prepare seu script
Sua equipe de engenharia deve preparar um script que:
Implemente a CMP escolhida.
Garanta que cookies que exigem consentimento do usuário sob leis de privacidade aplicáveis sejam configurados somente após o consentimento ser obtido.
Nota: Habilitar scripts personalizados removerá o Intercom Messenger e o Google Analytics do seu Help Center. Se quiser continuar usando esses, deve incluí-los no seu script personalizado (veja Como adiciono o Intercom Messenger ao meu script personalizado? para detalhes).
Passo 2: Contate-nos para injetar o script
Quando seu script estiver pronto, entre em contato com nossa equipe de suporte e forneça o script. Eles o injetarão no seu Help Center.
Nota: Este processo requer que nossa equipe de suporte injete manualmente o script. Não é uma configuração self-service.
Passo 3: Verifique a implementação
Após confirmarmos que o script foi injetado, você deve verificar se os cookies são configurados somente após obter todos os consentimentos necessários dos visitantes do seu Help Center.
Opção 2: Google Tag Manager (GTM) + CMP
Se você estiver usando Google Tag Manager, o GTM está incluído dentro do seu script personalizado em vez de ser injetado separadamente. O Help Center pode injetar o elemento <noscript> do corpo separadamente, mas não pode injetar o JavaScript principal do GTM no <head> de forma independente.
Passo 1: Configure o GTM
Seu script personalizado deve incluir todos os seguintes itens:
- Sua configuração CMP.
- Inicialização do GTM.
- Intercom Messenger (se necessário — veja as FAQs abaixo).
- Conexão do botão de configurações de cookies, se você não estiver usando OneTrust (veja a seção Botão de configurações de cookies acima).
Forneça o elemento <noscript> do corpo separadamente ao enviar seu script. Nossa equipe o injetará no <body> do seu Help Center.
Passo 2: Contate-nos para injetar o script do GTM
Quando seu script do GTM estiver pronto, entre em contato com nossa equipe de suporte e forneça-o. Eles o injetarão no seu Help Center.
Nota: Este processo requer que nossa equipe de suporte injete manualmente o script. Não é uma configuração self-service.
Passo 3: Verifique a implementação
Após confirmarmos que o script foi injetado, certifique-se de que os cookies sejam configurados somente após obter todos os consentimentos necessários dos visitantes do seu Help Center.
Requisitos de domain para CSP
Antes de enviar seu script, identifique quais domains seu CMP requer. Eles devem ser adicionados à configuração da Content Security Policy (CSP) — sem isso, o navegador bloqueará as requisições do seu CMP.
Como encontrar os domains necessários
Verifique a documentação técnica do seu provedor CMP.
Procure por "requisitos CSP" ou "domains para whitelist".
Contate seu provedor CMP se isso não estiver documentado.
Notas específicas do CMP
OneTrust: Nenhum domain adicional necessário (suporte embutido).
Usercentrics, Cookiebot, CookieYes: Verifique a documentação do seu provedor para domains necessários.
Nota: Ao enviar seu script, inclua a lista de domains necessários para que nossa equipe de suporte possa adicioná-los à configuração CSP.
Detalhes técnicos
Seu script personalizado carrega no topo da seção <head> da página. Criar novos elementos script usando document.createElement("script") ou innerHTML não herdará o nonce e será bloqueado pela CSP. Para garantir compatibilidade, execute o código JavaScript diretamente em vez de injetar novos elementos script. Se essa abordagem não atender suas necessidades, contate-nos para mais orientações.
Você pode adicionar múltiplas tags <script> ao seu Help Center. Por exemplo:
<script src="https://..." />
<script>
console.log("test");
</script>
Suporte a elemento noscript no corpo:
Se precisar adicionar elementos noscript ao <body> da página do seu Help Center (por exemplo, tags noscript do Google Tag Manager), você pode fornecer os elementos do corpo que deseja adicionar.
Exemplo:
<noscript>
<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXX"
height="0" width="0" style="display:none;visibility:hidden">
</iframe>
</noscript>
FAQs
O que acontece se eu usar o domain padrão da Intercom?
O que acontece se eu usar o domain padrão da Intercom?
Você deve usar um custom domain para seu Help Center. Este processo não funcionará com o domain padrão da Intercom (ex.: intercom.help).
Habilitar scripts personalizados removerá o Intercom Messenger ou Google Analytics?
Habilitar scripts personalizados removerá o Intercom Messenger ou Google Analytics?
Habilitar scripts personalizados removerá o Intercom Messenger e o Google Analytics do seu Help Center somente se você fornecer um script personalizado. Help centers sem scripts personalizados continuarão carregando Intercom Messenger e Google Analytics normalmente. Se você fornecer um script personalizado e quiser continuar usando Messenger e Google Analytics, deve incluí-los no seu script personalizado. Veja Como adiciono o Intercom Messenger ao meu script personalizado? para detalhes.
Posso adicionar múltiplos scripts ao meu Help Center?
Posso adicionar múltiplos scripts ao meu Help Center?
Sim. Você pode adicionar múltiplas tags <script> à página do seu Help Center.
Como adiciono o Intercom Messenger ao meu script personalizado?
Como adiciono o Intercom Messenger ao meu script personalizado?
Veja nosso guia de instalação do Messenger para instruções detalhadas sobre como adicionar o Messenger ao seu script personalizado.
Importante: Ao adicionar o Messenger ao seu script personalizado, você também deve integrá-lo com sua Consent Management Platform (CMP) para controlar os cookies do Messenger com base no consentimento do usuário. Veja Como posso controlar os cookies do Intercom Messenger com meu banner de consentimento? abaixo para detalhes de implementação.
Como posso controlar os cookies do Intercom Messenger com meu banner de consentimento?
Como posso controlar os cookies do Intercom Messenger com meu banner de consentimento?
Para instruções detalhadas e passo a passo sobre como implementar isso, veja nosso artigo: Cookies do Intercom Messenger.