Notion como base de conhecimento do Capitão IA
Muitas empresas já utilizam o Notion como repositório central de procedimentos, FAQs e documentação interna. A integração nativa com o Notion evita duplicar esforço: as páginas continuam sendo escritas e organizadas no Notion, e o Capitão IA passa a consumi-las como base de conhecimento para responder clientes e auxiliar atendentes.
Conectando o workspace Notion
A integração é feita pelo administrador, em Configurações → Integrações → Notion:
- Clique em Conectar com o Notion. Você é redirecionado para o fluxo OAuth oficial do Notion.
- Faça login na sua conta e, na tela de autorização do Notion, selecione quais páginas e bancos de dados o app pode acessar. Recomendamos liberar apenas a área específica de "Base de Conhecimento", e não o workspace inteiro.
- Confirme a autorização. O Notion devolve um token de integração que fica armazenado de forma criptografada na conta.
A integração respeita as permissões do Notion: páginas que não foram explicitamente compartilhadas com a integração não são acessadas. Isso é uma decisão de segurança do próprio Notion — qualquer ampliação do escopo precisa ser feita pelo administrador do workspace dentro do Notion.
Como o conteúdo é consumido
Após a conexão, o Capitão IA pode ler as páginas autorizadas como fonte de conhecimento. Em Capitão IA → Bases de conhecimento, o administrador adiciona o Notion como fonte e seleciona o escopo entre:
- Páginas individuais.
- Subpáginas (recursivamente, dentro de uma raiz autorizada).
- Bancos de dados inteiros.
Cada página passa a alimentar o índice semântico do Capitão IA, que recupera o conteúdo relevante quando uma pergunta de cliente ou atendente é semelhante ao que está documentado. O metadado de origem (URL no Notion e data de última edição) fica associado, o que permite rastrear de onde veio a resposta.
Sincronização
A leitura é feita em duas situações:
| Tipo | Quando ocorre |
|---|---|
| Indexação inicial | Ao adicionar uma fonte do Notion |
| Atualização programada | De forma periódica em segundo plano |
| Sincronização manual | Botão Sincronizar agora na fonte |
Se você acabou de publicar uma alteração crítica no Notion e precisa que o Capitão IA reflita imediatamente, use a sincronização manual. O processo costuma terminar em poucos segundos para páginas individuais e alguns minutos para árvores grandes.
Mantendo o Notion como fonte única de verdade
A maior vantagem da integração é tratar o Notion como SSOT (Single Source of Truth). Em vez de manter uma base paralela e arriscar divergência, a equipe edita só no Notion. Algumas recomendações:
- Crie uma área específica chamada "Base Pública" ou "Atendimento" no Notion para tudo que será consumido pelo Capitão IA.
- Use uma propriedade
Status(Rascunho, Revisão, Publicado) e estabeleça como prática só publicar para a área autorizada o conteúdo já aprovado. - Mantenha um responsável pela revisão trimestral, removendo páginas obsoletas do escopo da integração.
- Evite imagens com texto não selecionável; o Capitão IA não extrai conteúdo de imagens.
Atenção: se uma página estiver fora do escopo autorizado da integração no Notion, ela simplesmente não existe do ponto de vista do Capitão IA — comportamento esperado para evitar respostas com base em conteúdo confidencial ou ainda em revisão.
O que NÃO autorizar
Algumas categorias de conteúdo Notion devem ficar fora do escopo da integração:
- Documentos confidenciais (contratos, salários, planejamento estratégico).
- Anotações pessoais de colaboradores.
- Páginas com decisões internas que ainda não devem chegar ao cliente.
- Bancos de dados volumosos com itens irrelevantes para atendimento.
Lembre-se de que tudo que estiver autorizado pode ser usado como contexto pelo Capitão IA — incluindo, eventualmente, em respostas a clientes finais.
Desconectando
Em Configurações → Integrações → Notion, o botão Desconectar remove a vinculação. Após a desconexão:
- O Capitão IA deixa de utilizar conteúdo do Notion como fonte.
- A indexação local é descartada na próxima rotina de limpeza.
- A revogação completa do token deve ser feita também no Notion, em Settings → Connections, para garantir que a aplicação não conste mais como autorizada.
Próximos passos
Com o Notion conectado, vale revisar a configuração do Capitão IA para ajustar tom, idiomas e fallback. Para outras integrações de produtividade, veja Slack e Linear.