Aprende cómo agregar un banner de consentimiento de cookies a tu Help Center usando una integración directa de Consent Management Platform (CMP) o Google Tag Manager (GTM). Esta guía cubre requisitos, instrucciones paso a paso y consideraciones importantes para mantener el cumplimiento y la funcionalidad.
Antes de comenzar
Importante:
Debes configurar un custom domain para tu Help Center. Este proceso no funcionará con el domain predeterminado de Intercom (por ejemplo, intercom.help).
Habilitar scripts personalizados eliminará Intercom Messenger y Google Analytics de tu Help Center solo si proporcionas un script personalizado. Si deseas seguir usando Messenger y Google Analytics con scripts personalizados, debes incluirlos en tu script personalizado. Consulta la sección ¿Cómo agrego Intercom Messenger a mi script personalizado? a continuación para más detalles.
Nota: Los Help Center sin scripts personalizados seguirán cargando Intercom Messenger y Google Analytics normalmente, incluso cuando la función esté habilitada para tu espacio de trabajo.
El script personalizado que proporciones solo se ejecutará en la sección
<head>de la página de tu Help Center.Cuando los scripts personalizados están habilitados para tu espacio de trabajo:
Help Center con scripts personalizados: Solo se cargarán tus scripts personalizados. Los scripts predeterminados de Intercom (Messenger, Google Analytics) no se cargarán.
Help Center sin scripts personalizados: Seguirán cargando los scripts predeterminados de Intercom (Messenger, Google Analytics) normalmente.
Cómo se integran diferentes CMP
Todos los CMP pueden funcionar con tu Help Center; el enfoque de implementación varía según tu proveedor.
OneTrust
Tiene integración incorporada con el Help Center.
El botón de configuración de cookies se conecta automáticamente al modal de OneTrust.
Tu script debe incluir tu configuración de OneTrust.
No se requiere código adicional para manejar el botón.
Otros CMP (Usercentrics, Cookiebot, CookieYes, etc.)
Requieren código adicional de tu equipo de desarrollo.
Tu script debe conectarse al botón de configuración de cookies del Help Center.
Consulta la sección del botón de configuración de cookies a continuación para más detalles.
Botón de configuración de cookies
El Help Center crea automáticamente un botón de configuración de cookies con el ID ot-sdk-btn que los visitantes usan para gestionar sus preferencias.
Con OneTrust
El botón se conecta automáticamente al modal de consentimiento de OneTrust.
No se requiere código adicional.
Con otros CMP
Tu script debe incluir código que escuche los clics en este botón.
Al hacer clic, tu código activa la visualización de configuración de tu CMP.
Sin este código, el botón no funcionará.
Nota: Tu equipo de desarrollo debe agregar un listener de eventos para el elemento ot-sdk-btn. La implementación específica depende del API de tu CMP; consulta la documentación de tu proveedor para la función correcta que abra la configuración de consentimiento.
Cómo implementar un banner de consentimiento de cookies
Tienes dos opciones para agregar el banner de cookies:
Opción 1: Integración directa de CMP
Esta opción requiere un script de tu equipo de ingeniería que implemente tu Consent Management Platform (CMP) elegido.
Paso 1: Prepara tu script
Tu equipo de ingeniería debe preparar un script que:
Implemente tu CMP elegido.
Asegure que las cookies que requieren consentimiento del usuario bajo las leyes de privacidad aplicables se establezcan solo después de obtener el consentimiento.
Nota: Habilitar scripts personalizados eliminará Intercom Messenger y Google Analytics de tu Help Center. Si deseas seguir usándolos, debes incluirlos en tu script personalizado (consulta ¿Cómo agrego Intercom Messenger a mi script personalizado? para más detalles).
Paso 2: Contáctanos para inyectar el script
Una vez que tu script esté listo, contacta a nuestro equipo de soporte y proporciónales el script. Ellos lo inyectarán en tu Help Center.
Nota: Este proceso requiere que nuestro equipo de soporte inyecte manualmente el script. No es una configuración de autoservicio.
Paso 3: Verifica la implementación
Después de confirmar que el script ha sido inyectado, debes verificar que las cookies solo se establezcan después de haber obtenido todos los consentimientos requeridos de los visitantes de tu Help Center.
Opción 2: Google Tag Manager (GTM) + CMP
Si usas Google Tag Manager, GTM se incluye dentro de tu script personalizado en lugar de inyectarse por separado. El Help Center puede inyectar el elemento <noscript> del cuerpo por separado, pero no puede inyectar el JavaScript principal de GTM en <head> de forma independiente.
Paso 1: Configura GTM
Tu script personalizado debe incluir todo lo siguiente:
- Tu configuración de CMP.
- Inicialización de GTM.
- Intercom Messenger (si es necesario — consulta las preguntas frecuentes abajo).
- Conexión del botón de configuración de cookies, si no usas OneTrust (consulta la sección del botón de configuración de cookies arriba).
Proporciona el elemento <noscript> del cuerpo de GTM por separado cuando envíes tu script. Nuestro equipo lo inyectará en el <body> de tu Help Center.
Paso 2: Contáctanos para inyectar el script de GTM
Una vez que tu script de GTM esté listo, contacta a nuestro equipo de soporte y proporciónaselo. Ellos lo inyectarán en tu Help Center.
Nota: Este proceso requiere que nuestro equipo de soporte inyecte manualmente el script. No es una configuración de autoservicio.
Paso 3: Verifica la implementación
Después de confirmar que el script ha sido inyectado, asegúrate de que las cookies solo se establezcan después de haber obtenido todos los consentimientos requeridos de los visitantes de tu Help Center.
Requisitos de domain CSP
Antes de enviar tu script, identifica qué domains requiere tu CMP. Estos deben agregarse a la configuración de Content Security Policy (CSP); sin esto, el navegador bloqueará las solicitudes de tu CMP.
Cómo encontrar los domains requeridos
Consulta la documentación técnica de tu proveedor de CMP.
Busca "requisitos CSP" o "domains para incluir en la lista blanca".
Contacta a tu proveedor de CMP si esto no está documentado.
Notas específicas de CMP
OneTrust: No se necesitan domains adicionales (soporte incorporado).
Usercentrics, Cookiebot, CookieYes: Consulta la documentación de tu proveedor para los domains requeridos.
Nota: Al enviar tu script, incluye la lista de domains requeridos para que nuestro equipo de soporte pueda agregarlos a la configuración de CSP.
Detalles técnicos
Tu script personalizado se carga en la parte superior de la sección <head> de la página. Crear nuevos elementos script usando document.createElement("script") o innerHTML no heredará el nonce y será bloqueado por CSP. Para asegurar compatibilidad, ejecuta código JavaScript directamente en lugar de inyectar nuevos elementos script. Si este enfoque no cumple con tus necesidades, contáctanos para más orientación.
Puedes agregar múltiples etiquetas <script> a tu Help Center. Por ejemplo:
<script src="https://..." />
<script>
console.log("test");
</script>
Soporte para elemento noscript en el cuerpo:
Si necesitas agregar elementos noscript al <body> de la página de tu Help Center (por ejemplo, etiquetas noscript de Google Tag Manager), puedes proporcionar los elementos del cuerpo que deseas agregar.
Ejemplo:
<noscript>
<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXX"
height="0" width="0" style="display:none;visibility:hidden">
</iframe>
</noscript>
Preguntas frecuentes
¿Qué pasa si uso el domain predeterminado de Intercom?
¿Qué pasa si uso el domain predeterminado de Intercom?
Debes usar un custom domain para tu Help Center. Este proceso no funcionará con el domain predeterminado de Intercom (por ejemplo, intercom.help).
¿Habilitar scripts personalizados eliminará Intercom Messenger o Google Analytics?
¿Habilitar scripts personalizados eliminará Intercom Messenger o Google Analytics?
Habilitar scripts personalizados eliminará Intercom Messenger y Google Analytics de tu Help Center solo si proporcionas un script personalizado. Los Help Center sin scripts personalizados seguirán cargando Intercom Messenger y Google Analytics normalmente. Si proporcionas un script personalizado y deseas seguir usando Messenger y Google Analytics, debes incluirlos en tu script personalizado. Consulta ¿Cómo agrego Intercom Messenger a mi script personalizado? para más detalles.
¿Puedo agregar múltiples scripts a mi Help Center?
¿Puedo agregar múltiples scripts a mi Help Center?
Sí. Puedes agregar múltiples etiquetas <script> a la página de tu Help Center.
¿Cómo agrego Intercom Messenger a mi script personalizado?
¿Cómo agrego Intercom Messenger a mi script personalizado?
Consulta nuestra guía de instalación de Messenger para instrucciones detalladas sobre cómo agregar Messenger a tu script personalizado.
Importante: Al agregar Messenger a tu script personalizado, también debes integrarlo con tu Consent Management Platform (CMP) para controlar las cookies de Messenger según el consentimiento del usuario. Consulta ¿Cómo puedo controlar las cookies de Intercom Messenger con mi banner de consentimiento? a continuación para detalles de implementación.
¿Cómo puedo controlar las cookies de Intercom Messenger con mi banner de consentimiento?
¿Cómo puedo controlar las cookies de Intercom Messenger con mi banner de consentimiento?
Para instrucciones detalladas y paso a paso sobre cómo implementar esto, consulta nuestro artículo: Cookies de Intercom Messenger.