Solución de problemas

Aplicaciones conectadas

Síntoma	Causa probable	Acción
El callback o la autorización falla	URL de callback incorrecta o app creada en el entorno equivocado	Revisa la URL de callback que muestra tu instalación de Acrity y actualiza la app en el proveedor
La instalación aparece inválida	Permiso removido o token revocado	Usa Reautorizar en Aplicaciones conectadas
El repositorio no aparece	La app no se instaló en ese repositorio u organización	Ajusta la instalación en el proveedor y vuelve a sincronizar
Los comentarios de PM no se publican	La integración de PM no está vinculada al repositorio o perdió el permiso	Revisa el vínculo en la página de detalle del repositorio

Credenciales

Gestionar credenciales requiere un Admin de workspace.

Síntoma	Causa probable	Acción
Credencial inválida	Token expirado, revocado o con permiso insuficiente	Edita o rota la credencial y usa Validar
El repositorio no tiene readiness	Falta una credencial de VCS o PM	Abre la página de detalle del repositorio y vincula las credenciales
El proveedor devuelve permiso denegado	Alcance insuficiente en el proveedor	Actualiza los permisos en el proveedor y valida de nuevo

Connectors

Gestionar connectors requiere un Admin de workspace.

Síntoma	Causa probable	Acción
Connector offline	Servicio detenido, red bloqueada o token rotado	Verifica el servicio local, el proxy y los secretos instalados, luego Revalidate
Los repositorios privados no aparecen	El token local no tiene permiso o la URL de la instancia es incorrecta	Revisa la configuración local y ejecuta Revalidate
Error de TLS o certificado	Proxy corporativo o CA no confiable	Configura la cadena de certificados que exige tu empresa
La revalidación falla después de la rotación	El secreto nuevo no se aplicó en el host	Actualiza el cofre o el entorno local, reinicia el connector, luego Revalidate

Webhooks outbound

Gestionar webhooks requiere un Admin de workspace.

Síntoma	Causa probable	Acción
`401` o `403` en el destino	Token o header del destino inválido	Actualiza los headers secretos en el webhook
Firma inválida	Secreto HMAC diferente entre Acrity y el receptor	Rota el secreto y prueba de nuevo
Timeout	El destino es lento o no está disponible	Prueba la URL fuera de Acrity y revisa el timeout del receptor
Payload rechazado	Plantilla incompatible con el destino	Usa la vista previa y prueba antes de activar

API keys

Gestionar API keys requiere un Admin de workspace.

Síntoma	Causa probable	Acción
`401`	Key ausente, inválida, expirada o inactiva	Confirma el header `X-Acrity-Key`, la vigencia y el estado de la key
`403`	Alcance insuficiente	Agrega el alcance necesario o crea una nueva key
`429`	Límite de uso alcanzado	Aplica backoff y reduce la concurrencia
La integración se detuvo tras la rotación	El secreto antiguo todavía está en uso	Actualiza el cofre y reinicia la automatización

Facturación

Síntoma	Causa probable	Acción
Revisiones bloqueadas por facturación	Trial finalizado, saldo del wallet insuficiente o límite de gasto alcanzado	Abre Facturación para recargar el wallet o ajustar el límite de gasto. Los cambios de plan los gestiona Acrity — contacta a soporte
El portal de pago no abre	Tu rol no puede gestionar la facturación	Pide a un Admin de workspace o Billing Manager que complete el pago
La recarga no aparece	El pago está pendiente o falló	Revisa el historial del wallet y el método de pago

Repositorios

Gestionar repositorios requiere un Admin de workspace.

Síntoma	Causa probable	Acción
La revisión no inicia	Webhook no configurado, repositorio pausado o una regla de branch ignora el cambio	Revisa la página de detalle del repositorio, luego confirma en el dashboard Ops si la revisión se encoló
El comentario no aparece en el PR o MR	Publicación de resultados desactivada o permiso insuficiente	Valida la credencial y los statuses/checks en el proveedor
El resultado aparece en un idioma inesperado	Override de idioma en el repositorio o el workspace	Revisa la configuración de idioma en el workspace y en la página de detalle del repositorio
Bootstrap no disponible	El repositorio no es elegible o la configuración está incompleta	Abre la pestaña Bootstrap y sigue la orientación mostrada

Flujo de triaje