Instala el widget de chat de ZapClaw en tu sitio web

En resumen: el widget es una sola etiqueta de script. La pegas una vez en tu sitio, aparece una burbuja de chat y tu agente de ZapClaw responde a los visitantes con el conocimiento que le diste. El chat corre en un frame en el dominio propio de ZapClaw, chat.zapclaw.app, así que nunca lee tu página.

El snippet

<script async src="https://chat.zapclaw.app/loader.js" data-widget-id="YOUR_WIDGET_ID"></script>

Copia el snippet exacto de tu widget en el área Agents del panel. El id de arriba es un ejemplo: el tuyo es diferente.

El async evita que el loader retrase tu página, y el loader solo crea el frame del chat cuando un visitante abre la burbuja por primera vez.

Elige tu plataforma

• WordPress, para un sitio que alojas tú.
• WordPress.com, en los planes que permiten plugins.
• Google Tag Manager, con una etiqueta de HTML personalizado.

Cualquier otro constructor de sitios que permita agregar un script a todas las páginas funciona igual: pega el snippet donde la plataforma acepte código personalizado, normalmente el pie de página o justo antes de la etiqueta body de cierre. Algunos planes gratuitos no aceptan código personalizado, y en ese caso el widget no se puede instalar allí.

Sitios permitidos. En el panel, agrega la dirección de tu sitio a los sitios permitidos del widget, exactamente como la ven los visitantes. https://www.example.com y https://example.com son dos direcciones distintas. Un sitio que no está en la lista no muestra la burbuja.

Si tu sitio tiene una Content Security Policy

La mayoría de los sitios no necesita nada aquí. Un sitio con una Content Security Policy estricta agrega dos entradas a su política, y nada más:

script-src https://chat.zapclaw.app
frame-src https://chat.zapclaw.app

• script-src permite que la página cargue el pequeño archivo del loader.
• frame-src permite que la página muestre el frame del chat.
• Solo si tu política también restringe connect-src (o no tiene connect-src pero restringe default-src), agrega también connect-src https://chat.zapclaw.app. El loader lee allí el aspecto de tu burbuja antes de dibujarla.
• No se necesita ninguna entrada de style-src: el loader aplica los estilos con la API de estilos del navegador, nunca con una etiqueta de estilo en línea.

Agrega la dirección a la directiva que ya tienes. Si no tienes script-src ni frame-src, el navegador recurre a default-src, así que agrégala ahí.

Modo anónimo

El widget de estas guías funciona en modo anónimo: no sabe quién es el visitante. Aun así responde con las bases de conocimiento que marcaste como públicas, recoge un contacto cuando lo necesita y pasa el caso a una persona cuando corresponde.

Reconocer a un visitante con sesión iniciada exige un token de identidad firmado, generado por tu propio servidor. Un sitio sin servidor o sin desarrollador, como un sitio en un constructor de páginas o en WordPress.com, sigue siendo anónimo, y un visitante anónimo nunca llega a las bases que mantuviste privadas.

Qué hace el widget en tu sitio

• Sin cookies, sin rastreo. No guarda cookies y no carga analytics, píxeles ni terceros en tu página.
• Nada escrito en tu dominio. Lo único que guarda es un id de sesión aleatorio, dentro del frame del chat, en chat.zapclaw.app. Los navegadores mantienen ese almacenamiento separado para cada sitio.
• No lee tu página. El chat corre en un frame de otro dominio y por eso no ve tus formularios ni tu texto.
• Se avisa al visitante que es una IA. El chat abre con un aviso de que las respuestas vienen de una IA y dice cómo hablar con una persona.

Una frase para tu política de privacidad

El widget trata lo que escriben tus visitantes, en tu nombre, así que tu política de privacidad debe decirlo. Puedes adaptar esta frase:

El asistente de chat de este sitio web lo proporciona ZapClaw, que trata los mensajes que escriben los visitantes en nuestro nombre, como nuestro encargado del tratamiento. El chat no guarda cookies en este sitio web, y las conversaciones se conservan durante 90 días.

Es un punto de partida, no asesoría legal: adáptala a tu política y a las leyes que te aplican. Cómo trata los datos ZapClaw está en la Política de Privacidad.

Comprueba que funciona

1. Abre tu sitio en una ventana privada, para que ningún caché ni extensión estorbe.
2. Busca la burbuja en la esquina que elegiste. Ábrela y envía una pregunta que tu agente sepa responder.
3. ¿Sin burbuja? Revisa, en este orden: el agente está publicado, el widget está activo, tu dirección está en los sitios permitidos, el snippet está en la página (mira el código fuente de la página y busca chat.zapclaw.app) y ningún bloqueador de contenido ni Content Security Policy lo impide.

Otras guías de instalación

• WordPress, para un sitio que alojas tú.
• WordPress.com, en los planes que permiten plugins.
• Google Tag Manager, con una etiqueta de HTML personalizado.