# Microsoft SharePoint Conectar Microsoft SharePoint à operação da sua empresa. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild. Source: https://zild.ai/pt-BR/docs/apps/zild-admin/connector-microsoft-sharepoint Conectar Microsoft SharePoint à operação da sua empresa. ## Onde configurar Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve. ## Credenciais da sua empresa O cliente deve obter e configurar suas próprias chaves de API ou a forma de autenticação exigida por este conector. A assinatura Zild é definida pelo tamanho da empresa; o consumo dos serviços externos é cobrado pelo respectivo provedor, separado da assinatura. Não é necessário configurar conectores que sua operação não utiliza. ## Campos necessários Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
CampoRequisito para o fluxo
OAuthConexão delegada da conta Microsoft 365; não exige API key manual.
## Como obter as credenciais - Salve o conector e clique em Conectar conta Microsoft 365. - Entre com a conta corporativa que será usada e autorize as permissões solicitadas: Files.Read.All, Files.ReadWrite.All, Sites.Read.All e offline_access. - Se o consentimento for bloqueado, peça aprovação ao administrador Microsoft 365. Após revogação, reconecte a conta. ## Como funciona na Zild A administração configura o aplicativo Entra e seu segredo no servidor. A Zild renova os tokens delegados; o usuário permanece limitado aos recursos autorizados. ## Como conferir a configuração Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar. Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la. ## Escopo do acesso delegado O conector atual solicita Files.Read.All, Files.ReadWrite.All, Sites.Read.All e offline_access. A conta conectada precisa ter acesso aos documentos usados no fluxo. Escolher uma biblioteca para o piloto não restringe, por si só, o consentimento a essa biblioteca. Revise com a administração a conta, suas permissões e as ferramentas habilitadas no agente antes de conectar documentos de projetos. A Microsoft oferece permissões Selected com atribuição explícita a recursos. Esse modelo não é o fluxo de consentimento implementado neste conector. Não troque os escopos por conta própria esperando compatibilidade: uma implantação com esse requisito precisa de validação técnica. ## Teste a biblioteca antes dos arquivos de projeto Prepare uma biblioteca ou pasta autorizada para teste e obtenha seu driveId e identificador da pasta com a administração. Salve e habilite o conector, conclua Conectar conta Microsoft 365 e confira qual conta foi usada. Vincule o conector à ferramenta do agente. Faça primeiro uma listagem (ListItems); id=root representa a raiz da unidade. Confira nome, identificador e localização dos itens retornados. Depois, leia um arquivo pequeno conhecido. ReadFile devolve contentBase64 e contentType e limita a resposta a 2 MB nesta implementação. Isso transporta o conteúdo; não significa OCR, interpretação geométrica ou leitura nativa de qualquer DWG/SKP. Para engenharia, comece com exportações estruturadas autorizadas e confirme a etapa que interpreta o formato. Não use arquivos de projeto grandes para concluir que o login falhou. ## Separe leitura, gravação e acompanhamento Habilite WriteFile somente quando o processo precisar gravar um resultado e a aprovação estiver definida. A operação recebe a pasta, o nome de arquivo e contentBase64. Use um nome de teste exclusivo e confirme o arquivo retornado na pasta esperada antes de ampliar o fluxo. Após timeout, confira o destino antes de repetir a escrita. Listar e ler corretamente não valida gravação, classificação ou aprovação técnica do documento. O catálogo inclui Subscribe e RenewSubscription para alterações de biblioteca. A assinatura exige configuração de DriveId, NotificationUrl e estado secreto pela administração; conectar a conta não ativa automaticamente sincronização contínua. Confirme o recebimento, o processamento e a renovação das notificações no ambiente implantado. Se o acesso parar, diferencie consentimento revogado, conta sem acesso, identificador incorreto e limite de resposta. Veja também: [Guia de extração e avaliação de engenharia](/pt-BR/blog/engenharia-autocad-sketchup-piloto). Microsoft Learn: [Graph permissions](https://learn.microsoft.com/en-us/graph/permissions-reference) · [Selected permissions](https://learn.microsoft.com/en-us/graph/permissions-selected-overview). Consultado em 28/10/2026. ## Documentação oficial - [Microsoft: delegated Graph access](https://learn.microsoft.com/en-us/graph/auth-v2-user) [Voltar a Conectores](/pt-BR/docs/apps/zild-admin/integration)