Você precisa controlar quais bots e serviços automatizados podem ler ou gravar dados no seu workspace do Notion. As integrações de bots incluem bots do Slack, conexões do Zapier, automação do GitHub e tokens de API personalizados. Este artigo explica como visualizar, adicionar e remover essas integrações pelo painel de configurações do workspace.
O Notion usa um sistema de permissões onde cada bot opera sob uma conexão específica. Sem um gerenciamento adequado, um bot pode acessar mais dados do que o pretendido ou parar de funcionar após uma alteração de token. Você aprenderá as etapas exatas para revisar todos os bots ativos, revogar o acesso de bots desatualizados e adicionar novas integrações com segurança.
Ao final, você saberá como auditar as conexões externas do seu workspace e evitar acessos não autorizados a dados. Este guia cobre o painel de configurações para planos gratuitos e pagos do Notion.
Principais Conclusões: Gerenciando Integrações de Bots nas Configurações do Workspace do Notion
- Configurações e Membros > Configurações > Integrações > Integrações do Workspace: Lista todos os bots e conexões de API ativos no seu workspace.
- Menu de três pontos > Desconectar: Remove o acesso de um bot imediatamente sem afetar outras integrações.
- Desenvolvedores ou Administradores > Gerenciar Integração: Permite gerar novos tokens de API ou alterar o escopo de permissão de um bot.
Como Funcionam as Integrações de Bots em um Workspace do Notion
Uma integração de bot é um serviço de terceiros que se conecta ao Notion usando um token de API. Cada token pertence a uma integração específica registrada em uma conta do Notion. Quando você concede acesso, o bot pode ler, criar ou atualizar páginas e bancos de dados que você compartilhou explicitamente com ele.
Os administradores do workspace controlam quais integrações existem no workspace. O painel de configurações mostra todas as integrações que foram autorizadas por qualquer membro. Você não pode ver integrações criadas por outro workspace, a menos que elas tenham sido compartilhadas com páginas específicas.
O escopo de permissão de um bot é definido quando a integração é criada. Os escopos incluem ler conteúdo, inserir conteúdo e atualizar conteúdo. Um bot não pode acessar páginas ou bancos de dados que não foram compartilhados com ele, mesmo que o token tenha escopo total. Esse modelo de permissão em duas camadas protege seus dados contra automações excessivas.
Toda integração aparece nas configurações do workspace, independentemente de quem a criou. Isso dá aos administradores uma visão central de todas as conexões externas. Você pode desconectar qualquer integração a partir deste painel, o que revoga imediatamente o token do bot.
Etapas para Visualizar e Gerenciar Integrações de Bots do Workspace
Siga estas etapas para acessar o painel de gerenciamento de integrações e realizar ações comuns.
- Abrir Configurações do Workspace
Clique no nome do workspace no canto superior esquerdo da barra lateral do Notion. Selecione Configurações e Membros no menu suspenso. O painel de configurações abre por padrão na guia Geral. - Navegar até Integrações
Na barra lateral esquerda do painel de configurações, clique em Integrações. Esta seção contém duas subseções: Integrações do Workspace e Integrações Internas. Clique em Integrações do Workspace para ver todos os bots autorizados por qualquer membro do workspace. - Revisar a Lista de Bots Ativos
A lista mostra o nome de cada integração, o usuário do Notion que a autorizou e a data em que foi adicionada. Passe o mouse sobre qualquer linha para ver o ID da integração e uma breve descrição. Use esta lista para identificar bots que você não reconhece ou não usa mais. - Desconectar um Bot
Clique no menu de três pontos (⋮) no lado direito da linha da integração. Escolha Desconectar. Uma caixa de diálogo de confirmação aparece. Clique em Desconectar novamente para confirmar. O token do bot é revogado imediatamente. O bot não pode mais acessar páginas ou bancos de dados compartilhados. - Adicionar uma Nova Integração
Clique no botão Adicionar Integração no topo da lista de Integrações do Workspace. Um menu suspenso mostra duas opções: Conectar um serviço e Criar uma integração personalizada. Selecione uma com base na sua necessidade. Para um serviço pré-construído como Slack ou Zapier, escolha Conectar um serviço e siga o fluxo de autorização. Para um bot personalizado, escolha Criar uma integração personalizada e dê um nome a ela. O Notion gera um token de API. Copie o token imediatamente, pois você não poderá vê-lo novamente. - Compartilhar um Banco de Dados ou Página com um Bot
Abra o banco de dados ou página que você deseja que o bot acesse. Clique no botão Compartilhar no canto superior direito. No campo Convidar, comece a digitar o nome da integração. Selecione-a no menu suspenso. Escolha o nível de permissão: Pode Ler, Pode Editar ou Pode Comentar. Clique em Convidar. O bot agora tem acesso apenas a esse conteúdo. - Editar o Nome ou Descrição de uma Integração
Clique no nome da integração na lista de Integrações do Workspace. A página de detalhes da integração é aberta. Você pode alterar o nome e a descrição. As alterações se aplicam a todos os tokens e conexões dessa integração. Clique em Salvar.
Problemas Comuns ao Gerenciar Integrações de Bots do Workspace
Um bot aparece como ativo, mas não funciona mais
O token do bot pode ter sido revogado ou a integração pode ter sido excluída pelo seu criador. Verifique a lista de Integrações do Workspace. Se o bot aparecer, mas não tiver atividade recente, desconecte-o e peça ao proprietário do bot para criar uma nova integração. Se o bot não aparecer, provavelmente era uma integração interna que foi excluída.
Não consigo ver o botão Adicionar Integração
Apenas proprietários e administradores do workspace podem adicionar integrações. Se você é um membro, o botão fica oculto. Peça a um administrador para adicionar a integração ou atualizar sua função temporariamente. Você pode verificar sua função em Configurações e Membros > Pessoas.
A lista de integrações mostra duplicatas do mesmo bot
Cada autorização por um membro diferente do workspace cria uma entrada separada. Por exemplo, se duas pessoas conectaram o mesmo workspace do Slack, você vê duas entradas. Você pode desconectar uma com segurança se o bot funcionar com apenas uma conexão. Confirme com ambos os usuários antes de remover qualquer entrada.
Bot ainda tem acesso após desconectar
Desconectar das configurações do workspace revoga o token. No entanto, se o bot foi compartilhado com uma página usando um método diferente, como um link público, ele ainda pode ler essa página. Remova o bot do menu Compartilhar da página como uma etapa secundária.
Comparação entre Tipos de Integração de Bots do Workspace
| Recurso | Integração do Workspace | Integração Interna |
|---|---|---|
| Quem pode criar | Administradores e proprietários do workspace | Qualquer membro do workspace |
| Visível nas configurações | Sim, em Integrações do Workspace | Sim, em Integrações Internas |
| Escopo do token | Definido pelo criador da integração no momento da criação | Definido pelo criador da integração no momento da criação |
| Pode ser compartilhado com páginas | Sim | Sim |
| Pode ser desconectado por administradores | Sim | Apenas pelo criador ou um proprietário |
| Caso de uso | Serviços pré-construídos como Slack, Zapier, GitHub | Scripts personalizados ou bots privados |
Ambos os tipos aparecem na seção Integrações das configurações do workspace. A principal diferença é quem pode desconectá-los. As integrações do workspace podem ser removidas por qualquer administrador, enquanto as integrações internas exigem o criador ou um proprietário para revogar.
Use integrações do workspace para automação em toda a equipe. Use integrações internas para experimentos pessoais ou automações pontuais que não devem ser visíveis para todo o workspace.
Para alterar uma integração interna para uma integração do workspace, você deve criar uma nova integração na conta de administrador do workspace e compartilhar as mesmas páginas.
Melhores Práticas para Proteger Integrações de Bots
Audite as integrações do seu workspace mensalmente. Remova qualquer bot que você não reconheça ou que não tenha sido usado nos últimos 90 dias. Um bot desconectado não pode ser reconectado sem um novo token, portanto, mantenha um registro de quais serviços cada bot suporta.
Use o escopo de permissão mínimo ao criar uma integração personalizada. Por exemplo, se um bot apenas lê dados, selecione o escopo somente leitura. Não conceda permissões de atualização ou inserção, a menos que a automação exija. Você não pode alterar o escopo após a criação; portanto, crie uma nova integração com o escopo correto, se necessário.
Armazene tokens de API em um gerenciador de senhas ou variável de ambiente. Nunca cole um token em um documento ou chat compartilhado. Se um token for exposto, desconecte a integração imediatamente e crie uma nova.
Para workspaces sensíveis, restrinja quem pode criar integrações internas. O Notion não possui uma opção nativa para isso. Em vez disso, treine sua equipe para solicitar integrações por meio de um administrador, em vez de criá-las diretamente.
Agora você pode gerenciar todas as integrações de bots pelo painel de configurações do workspace. Revise a lista de Integrações do Workspace mensalmente e remova qualquer conexão que não seja mais necessária. Para automação personalizada, crie integrações internas com o menor escopo de privilégio necessário. Use o atalho de teclado Ctrl + / para abrir rapidamente a barra de pesquisa de configurações e pular diretamente para Integrações.