Diagnóstico rápido
Empieza por identificar si el problema pertenece a sesión, tenant, permisos, credenciales, proveedor o infraestructura.
Método de diagnóstico
ReproducirAnota usuario, tenant, hora, módulo y acción.
Revisar interfazCaptura el mensaje y estado mostrado.
Revisar redConsulta código HTTP y respuesta.
Revisar logsBusca el mismo timestamp.
Validar permisosRol y pertenencia al tenant.
Validar proveedorToken, scopes, estado y cuotas.
Aplicar correcciónPrueba en un tenant de control.
Problemas frecuentes
| Problema | Causa probable | Acción |
|---|---|---|
| La IA no responde | Agente inactivo, clave o límite | Probar agente y revisar consumo |
| OAuth regresa con error | Callback o scope incorrecto | Revisar URL exacta y permisos |
| Publicación fallida | Formato, URL multimedia o permiso | Abrir detalle del intento |
| Métricas en cero | Proveedor no entrega o falta scope | Revisar sincronización y permisos |
| Usuario ve poco | Rol o plan limitado | Revisar entitlements |
| Datos entre empresas | Fallo crítico de tenant | Suspender operación y auditar consulta |
| Se pierde sesión tras reinicio | Disco no persistente | Revisar montaje y DATABASE_DSN |
Información para soporte
- Versión (`VERSION.txt`).
- Fecha y zona horaria.
- Rol y tipo de cuenta.
- Canal o red.
- ID público o URL de la publicación, nunca el token.
- Mensaje de error y pasos para reproducir.
