Gestionar widgets

Un widget es la configuración visible del chat embebido: tema, copy, canales habilitados, flow asociado.

Listado

/widgets lista los widgets del tenant. Un tenant puede tener múltiples widgets (uno por sitio, por marca, etc.).

Crear widget

1. Clic + Nuevo widget.
2. Asigna nombre y widgetId (slug usado por el snippet de embed).
3. Selecciona el flow inicial que arranca al abrir el chat.

Pestañas de edición

Tema

• Colores primario, secundario, fondo del panel.
• Avatar (URL o subida).
• Border-radius del botón flotante.
• Posición: bottom-right (default), bottom-left.

Preview en vivo en el panel derecho.

Copy

• Saludo inicial.
• Placeholder del input.
• Mensaje de error de conexión.
• Disclaimer de privacidad (link a tu propia política).

Canales

Habilita/deshabilita por widget:

• WebChat (default).
• WhatsApp (vía Meta Cloud o 360dialog).
• Email (SES).
• SMS (SNS).

Si habilitas WhatsApp aquí, el número/template debe estar previamente provisionado por el equipo de plataforma.

Seguridad

• Allowed origins: lista CORS de dominios donde puede embeberse el widget. * está prohibido.
• Rate limit: mensajes/minuto por sesión. Default: 30.

Publicar

Botón Publicar. Genera un snippet listo para copiar:

<script src="https://cdn.zen.zervizdev.com/widget.js" defer></script>
<script>
  window.addEventListener('load', () => {
    Zengine.init({
      tenantId: 'iplacex-demo',
      widgetId: 'sitio-principal-v2'
    });
  });
</script>

Spec completa de opciones en Embed del widget.

Cambiar tema sin redeploy

El widget descarga config.json desde el CDN al iniciar. Cambios de tema/copy se reflejan sin que el sitio cliente reemplace el snippet, con un TTL de 5 minutos en CloudFront. Para forzar refresh inmediato: botón Invalidar caché (requiere rol admin).