Saltar al contenido principal
Usa esta guía para diagnosticar fallas comunes por tu cuenta. La mayoría de los problemas provienen de permisos del proveedor, secretos expirados o configuración que quedó desalineada después de una rotación. Las revisiones y su estado aparecen en el dashboard Ops. Para diagnósticos por ejecución —incluyendo por qué una revisión específica se inició, se reintentó o falló— abre el Audit Trail.
Repositorios, Webhooks, API keys, Credenciales, Connectors y el Audit Trail requieren un Admin de workspace (los administradores de plataforma también tienen acceso). Estos roles son conjuntos de capacidades fijos definidos por Acrity, no configurables por la organización.

​
Flujo de triaje

​
Problemas comunes

SíntomaCausa probableAcción
El callback o la autorización fallaURL de callback incorrecta o app creada en el entorno equivocadoRevisa la URL de callback que muestra tu instalación de Acrity y actualiza la app en el proveedor
La instalación aparece inválidaPermiso removido o token revocadoUsa Reautorizar en Aplicaciones conectadas
El repositorio no apareceLa app no se instaló en ese repositorio u organizaciónAjusta la instalación en el proveedor y vuelve a sincronizar
Los comentarios de PM no se publicanLa integración de PM no está vinculada al repositorio o perdió el permisoRevisa el vínculo en la página de detalle del repositorio
Gestionar credenciales requiere un Admin de workspace.
SíntomaCausa probableAcción
Credencial inválidaToken expirado, revocado o con permiso insuficienteEdita o rota la credencial y usa Validar
El repositorio no tiene readinessFalta una credencial de VCS o PMAbre la página de detalle del repositorio y vincula las credenciales
El proveedor devuelve permiso denegadoAlcance insuficiente en el proveedorActualiza los permisos en el proveedor y valida de nuevo
Gestionar connectors requiere un Admin de workspace.
SíntomaCausa probableAcción
Connector offlineServicio detenido, red bloqueada o token rotadoVerifica el servicio local, el proxy y los secretos instalados, luego Revalidate
Los repositorios privados no aparecenEl token local no tiene permiso o la URL de la instancia es incorrectaRevisa la configuración local y ejecuta Revalidate
Error de TLS o certificadoProxy corporativo o CA no confiableConfigura la cadena de certificados que exige tu empresa
La revalidación falla después de la rotaciónEl secreto nuevo no se aplicó en el hostActualiza el cofre o el entorno local, reinicia el connector, luego Revalidate
Gestionar webhooks requiere un Admin de workspace.
SíntomaCausa probableAcción
401 o 403 en el destinoToken o header del destino inválidoActualiza los headers secretos en el webhook
Firma inválidaSecreto HMAC diferente entre Acrity y el receptorRota el secreto y prueba de nuevo
TimeoutEl destino es lento o no está disponiblePrueba la URL fuera de Acrity y revisa el timeout del receptor
Payload rechazadoPlantilla incompatible con el destinoUsa la vista previa y prueba antes de activar
Gestionar API keys requiere un Admin de workspace.
SíntomaCausa probableAcción
401Key ausente, inválida, expirada o inactivaConfirma el header X-Acrity-Key, la vigencia y el estado de la key
403Alcance insuficienteAgrega el alcance necesario o crea una nueva key
429Límite de uso alcanzadoAplica backoff y reduce la concurrencia
La integración se detuvo tras la rotaciónEl secreto antiguo todavía está en usoActualiza el cofre y reinicia la automatización
SíntomaCausa probableAcción
Revisiones bloqueadas por facturaciónTrial finalizado, saldo del wallet insuficiente o límite de gasto alcanzadoAbre 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 abreTu rol no puede gestionar la facturaciónPide a un Admin de workspace o Billing Manager que complete el pago
La recarga no apareceEl pago está pendiente o fallóRevisa el historial del wallet y el método de pago
Gestionar repositorios requiere un Admin de workspace.
SíntomaCausa probableAcción
La revisión no iniciaWebhook no configurado, repositorio pausado o una regla de branch ignora el cambioRevisa 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 MRPublicación de resultados desactivada o permiso insuficienteValida la credencial y los statuses/checks en el proveedor
El resultado aparece en un idioma inesperadoOverride de idioma en el repositorio o el workspaceRevisa la configuración de idioma en el workspace y en la página de detalle del repositorio
Bootstrap no disponibleEl repositorio no es elegible o la configuración está incompletaAbre la pestaña Bootstrap y sigue la orientación mostrada

​
Cuándo contactar a soporte

Abre un ticket con:
  • el workspace y el repositorio afectados;
  • el horario aproximado del problema;
  • el proveedor involucrado;
  • una captura del error con las credenciales removidas;
  • el identificador de la revisión o scan y el estado de la ejecución del Audit Trail cuando esté disponible.
Nunca envíes tokens, API keys, secretos HMAC o credenciales completas en el ticket.