Consenty
V-28 Inicio rapido

Instala Consenty en 5 minutos

Sigue estos pasos para tener el widget y la API publicos funcionando en cualquier sitio web. El modo SPA es opcional y solo lo necesitas si tu sitio se renderiza en el cliente.

1

Pega el snippet en tu sitio

En el bloque <head> o justo antes de </body>.

index.html
html
<!-- Consenty: widget de consentimiento -->
<script
  src="https://cdn.consenty.cl/sdk/consenty-0.0.0.umd.js"
  data-site-key="a1b2c3d4-e5f6-4789-a012-3456789abcde"
  data-locale="es-CL"
  defer
  crossorigin="anonymous"
  integrity="sha384-PEGAR_EN_SNIPPET_DEL_PANEL"></script>
<!-- /Consenty -->
Atributo integrity
El snippet real servido por el panel incluye el hash sha384 exacto del bundle. Copialo desde Canales -> SDK o via GET /v1/channels/:id/snippet — nunca lo inventes a mano.
2

Configura los origenes permitidos

El panel rechaza cualquier origen que no este en la lista. Recomendado antes de salir de staging.

pasos.txt
text
/# 1. Abre Canales -> tu canal -> ficha SDK
# 2. Anade cada origen donde vivira el snippet (https://tu-dominio)
# 3. El backend rechaza cualquier origen no registrado
Abrir Canales
3

Verifica en el sitio de prueba

Carga el sitio, acepta o rechaza, y revisa que la decision aparezca en Evidencia en menos de 5 segundos.

  • El banner aparece una sola vez por visitante (pseudonimo persistente).
  • Las tecnologias opcionales quedan bloqueadas hasta que haya consentimiento.
  • La decision se proyecta como un evento en /evidence.
4

Opcional — instala el paquete para SPAs

Si tu sitio se construye con un bundler (Vite, Next, Nuxt, etc.) prefiere el paquete npm al snippet.

terminal
bash
npm install @consenty/web-sdk
src/consenty.ts
ts
import { createConsenty } from '@consenty/web-sdk'

const client = createConsenty({
  siteKey: 'a1b2c3d4-e5f6-4789-a012-3456789abcde',
  locale: 'es-CL'
})

await client.ready()
if (client.hasConsent('analytics')) {
  // cargar script de analytics
}
Listo para produccion
Cuando el sitio funcione en staging, mueve el canal a Produccion, anade los origenes definitivos y revisa que el bundle servico por el panel siga el patron anterior.