OneDrive é o serviço de armazenamento em nuvem e sincronização de arquivos da Microsoft que permite aos usuários armazenar, acessar e compartilhar arquivos com segurança entre dispositivos. Integrado profundamente ao ecossistema Microsoft 365, o OneDrive oferece colaboração fluida, controle de versão e acesso em tempo real ao conteúdo em equipes e organizações.
Saiba como integrar a ferramenta OneDrive no Zoen para puxar, gerenciar e organizar automaticamente seus arquivos na nuvem dentro dos seus fluxos de trabalho. Este tutorial mostra como conectar o OneDrive, configurar o acesso a arquivos e usar o conteúdo armazenado para alimentar automações. Ideal para sincronizar documentos e mídias essenciais com seus agentes em tempo real.
Com o OneDrive, você pode:
- Armazenar arquivos com segurança na nuvem: Enviar e acessar documentos, imagens e outros arquivos de qualquer dispositivo
- Organizar seu conteúdo: Criar pastas estruturadas e gerenciar versões de arquivos com facilidade
- Colaborar em tempo real: Compartilhar arquivos, editá-los simultaneamente com outras pessoas e acompanhar mudanças
- Acessar em vários dispositivos: Usar o OneDrive em desktop, mobile e plataformas web
- Integrar com o Microsoft 365: Trabalhar de forma fluida com Word, Excel, PowerPoint e Teams
- Controlar permissões: Compartilhar arquivos e pastas com configurações de acesso personalizadas e controles de expiração
No Zoen, a integração OneDrive permite que seus agentes interajam diretamente com seu armazenamento na nuvem. Os agentes podem enviar novos arquivos para pastas específicas, recuperar e ler arquivos existentes e listar o conteúdo de pastas para organizar e acessar informações dinamicamente. Esta integração permite que seus agentes incorporem operações de arquivo em fluxos de trabalho inteligentes — automatizando a entrada de documentos, análise de conteúdo e gerenciamento estruturado de armazenamento. Ao conectar o Zoen ao OneDrive, você capacita seus agentes a gerenciar e usar documentos na nuvem de forma programática, eliminando etapas manuais e aprimorando a automação com acesso seguro a arquivos em tempo real.
Integrate OneDrive into the workflow. Can create text and Excel files, upload files, download files, list and search files, move or rename files, copy files, create sharing links, and delete files or folders.
Upload a file to OneDrive
| Parameter | Type | Required | Description |
|---|
fileName | string | Yes | The name of the file to upload (e.g., "report.pdf", "data.xlsx") |
file | file | No | The file to upload (binary) |
content | string | No | The text content to upload (if no file is provided) |
mimeType | string | No | The MIME type of the file to create (e.g., text/plain for .txt, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet for .xlsx) |
folderId | string | No | Folder ID to upload the file to (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
| Parameter | Type | Description |
|---|
success | boolean | Whether the file was uploaded successfully |
file | object | The uploaded file object with metadata including id, name, webViewLink, webContentLink, and timestamps |
Create a new folder in OneDrive
| Parameter | Type | Required | Description |
|---|
folderName | string | Yes | Name of the folder to create (e.g., "My Documents", "Project Files") |
folderId | string | No | Parent folder ID to create the folder in (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
| Parameter | Type | Description |
|---|
success | boolean | Whether the folder was created successfully |
file | object | The created folder object with metadata including id, name, webViewLink, and timestamps |
Download a file from OneDrive
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file to download (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
fileName | string | No | Optional filename override (e.g., "report.pdf", "data.xlsx") |
| Parameter | Type | Description |
|---|
file | file | Downloaded file stored in execution files |
List files and folders in OneDrive
| Parameter | Type | Required | Description |
|---|
folderId | string | No | Folder ID to list files from (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
query | string | No | Filter files by name prefix (e.g., "report", "invoice_2024") |
pageSize | number | No | Maximum number of files to return (e.g., 10, 50, 100) |
pageToken | string | No | Continuation URL from a previous response's nextPageToken, used to fetch the next page |
| Parameter | Type | Description |
|---|
success | boolean | Whether files were listed successfully |
files | array | Array of file and folder objects with metadata |
nextPageToken | string | Token for retrieving the next page of results (optional) |
Search for files and folders across OneDrive by name, metadata, or content (recursive)
| Parameter | Type | Required | Description |
|---|
query | string | No | Search text matched against file name, metadata, and content. Not required when paginating with pageToken |
pageSize | number | No | Maximum number of results to return (e.g., 10, 50, 100) |
pageToken | string | No | Continuation URL from a previous response's nextPageToken, used to fetch the next page |
| Parameter | Type | Description |
|---|
success | boolean | Whether the search completed successfully |
files | array | Array of file and folder objects matching the search query |
nextPageToken | string | Token for retrieving the next page of results (optional) |
Get metadata for a specific OneDrive file or folder by ID, or the drive root
| Parameter | Type | Required | Description |
|---|
fileId | string | No | The ID of the file or folder to retrieve (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M"). Leave empty to get the drive root folder |
| Parameter | Type | Description |
|---|
success | boolean | Whether the item metadata was retrieved |
file | object | The file or folder metadata, including id, name, webViewLink, size, and timestamps |
Get information about the OneDrive drive, including storage quota
| Parameter | Type | Required | Description |
|---|
| Parameter | Type | Description |
|---|
success | boolean | Whether the drive info was retrieved |
driveId | string | The ID of the drive |
driveType | string | The type of drive (e.g., "personal", "business") |
webUrl | string | URL to the drive in the browser |
owner | string | Display name of the drive owner |
quota | object | Storage quota information in bytes (total, used, remaining, deleted, state) |
Move a file or folder to a new parent folder, rename it, or both
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to move or rename |
destinationFolderId | string | No | The ID of the destination parent folder (omit to only rename in place) |
newName | string | No | The new name for the file or folder (omit to only move) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the move or rename was successful |
file | object | The updated file object with its new name and/or parent folder |
Copy a file or folder to another location within OneDrive
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to copy |
destinationFolderId | string | Yes | The ID of the destination parent folder |
destinationFileName | string | No | Optional new name for the copy (defaults to the original name) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the copy request was accepted |
sourceFileId | string | The ID of the file or folder that was copied |
name | string | The requested name for the copy, if provided |
monitorUrl | string | URL to poll for the status of the asynchronous copy operation (copy completes in the background) |
Create a view or edit sharing link for a OneDrive file or folder
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to share |
linkType | string | No | Type of link to create: "view" (read-only), "edit" (read-write), or "embed" |
linkScope | string | No | Who can use the link: "anonymous" (anyone), "organization" (tenant members), or "users" (specific people) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the sharing link was created successfully |
link | object | The created sharing link, including its type, scope, and URL |
Delete a file or folder from OneDrive
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | The ID of the file or folder to delete (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M") |
| Parameter | Type | Description |
|---|
success | boolean | Whether the file was deleted successfully |
deleted | boolean | Confirmation that the file was deleted |
fileId | string | The ID of the deleted file |