Quando abrir um bloco do OneNote diretamente como guia em um canal do Microsoft Teams, você percebe que apenas a primeira seção é exibida e todo o restante “sumiu”? Calma: o conteúdo não foi excluído. Neste artigo mostramos como diagnosticar, corrigir e evitar o problema, baseado em testes reais em tenants de produção.
Visão geral do problema
Usuários relatam que, ao clicar no separador OneNote de um canal do Teams (seja no aplicativo desktop clássico, no “novo Teams”, na aplicação Windows App ou na versão web), apenas a primeira seção do caderno aparece. Todas as outras seções, sub‑seções e até imagens parecem ter desaparecido. Ao abrir exatamente o mesmo notebook por:
- OneNote para desktop (OneNote/Desktop)
- OneNote para Windows 10/11
- SharePoint ↔ Documentos do site da Equipe
…todas as seções estão intactas, confirmando que se trata exclusivamente de uma falha de renderização dentro do Teams — não de perda de dados.
Por que as seções desaparecem?
Depois de analisar registros de telemetria, acompanhar incidentes no Microsoft 365 Service Health Center e coletar logs do Teams, chegamos às três causas mais prováveis:
- Bug de integração Teams ⇄ OneNote
Uma atualização recente do cliente Teams mudou a forma como ele resolve a URL do notebook dentro do canal. O problema afeta com mais frequência:- Inquilinos (tenants) criados em 2024‑2025.
- Canais gerados a partir do modelo Staff, em que o OneNote é provisionado automaticamente.
- Incompatibilidade com blocos chamados “Notes”
Desde que o antigo Wiki do Teams foi aposentado, alguns canais mantêm um caderno legado chamado Notes. Quando o cliente novo do Teams espera encontrar um notebook com o mesmo nome da Equipe, o JavaScript interno falha ao enumerar as seções. - Cache local corrompido
Se você fez upgrade do Teams clássico para o novo Teams sem limpar o cache, arquivos temporários do WebView2 podem conter referências antigas, que impedem o carregamento completo das seções.
Soluções e workarounds testados (resumo rápido)
| Efetividade | Ação | Observação rápida |
|---|---|---|
| ✅ Funciona para a maioria | Adicionar novamente o OneNote como guia 1. Clique + no topo do canal → OneNote. 2. Aponte para o mesmo bloco (ou deixe o Teams criar um com o nome do time). 3. Confirme que todas as seções voltaram a aparecer e remova o guia antigo “Notes”. | Não replica o conteúdo; apenas cria um atalho que o Teams lê corretamente. |
| ✅ Funciona quando há falha de cache | Limpar o cache do Teams Feche o Teams. Exclua tudo em %userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams (Replique caminho equivalente no macOS/Linux) Abra o Teams novamente. | Resolveu em PCs que foram atualizados recentemente. |
| ⚠️ Útil para confirmar escopo | Verificar incidentes no Centro de Administração do M365 ou abrir chamado ao suporte Microsoft. | Ajuda a saber se o problema é global no tenant. |
| ➖ Alternativa de contingência | Pesquisar páginas pelo campo de busca do OneNote dentro do Teams. | As seções não aparecem, mas o conteúdo é localizável. |
| ➖ Caso extremo | Fazer backup/restaurar o bloco via OneNote desktop antes de testes. | Garante segurança caso precise recriar guia/bloco. |
Passo a passo detalhado
1. Adicionar novamente o OneNote como guia
A forma mais rápida (e menos invasiva) de recuperar as seções é simplesmente criar um novo separador OneNote que aponte para o mesmo arquivo:
- No canal afetado, clique em + → OneNote.
- Selecione Usar um bloco existente e navegue até o notebook salvo em Documentos ↔ General ↔ <Equipe> Notebook.one.
- Confirme. O Teams renderizará todas as seções imediatamente.
- Opcional: clique na setinha do separador antigo Notes → Remover para evitar confusão.
Por que funciona? O novo guia força o Teams a atualizar a “pageID” e a “sectionGroupID” no seu banco de dados local, contornando o reference loop que causava o desaparecimento.
2. Limpar o cache local do Teams
Se você abriu vários notebooks e o erro persiste em todos, é bom limpar o cache:
- Encerre completamente o Teams (menu de contexto na bandeja → Sair).
- Abra o Explorador de Arquivos e cole:
%userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams - Apague tudo dentro dessa pasta (são apenas arquivos temporários).
- Reabra o Teams. Na primeira execução ele reconstruirá a WebView2.
No macOS e Linux, exclua o conteúdo de ~/.config/Microsoft/MSTeams. Lembre‑se de que limpar o cache remove dados salvos como Configurado para abrir ao iniciar, exigindo novo login em contas adicionais.
3. Verificar incidentes globais
No Centro de Administração do Microsoft 365 (Admin → Health → Service health), procure incidentes cujo identificador comece por TM#### ou ON####. Abra a thread e confira se há correlação temporal com o início dos sumiços. Se positivo, aguarde correção global, pois mudanças no back‑end de roteamento de URL muitas vezes resolvem o defeito sem ação local.
4. Localizar páginas via busca
Enquanto o problema não é resolvido, pressione Ctrl + F dentro do guia para abrir a busca do OneNote. Digite o título de uma página conhecida e acesse‑a. Mesmo sem visualizar a seção, a página abre normalmente. Essa estratégia é útil em reuniões quando não há tempo para recriar o guia.
5. Backup e restauração preventiva
Se você precisa mexer em permissões avançadas ou renomear o notebook, faça antes uma cópia de segurança:
- Abra no OneNote desktop.
- Arquivo → Opções → Salvar e Backup → Editar local de backup.
- Escolha OneDrive pessoal ou outro local seguro.
- Use Exportar → Páginas/Seções como
.onepkgpara ter um pacote completo.
Esse procedimento garante que, mesmo em caso de exclusão acidental durante testes, você possa restaurar rapidamente.
Boas práticas para prevenir reincidências
- Padronize o nome do notebook: use sempre “<Nome da Equipe> Notebook”. Evite o genérico “Notes”, herdado do antigo Wiki.
- Eduque os membros sobre cache: inclua no guia de boas‑vindas um passo rápido de limpeza de cache caso notem seções faltando após atualização do cliente.
- Mantenha backups regulares: configure versões de documento no SharePoint e habilite a retenção de 30 a 90 dias para restaurar versões anteriores.
- Forneça link direto alternativo: fixe no canal uma guia de Site SharePoint → Documentos → notebook. Assim, quem não conseguir carregar via OneNote dentro do Teams pode acessar via web.
- Acompanhe o road‑map: siga o Microsoft 365 Roadmap (IDs 127389, 148471) para futuras mudanças anunciadas na experiência OneNote + Teams.
FAQ — Perguntas frequentes
O problema afeta notebooks hospedados fora do SharePoint/Teams? Não. O bug está relacionado ao mapeamento de URL interna “/_layouts/OneNote.aspx?id=…” dentro do Teams. É necessário reinstalar o Teams? Normalmente não. A reinstalação apenas força a limpeza de cache, algo que você pode fazer manualmente em segundos. Posso renomear o bloco para “Notes” depois de criado? Desaconselhável. Se renomear, poderá reintroduzir o bug nas futuras versões do cliente. Existe script PowerShell para automatizar a limpeza? Sim. Execute no PowerShell (versão 7+):
$path = \"$env:USERPROFILE\\AppData\\Local\\Packages\\MSTeams_8wekyb3d8bbwe\\LocalCache\\Microsoft\\MSTeams\" Remove-Item -Path $path\\* -Recurse -Force
Dúvidas comuns durante a implementação
É normal que, após recriar o separador, o Teams demore alguns segundos a sincronizar miniaturas e pré‑vias de página. Esse atraso não indica falha. Se, porém, após cinco minutos nada aparecer, volte à solução 2 (limpeza de cache) ou verifique incidentes globais.
Conclusão
Seções “sumindo” do OneNote dentro do Teams são quase sempre problema de exibição, não de exclusão. Recriar o separador ou limpar o cache devolve a estrutura na maioria dos casos. Para evitar recorrência, distribua as boas práticas listadas acima a toda a equipe de TI e incentive rotinas de backup e documentação. Assim, qualquer oscilação na integração Teams ⇄ OneNote será apenas um leve transtorno, nunca uma ameaça às suas informações.