Solução de problemas

Aplicativos conectados

Sintoma	Causa provável	Ação
Callback ou autorização falha	URL de callback incorreta ou app criado no ambiente errado	Confira a URL de callback exibida pela sua instalação da Acrity e atualize o app no provedor
Instalação aparece inválida	Permissão removida ou token revogado	Use Reautorizar em Aplicativos conectados
Repositório não aparece	App não foi instalado naquele repositório ou organização	Ajuste a instalação no provedor e sincronize novamente
Comentários do PM não são publicados	A integração de PM não está vinculada ao repositório ou perdeu permissão	Revise o vínculo na página de detalhe do repositório

Credenciais

Gerenciar credenciais exige um admin de workspace.

Sintoma	Causa provável	Ação
Credencial inválida	Token expirado, revogado ou com permissão insuficiente	Edite ou rotacione a credencial e use Validar
Repositório sem prontidão	Falta uma credencial de VCS ou PM	Abra a página de detalhe do repositório e vincule as credenciais
Provedor retorna permissão negada	Escopo insuficiente no provedor	Atualize as permissões no provedor e valide novamente

Conectores

Gerenciar conectores exige um admin de workspace.

Sintoma	Causa provável	Ação
Conector offline	Serviço parado, rede bloqueada ou token rotacionado	Verifique o serviço local, o proxy e os segredos instalados e execute Revalidar
Repositórios privados não aparecem	Token local sem permissão ou URL da instância incorreta	Revise a configuração local e execute Revalidar
Erro de TLS ou certificado	Proxy corporativo ou CA não confiável	Configure a cadeia de certificados exigida pela sua empresa
Revalidação falha após rotação	O novo segredo não foi aplicado no host	Atualize o cofre ou ambiente local, reinicie o conector e execute Revalidar

Webhooks de saída

Gerenciar webhooks exige um admin de workspace.

Sintoma	Causa provável	Ação
`401` ou `403` no destino	Token ou header do destino inválido	Atualize os headers secretos no webhook
Assinatura inválida	Segredo HMAC diferente entre a Acrity e o receptor	Rotacione o segredo e teste novamente
Timeout	Destino lento ou indisponível	Teste a URL fora da Acrity e revise o timeout do receptor
Payload rejeitado	Modelo incompatível com o destino	Use a prévia e teste antes de ativar

API keys

Gerenciar API keys exige um admin de workspace.

Sintoma	Causa provável	Ação
`401`	Key ausente, inválida, expirada ou inativa	Confirme o header `X-Acrity-Key`, a validade e o estado da key
`403`	Escopo insuficiente	Adicione o escopo necessário ou crie uma nova key
`429`	Limite de uso atingido	Aplique backoff e reduza a concorrência
Integração parou após rotação	O segredo antigo ainda está em uso	Atualize o cofre e reinicie a automação

Cobrança

Sintoma	Causa provável	Ação
Reviews bloqueados pela cobrança	Trial encerrado, saldo da wallet insuficiente ou teto de gasto atingido	Acesse Cobrança para recarregar a wallet ou ajustar o teto de gasto. Mudanças de plano são tratadas pela Acrity — entre em contato com o suporte
Portal de pagamento não abre	Sua função não pode gerenciar cobrança	Peça a um admin de workspace ou Billing Manager para concluir o pagamento
Recarga não aparece	Pagamento pendente ou falhou	Confira o histórico da wallet e o método de pagamento

Repositórios

Gerenciar repositórios exige um admin de workspace.

Sintoma	Causa provável	Ação
Review não inicia	Webhook não configurado, repositório pausado ou uma regra de branch ignora a mudança	Revise a página de detalhe do repositório e confirme no dashboard Ops se o review foi enfileirado
Comentário não aparece no PR ou MR	Publicação de resultado desativada ou permissão insuficiente	Valide a credencial e os status/checks no provedor
Resultado aparece em um idioma inesperado	Override de idioma no repositório ou workspace	Revise a configuração de idioma no workspace e na página de detalhe do repositório
Bootstrap indisponível	Repositório não elegível ou configuração incompleta	Abra a aba Bootstrap e siga a orientação exibida

Fluxo de triagem