OneDrive / SharePoint

Arquivos no OneDrive e em bibliotecas do SharePoint (Microsoft Graph)

Conectar ao OneDrive/SharePoint

onedrive.connect

Autentica no Microsoft Entra ID e seleciona a unidade

Como usar

Autentica no Microsoft 365 (Entra ID) e escolhe a unidade: o OneDrive de um usuário, uma biblioteca de um site SharePoint ou o do usuário autenticado. Use um aplicativo registrado (tenant, client ID e secret no cofre) ou um refresh token. Funciona sem login interativo.

Exemplo: Conecte com o aplicativo do robô à biblioteca Documents do site https://empresa.sharepoint.com/sites/Financeiro, em {onedrive}.

Campos

Campo	Tipo	Padrão	Detalhes
Autenticação *	Opção	`Aplicativo (client credentials, sem usuário)`	Registre um aplicativo no Microsoft Entra ID com as permissões do Microsoft GraphOpções: Aplicativo (client credentials, sem usuário), Usuário delegado (refresh token)
Tenant ID *	Texto		Ex.: `empresa.onmicrosoft.com ou GUID`
ID do aplicativo (client ID) *	Texto
Client secret (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Aplicativo (client credentials, sem usuário)»
Refresh token (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Usuário delegado (refresh token)»
Unidade *	Opção	`OneDrive de um usuário`	Opções: OneDrive de um usuário, Biblioteca de site SharePoint, Usuário autenticado (delegado)
Usuário (UPN) *	Texto		Ex.: `usuario@empresa.com`Só quando «Unidade» = «OneDrive de um usuário»
URL do site SharePoint *	Texto		Ex.: `https://empresa.sharepoint.com/sites/Financeiro`Só quando «Unidade» = «Biblioteca de site SharePoint»
Biblioteca de documentos	Texto	`Documents`	Só quando «Unidade» = «Biblioteca de site SharePoint»
Salvar conexão na variável *	Variável de saída	`onedrive`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Client secret para apps confidenciais (cofre)	Credencial do cofre		Só quando «Autenticação» = «Usuário delegado (refresh token)»

Resultado: guardado na variável onedrive (Objeto).

Listar Itens

onedrive.list_items

Lista arquivos e pastas de um caminho

Como usar

Lista os arquivos e pastas de um caminho (como /Entrada), com nome, tamanho, datas e se é pasta.

Exemplo: Liste /Entrada/{data} em {items} e baixe os arquivos.

Campos

Campo	Tipo	Padrão
Conexão do OneDrive *	Variável	`onedrive`
Caminho da pasta	Texto	`/`
Salvar resultado na variável *	Variável de saída	`items`

Resultado: guardado na variável items (Lista).

Enviar Arquivo

onedrive.upload_file

Envia um arquivo (arquivos grandes em partes)

Como usar

Envia um arquivo local para uma pasta (arquivos grandes vão em partes automaticamente), substituindo, renomeando ou falhando se já existir.

Exemplo: Envie {relatorio} para /Relatórios/{ano}, substituindo se existir.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do OneDrive *	Variável	`onedrive`
Arquivo local *	Arquivo
Pasta de destino	Texto	`/`
Se o arquivo existir	Opção	`Substituir`	Opções: Substituir, Manter os dois, Falhar
Salvar resultado na variável *	Variável de saída	`item`

Resultado: guardado na variável item (Dicionário).

Baixar Arquivo

onedrive.download_file

Baixa um arquivo pelo caminho

Como usar

Baixa um arquivo pelo caminho para uma pasta local e guarda o caminho salvo.

Exemplo: Baixe /Entrada/pedidos.xlsx para C:\Robos\entrada.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do OneDrive *	Variável	`onedrive`
Caminho do arquivo *	Texto		Ex.: `/Relatórios/2026/arquivo.xlsx`
Salvar na pasta *	Pasta
Salvar caminho do arquivo na variável *	Variável de saída	`downloaded_file`

Resultado: guardado na variável downloaded_file (Caminho de arquivo).

Criar Pasta

onedrive.create_folder

Cria uma pasta

Como usar

Cria uma pasta dentro de outra.

Exemplo: Crie a pasta {ano}-{mes} dentro de /Relatórios.

Campos

Campo	Tipo	Padrão
Conexão do OneDrive *	Variável	`onedrive`
Pasta pai	Texto	`/`
Nome da pasta *	Texto
Salvar resultado na variável *	Variável de saída	`item`

Campo	Tipo	Padrão
Conexão do OneDrive *	Variável	`onedrive`
Caminho do item *	Texto
Salvar resultado na variável *	Variável de saída	`item`

Resultado: guardado na variável item (Dicionário).

Buscar Itens

onedrive.search_items

Busca arquivos por nome e conteúdo

Como usar

Busca arquivos pelo nome e pelo conteúdo na unidade conectada.

Exemplo: Busque "contrato {cliente}" em {items}.

Campos

Campo	Tipo	Padrão
Conexão do OneDrive *	Variável	`onedrive`
Busca *	Texto
Máximo de resultados	Número	`50`
Salvar resultado na variável *	Variável de saída	`items`

Resultado: guardado na variável items (Lista).

Criar Link de Compartilhamento

onedrive.create_share_link

Cria um link de visualização ou edição

Como usar

Cria um link de visualização ou edição, para a organização ou para qualquer pessoa com o link, e guarda o endereço.

Exemplo: Crie um link de visualização da organização para /Relatórios/{arquivo} e envie no Teams.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do OneDrive *	Variável	`onedrive`
Caminho do item *	Texto
Acesso	Opção	`Visualizar`	Opções: Visualizar, Editar
Quem pode usar	Opção	`Pessoas da organização`	Opções: Pessoas da organização, Qualquer pessoa com o link
Salvar resultado na variável *	Variável de saída	`link_url`

Resultado: guardado na variável link_url (Texto).