Troubleshooting común

Resolución de los errores más frecuentes desde el Admin SPA.

"No puedo iniciar sesión"

Síntoma	Causa probable	Acción
Redirige a Cognito y vuelve con error=...	Callback URL no registrado	Pide a plataforma agregar tu host al app client 4mr4vrvcvklm81m8gp2mb2eb72
Loop infinito de login	sessionStorage corrupto	Borra cookies del dominio + intenta en pestaña incógnito
"Access denied" después de login	Falta claim custom:tenant_id	Pide a un admin del tenant agregarte como usuario

"Mi flow no se publica"

1. Verifica que el editor no muestra errores en rojo.
2. El parity gate puede estar bloqueando si importaste desde legacy. Revisa Historial → Última ejecución de parity.
3. Si todo está verde y aún falla: revisa el log de actividad (/audit) — quizás otro usuario está editando concurrentemente.

"El widget no aparece en mi sitio"

Síntoma	Acción
Console: CORS blocked	Agrega el origen en widget → Seguridad → Allowed origins
Console: Zengine is not defined	Verifica que el <script> carga (Network tab)
Burbuja aparece pero panel vacío	Flow inicial no publicado o eliminado

"WhatsApp no envía"

1. Template debe estar en estado approved.
2. Número destino debe estar opt-in (Meta política 24h o template).
3. Revisa el dashboard de Errores por strategy en reportes.
4. Detalle por mensaje en /conversations/{id} → tab Eventos.

"Handoff a Five9 no llega al agente"

1. Verifica que hay agentes con skill habilitado.
2. Revisa que el campo domain del strategy five9-digital apunta al tenant correcto (config en Secrets Manager — abrir ticket de plataforma).
3. Dashboard de Conversaciones → Handoffs muestra estado por intento.

"Los reportes muestran datos viejos"

El read-model se actualiza vía eventos EventBridge → reporting-api con delay típico de 30–60s. Si lleva >5 min:

1. Verifica el dashboard Eventos (errores de proyección).
2. Si persiste: abre ticket de plataforma (probable lag en SQS DLQ).

Cuándo escalar a plataforma

Si nada de lo anterior aplica o ves errores 5xx persistentes (>5 min): abre ticket al equipo de plataforma. Adjunta:

• URL exacta donde ocurre.
• correlation_id visible en la consola del navegador (header x-correlation-id en cualquier response 4xx/5xx).
• Captura del error.
• Hora aproximada (UTC).