> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acrity.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Solução de problemas
> Diagnostique problemas comuns com Aplicativos conectados, credenciais, conectores, API keys, webhooks, cobrança e prontidão de repositórios.
Use este guia para diagnosticar falhas comuns por conta própria. A maioria dos problemas vem de permissões do provedor, segredos expirados ou configuração que ficou desalinhada após uma rotação.
Os reviews e o seu status aparecem no [dashboard Ops](/pt-BR/guides/ops-dashboard). Para o diagnóstico por execução — incluindo por que um review específico iniciou, tentou novamente ou falhou — abra o [Audit Trail](/pt-BR/console/audit-trail).
Repositórios, Webhooks, API keys, Credenciais, Conectores e o Audit Trail exigem um admin de workspace. Esses papéis são conjuntos fixos de capacidades definidos pela Acrity, não configuráveis pela organização.
## Fluxo de triagem
```mermaid theme={null}
flowchart TD
A[Algo não está funcionando] --> B{Onde falhou?}
B -->|Login ou acesso ao repositório| C[Aplicativos conectados]
B -->|Token ou escopo do provedor| D[Credenciais]
B -->|Runner auto-hospedado| E[Conectores]
B -->|Notificação de saída| F[Webhooks de saída]
B -->|Automação de API| G[API keys]
B -->|Reviews bloqueados| H[Cobrança]
B -->|Review nunca executou| I[Repositórios]
C --> Z[Abra o Audit Trail da execução com falha]
D --> Z
E --> Z
F --> Z
G --> Z
H --> Z
I --> Z
```
## Problemas comuns
| 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 |
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 |
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** |
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 |
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 |
| 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 |
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](/pt-BR/guides/ops-dashboard) 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 |
## Quando acionar o suporte
Abra um ticket com:
* o workspace e o repositório afetados;
* o horário aproximado do problema;
* o provedor envolvido;
* um print do erro com as credenciais removidas;
* o identificador do review ou scan e o status da execução no [Audit Trail](/pt-BR/console/audit-trail) quando disponível.
Nunca envie tokens, API keys, segredos HMAC ou credenciais completas no ticket.