> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/pt/troubleshooting.md).

# Resolução de problemas

Comece aqui quando algo não estiver funcionando. Siga estes passos para identificar o seu problema e ir para a página de resolução relevante.

## Antes de começar

Se **vários usuários relatarem o mesmo problema ao mesmo tempo**, ou se os logs de depuração do KONNEKT mostrarem erros da Graph API (HTTP 429, 500, 503, 504, ou `UnknownError`), a causa raiz pode estar no backend do Microsoft 365 em vez de no KONNEKT. Confirme isso primeiro: [Reproduza problemas de arquivos com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).

## Qual é o problema?

### As unidades ou compartilhamentos do KONNEKT não estão visíveis

1. **O KONNEKT está instalado?**
   * Verifique: `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * Não instalado → [Instale o KONNEKT](https://docs.konnekt.io/installation/setup)
   * Em dispositivos ARM64, certifique-se de que instalou a versão ARM64. Uma instalação x64 em ARM64 parecerá bem-sucedida, mas o driver não conseguirá carregar. → [Falha ao abrir o dispositivo](https://docs.konnekt.io/troubleshooting/failed-to-open-device)
2. **O dispositivo foi reiniciado após a instalação?**
   * O KONNEKT requer uma reinicialização para carregar seu driver em modo kernel. Reinicie e verifique novamente.
3. **O serviço do KONNEKT está em execução?**
   * Verifique: `Get-Service -Name "Konnekt*"`
   * Não está em execução → reinicie o serviço ou reinstale.
4. **O usuário está conectado?**
   * Clique com o botão direito no ícone da bandeja do KONNEKT → **Contas**. Se nenhuma conta estiver listada, faça login.
   * "É necessária aprovação do administrador" → [Conceda consentimento de administrador para todo o Tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **A unidade ou compartilhamento está visível, mas clicar não faz nada?**
   * → [Clicar em um compartilhamento não faz nada](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Sites ou bibliotecas estão ausentes

1. **Usando mapeamento automático?**
   * Verifique se `O365SharepointUsage = 1` no registro.
   * Verifique se o usuário tem acesso ao site na interface web do SharePoint.
   * Verifique a consulta KQL do site - uma consulta restritiva pode excluir o site. Veja [Mapeamento automático](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Verifique a associação do usuário ao grupo do Microsoft Entra ID se os sites forem filtrados por grupo.
   * Proprietário do site, mas não membro? A descoberta do KONNEKT encontra apenas sites dos quais o usuário é **membro** de. → [Alguns sites ou bibliotecas não aparecem no KONNEKT](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)
2. **Usando mapeamentos gerenciados?**
   * Verifique se a `SharepointSites` política está aplicada: `gpresult /r` ou verifique o registro.
   * Verifique se a URL do SharePoint na política está correta e acessível.
3. **Tentando adicionar um compartilhamento manualmente e recebendo "Falha ao abrir o site: chave não encontrada"?**
   * → [Adicionar compartilhamento: "Chave não encontrada"](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **O site existe no SharePoint, mas não no KONNEKT?**
   * O usuário pode não ter permissão para o site. Teste o acesso pela interface web do SharePoint.
   * O tipo de site pode não corresponder à consulta KQL (por exemplo, sites pessoais do OneDrive não são descobertos pela consulta padrão).

→ [Sites ausentes ou pastas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) | [Alguns sites ou bibliotecas não aparecem](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)

### As pastas estão vazias

1. **Todas as bibliotecas estão vazias?**
   * Talvez o consentimento do administrador não tenha sido concedido, ou as permissões da API estejam incompletas.
   * → [Conceda consentimento de administrador para todo o Tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
   * → [Bibliotecas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries)
2. **Alguma biblioteca específica está vazia?**
   * O usuário pode não ter permissão para o conteúdo da biblioteca. Verifique as permissões do SharePoint.
   * A biblioteca pode realmente estar vazia.
3. **O mapeamento gerenciado mostra uma pasta vazia?**
   * A URL do site na política pode estar incorreta. Verifique-a abrindo a URL em um navegador.

→ [Bibliotecas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries) | [Sites ausentes ou pastas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Erros de autenticação

1. **"Falha ao obter token de acesso"**
   * → [Problemas com token de acesso](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **Loop de solicitação de MFA (solicitações de MFA repetidas)**
   * Conflito de política do Conditional Access ou problema no broker WAM.
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **Conta errada conectada**
   * Clique com o botão direito no ícone da bandeja → **Contas** → remova a conta errada → adicione a conta correta.
4. **"É necessária aprovação do administrador"**
   * → [Conceda consentimento de administrador para todo o Tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

→ [Problemas com token de acesso](https://docs.konnekt.io/troubleshooting/access-token-issues)

### Erros de operação de arquivo

1. **Falha no envio**
   * Verifique os detalhes do erro pelo ícone da bandeja → **Erros**.
   * Verifique a conectividade de rede.
   * Verifique se está ocorrendo limitação de taxa no SharePoint (procure HTTP 429 nos logs de depuração). Se você vir limitação de taxa ou erros do backend, [reproduza com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar problemas do lado da Microsoft.
   * → [Como lidar com erro(s)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Arquivo bloqueado / somente leitura inesperadamente**
   * Outro usuário pode ter o arquivo aberto sem a coautoria ativada.
   * O arquivo pode exceder o limite de tamanho para somente leitura. → [Limites de tamanho para abertura de arquivos](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **Permissão negada**
   * O usuário não tem permissão de gravação no SharePoint. Verifique pela interface web.
4. **"Caminho muito longo" ou erros de nome de arquivo**
   * Verifique o comprimento do caminho e do nome do arquivo em relação aos limites. → [Qual é o comprimento máximo do caminho e do nome do arquivo?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [Como lidar com erro(s)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### A abertura de arquivos do Office falha

1. **Office exibe um aviso ao abrir ("pode prejudicar seu computador")**
   * A Marcação da Web (MOTW) é aplicada a arquivos de locais de rede. → [A abertura de documentos do MS Office exibe uma mensagem de aviso](https://docs.konnekt.io/troubleshooting/opening-ms-office-documents-displays-a-warning-message)
   * Frequentemente resolvido adicionando os caminhos do KONNEKT aos sites confiáveis. → [Adicione os caminhos do KONNEKT como sites confiáveis](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
2. **Dar duplo clique em um arquivo do Office não faz nada ou arquivos de macro do Excel não abrem**
   * Os caminhos do KONNEKT precisam estar na zona de Sites confiáveis. → [Adicione os caminhos do KONNEKT como sites confiáveis](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
3. **O KONNEKT trava ao abrir ou pré-visualizar arquivos do Office**
   * As regras de Attack Surface Reduction (ASR) podem estar bloqueando o KONNEKT. Exclua `Konnekt.exe` e `KonnektStarter.exe` da regra ASR "Office Child Process". → [Ação arriscada bloqueada](https://docs.konnekt.io/troubleshooting/risky-action-blocked)
4. **Office mostra uma versão desatualizada de um arquivo**
   * → [Office mostra versões desatualizadas](https://docs.konnekt.io/troubleshooting/office-shows-outdated-versions)

### Problemas de desempenho

1. **Navegação lenta pelas pastas**
   * Verifique a contagem de itens na pasta (>1.000 itens tornam a navegação lenta).
   * Verifique as configurações de cache - um TTL muito baixo causa mais chamadas à API.
   * Se a lentidão estiver correlacionada com erros 429 ou 5xx da Graph API no log de depuração, [reproduza com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar limitação de taxa ou problemas do backend.
2. **Abertura lenta de arquivos**
   * Verifique o tamanho do arquivo e a largura de banda da rede.
   * Verifique se há limitação de taxa (HTTP 429 nos logs). Se houver, [reproduza com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **Lentidão intermitente (especialmente de manhã)**
   * Provavelmente o antivírus está verificando as unidades do KONNEKT.
   * → [Desempenho lento ou erros causados pela verificação do antivírus](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Outros problemas

| Problema                                       | Resolução                                                                                                                                                                                                                                                                   |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pré-visualização de PDF com falha (Windows 11) | → [Pré-visualização de PDF com falha após a atualização do Windows 11](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                                                                  |
| X cinza nos arquivos                           | Comportamento esperado - o KONNEKT marca os arquivos como `FILE_ATTRIBUTE_OFFLINE` para economizar largura de banda. Não é um erro. Veja [Por que há um X cinza ou uma mala marrom](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). |
| Sobreposição de mala marrom nos arquivos       | O arquivo está marcado para uso offline. Comportamento esperado.                                                                                                                                                                                                            |
| Ícone da bandeja do KONNEKT ausente            | Reinicie o dispositivo. Se ainda estiver ausente, reinstale o KONNEKT.                                                                                                                                                                                                      |
| Não consegue resolver o problema               | → [Prepare os logs de depuração](https://docs.konnekt.io/troubleshooting/debug-log-preparation) e [contate o suporte](https://docs.konnekt.io/support)                                                                                                                      |

## Páginas relacionadas

* [Reproduza problemas de arquivos com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) - isolar problemas do KONNEKT de problemas do backend do Microsoft 365
* [Registro de alterações](https://docs.konnekt.io/changelog) - correções recentes e problemas resolvidos
* [Preparação dos logs de depuração](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - como coletar logs para o suporte
* [Suporte](https://docs.konnekt.io/support) - como contatar o suporte do KONNEKT


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.konnekt.io/pt/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.