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.
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.
| Campo | Requisito para o fluxo |
|---|---|
OAuth | Conexã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.
Microsoft Learn: Graph permissions · Selected permissions. Consultado em 28/10/2026.