ZEngine Platform — Manual¶

Bienvenido al manual operativo de ZEngine v2, la plataforma multi-tenant event-driven de Zerviz Group para integración de canales digitales (WhatsApp, webchat, email, SMS) con contact centers (Five9, Amazon Connect).

Esta documentación está organizada por audiencia. Elige la sección que mejor describe tu rol.

Audiencias¶

:material-account: Usuarios finales

Visitantes que interactúan con el widget de chat embebido en sitios de clientes. Cómo abrir el chat, qué esperar, política de datos.

Ir a la sección Usuarios
:material-shield-account: Administradores

Operadores de tenant: crean flows, publican widgets, gestionan templates y consultan reportes desde el Admin SPA.

Ir a la sección Administradores
:material-code-tags: Integradores

Desarrolladores que embeden el widget, llamen a la API REST o consuman eventos vía webhook.

Ir a la sección Integradores
:material-wrench: Desarrolladores

Mantenedores de la plataforma. Arquitectura, ADRs, CI/CD, setup local y runbooks operacionales.

Ir a la sección Desarrolladores

Estado de la plataforma (snapshot)¶

Item	Valor
Versión	V1.1
Cuenta AWS	`450972188274`
Región principal	`us-east-2`
Región ACM/edge	`us-east-1`
Lambdas en producción	11
Strategies activas	7 (whatsapp-meta-cloud, whatsapp-360dialog, webchat-http, five9-digital, ses-email, sns-sms, amazon-connect-chat)
ADRs publicados	14
Tests unitarios	400 verdes

Endpoints públicos¶

Servicio	URL
Widget CDN	`https://cdn.zen.zervizdev.com/widget.js`
Admin SPA	`https://admin.dev.zen.zervizdev.com/`
Auth SPA (Cognito PKCE)	`https://auth.dev.zen.zervizdev.com/login.html`
Docs (este sitio)	`https://docs.dev.zen.zervizdev.com`
API tenant-mgmt	`https://1zwzz5s116.execute-api.us-east-2.amazonaws.com`
API flow-engine	`https://xkj1y85c7c.execute-api.us-east-2.amazonaws.com`
API inbound-router	`https://eqeloz3trh.execute-api.us-east-2.amazonaws.com`

Cómo está construida esta documentación¶

MkDocs Material con búsqueda en español, modo oscuro y diagramas Mermaid.
Versionado opcional con mike (no forzado en V1).
Publicada desde docs/manual/ a CloudFront vía workflow cd-dev.yml.
Fuente canónica de decisiones: los 14 ADRs bajo docs/adr/. Este manual cross-linkea, no duplica.