O Notion entra na Toca como fonte de contexto do seu negócio: planos, metas, calendário de campanhas e controles internos que você mantém em páginas e bases. A conexão é feita por login (OAuth): você autoriza dentro do próprio Notion e escolhe, na tela de autorização, o que quer compartilhar. Além de consultar, a Toca também sabe criar e editar conteúdo no workspace — sempre mediante sua aprovação, pedido a pedido, no chat.
Antes de começar
- Tenha acesso ao workspace do Notion que quer conectar.
- O essencial vem na hora de autorizar (e depois dela): compartilhar com a conexão as páginas e bases que a Toca deve enxergar. O que não for compartilhado não existe para a integração.
- Se você conectou no passado colando o token de uma conexão interna, a conexão continua valendo. Esse caminho foi descontinuado: para reconectar ou criar uma conexão nova, o fluxo é o login.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Notion e clique em Conectar.
- Entre no Notion e, na própria tela de autorização, selecione as páginas que quer compartilhar com a Toca.
- Para ampliar o acesso depois, compartilhe a página no Notion: abra-a, use o menu de conexões e adicione a conexão da Toca. Subpáginas herdam o compartilhamento da página-mãe.
O que a Toca acessa
Leitura: páginas (conteúdo e metadados), bancos de dados e suas linhas, busca no que foi compartilhado e a lista de usuários do workspace.
Escrita: a Toca sabe criar e editar páginas, acrescentar e editar blocos de conteúdo, e mandar página ou bloco para a lixeira do Notion — e restaurar de volta. Nenhuma dessas alterações acontece sozinha: cada uma passa por sua aprovação explícita, pedido a pedido, dentro do chat. E um limite da própria plataforma que joga a seu favor: a API do Notion não apaga nada em definitivo — o que sai vai para a lixeira e pode ser restaurado.
Um detalhe que evita sustos: colunas numéricas de uma base não têm moeda definida pelo Notion — quando uma pergunta envolver valores de uma base sua, a Toca confirma com você a unidade antes de tratar o número como dinheiro.
Manutenção da conexão
A conexão vale até você revogá-la no Notion (removendo a conexão das páginas ou o acesso
do app) ou desconectá-la na Toca. Compartilhamentos feitos depois da conexão passam a
valer imediatamente. Se o acesso for revogado do lado do Notion, reconecte pelo card em
Configurações → Integrações — a reconexão passa pelo mesmo login.
Problemas comuns
- A Toca diz que não encontrou nada, mas o workspace tem conteúdo — quase sempre é compartilhamento: a integração só enxerga páginas e bases explicitamente compartilhadas com a conexão. Compartilhe a página no Notion e pergunte de novo.
- Consultas em bases muito grandes demoram — a API do Notion trabalha com um ritmo em torno de três requisições por segundo por conexão; consultas amplas em bases longas levam mais tempo. Prefira perguntas com recorte (uma base, um período).
- Lista de usuários incompleta ou com acesso negado — a lista não inclui convidados (guests), e a consulta depende da permissão de informações de usuário da conexão.