Live Chat (Chatwoot)

import { Steps } from ‘@astrojs/starlight/components’;

Nuvlyx integra Chatwoot — una plataforma de soporte open-source — para que puedas tener un chat flotante en tu storefront. Funciona con cualquier instancia: la nube oficial (app.chatwoot.com) o tu propia instalación self-hosted.

Requisitos

• Plan que incluya Live Chat o el add-on de Chatwoot activo. Si no lo tienes verás un banner indicando que la función no está disponible.
• Una instancia de Chatwoot ya creada (web o self-hosted)
• Una bandeja de entrada (Inbox) de tipo Website dentro de Chatwoot

Cómo se configura

1. Crea una bandeja de entrada en Chatwoot

   Entra a tu panel de Chatwoot:

   • Ve a Settings → Inboxes → Add Inbox
   • Elige Website como tipo
   • Sigue el asistente con el nombre y URL de tu tienda
   • Una vez creada, anota el Website Token que aparece en Settings → Inboxes → [Tu inbox] → Configuration

2. (Opcional) Habilita Identity Validation

   Si quieres que tus clientes logueados vean sus conversaciones anteriores asociadas a su cuenta:

   • En la misma bandeja, ve a Configuration → Identity Validation
   • Activa la opción y copia el Identity Validation Token (HMAC Secret)

   Sin este token el chat funciona, pero los clientes empiezan una conversación nueva cada vez que entran al sitio.

3. Configura el widget en Nuvlyx

   En el admin de tu tienda ve a Integraciones → pestaña “Chatwoot (Live Chat)”.

   Verás el card Live Chat — Chatwoot con tres campos:

   • URL base de Chatwoot — la URL donde está tu instancia (ej: https://chat.miempresa.com o https://app.chatwoot.com)
   • Website Token — el token público que copiaste en el paso 1
   • Identity Validation Token (HMAC) — el secret del paso 2 (opcional). Si lo dejas vacío, los clientes seguirán siendo anónimos.

   Activa el toggle “Habilitar widget de chat” y guarda.

4. Verifica en tu storefront

   Abre tu storefront en otra pestaña (incógnito). Verás la burbuja de chat flotante en la esquina inferior derecha.

   • Como visitante anónimo → puedes iniciar una conversación normal
   • Logueado como cliente → tu nombre y email aparecen automáticamente en Chatwoot, y verás tus conversaciones anteriores

Cómo funciona la seguridad del Identity Validation

El HMAC secret se cifra con AES-256-GCM al guardarlo en nuestra base de datos (la clave maestra está en Vault, no en el código).

Cuando un cliente abre el chat:

1. Nuvlyx genera un HMAC-SHA256 del email del cliente usando el secret descifrado en el servidor
2. El HMAC se envía al storefront junto con el email
3. El SDK de Chatwoot lo usa para autenticar al usuario sin exponer el secret

El secret nunca toca el navegador del cliente, así que no puede ser extraído ni reusado.

Desactivar el widget

Desde Integraciones → pestaña “Chatwoot (Live Chat)”, simplemente desactiva el toggle “Habilitar widget de chat” y guarda. La burbuja desaparecerá del storefront en menos de 1 minuto (cache).

Si quieres eliminar la configuración por completo (incluyendo los tokens guardados), pulsa Eliminar integración.