Integradores

Esta sección es para desarrolladores que embeden el widget en un sitio, llaman a la API REST o consumen eventos desde ZEngine.

Contenido

• Embed del widget — snippet, opciones, eventos.
• Personalizar tema — overrides CSS y configuración remota.
• API webchat REST — POST /v1/webchat/messages.
• Eventos y webhooks — eventos EventBridge expuestos.
• Autenticación JWT — cómo obtener un token para APIs admin.

Pre-requisitos

• Tenant provisionado y un tenantId válido (lo entrega el admin del tenant).
• Para APIs admin: usuario en Cognito con permisos.
• Para webhooks: registrar tu URL en /integrations/webhooks (Admin SPA).

Sandbox

El entorno dev (https://*.dev.zen.zervizdev.com) es estable y apto para integración. No usar para producción real. Endpoints qa y prod se publicarán según roadmap.