A conexão com o SharePoint é feita pelo login da conta Microsoft 365 da sua empresa: você é direcionado à tela da Microsoft, autoriza o acesso e volta à Toca. Nenhuma chave é digitada à mão. A Toca age com a permissão de quem conectou: ela vê e altera exatamente o que essa pessoa vê e altera no SharePoint.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- Use uma conta corporativa ou de escola do Microsoft 365. Conta pessoal da Microsoft (Outlook.com, Hotmail) não abre o SharePoint e não é aceita na tela de login.
- Conecte com um usuário que tenha acesso aos sites, listas e bibliotecas que você quer consultar. O que esse usuário não abre no navegador, a Toca também não abre.
- Se a sua empresa restringe a autorização de aplicativos no Microsoft 365, um administrador pode precisar aprovar a Toca antes. As permissões que a Toca pede não exigem administrador pela documentação da Microsoft, mas a política da empresa pode exigir.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card SharePoint e clique em Conectar.
- Na tela da Microsoft, escolha a conta da empresa e entre. A Microsoft pergunta qual conta usar mesmo que o navegador já esteja logado — confira se é a conta certa.
- Revise as permissões solicitadas e aceite.
- De volta à Toca, o card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê os sites do SharePoint que a conta conectada alcança: listas e itens de lista, bibliotecas de documentos com arquivos e pastas (conteúdo, metadados, versões e compartilhamento), planilhas do Excel guardadas nelas, colunas, tipos de conteúdo, páginas e a busca do Microsoft 365. O OneDrive for Business da conta entra junto, porque ele também é um site do SharePoint.
A Toca também altera: cria e edita itens e listas, colunas e tipos de conteúdo; envia, renomeia, move, copia e apaga arquivos e pastas, faz check-in e check-out e restaura versões; escreve e formata planilhas do Excel; compartilha arquivos por link ou convite; e cria, edita, publica e apaga páginas. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat.
Ficam de fora as permissões do site e o repositório de termos: essas operações exigem um administrador do Microsoft 365, e a Toca não pede esse nível de acesso.
Manutenção da conexão
A Toca renova a autorização automaticamente. Ela deixa de valer quando o acesso é revogado do lado da Microsoft — por exemplo, quando a senha é trocada, o consentimento é retirado ou a conexão fica tempo demais sem uso. Nesse caso, o card em Configurações → Integrações mostra Reconectar: basta entrar de novo na tela da Microsoft.
Problemas comuns
- A tela da Microsoft não aceita a conta — contas pessoais da Microsoft não funcionam. Entre com a conta corporativa ou de escola do Microsoft 365 da empresa.
- A Microsoft pede a aprovação de um administrador — a sua empresa restringe a autorização de aplicativos. Peça ao administrador do Microsoft 365 que aprove a Toca e conecte de novo.
- Um site, lista ou arquivo não aparece — a Toca enxerga só o que a conta conectada enxerga. Dê acesso a essa conta no SharePoint ou conecte com uma conta que já tenha.
- Filtro recusado em lista grande — em listas muito grandes, o SharePoint recusa filtrar por coluna que não está indexada. Indexe a coluna nas configurações da lista ou peça o recorte por outra coluna.
- Conectou a conta errada — use Excluir integração no menu ⋯ do card e conecte de novo, escolhendo a conta certa na tela da Microsoft.