SharePoint é uma plataforma colaborativa da Microsoft que permite aos usuários criar e gerenciar websites internos, compartilhar documentos e organizar recursos da equipe. Ela oferece uma solução poderosa e flexível para criar workspaces digitais e agilizar o gerenciamento de conteúdo nas organizações.
Com o SharePoint, você pode:
- Criar sites de equipe e de comunicação: Configure páginas e portais para apoiar colaboração, anúncios e distribuição de conteúdo
- Organizar e compartilhar conteúdo: Armazene documentos, gerencie arquivos e habilite controle de versão com recursos de compartilhamento seguro
- Personalizar páginas: Adicione text parts para adaptar cada site às necessidades da sua equipe
- Melhorar a descoberta: Use metadados, busca e ferramentas de navegação para ajudar os usuários a encontrar rapidamente o que precisam
- Colaborar com segurança: Controle o acesso com configurações robustas de permissão e integração com o Microsoft 365
Na Zoen, a integração com o SharePoint capacita seus agentes a criar e acessar sites e páginas do SharePoint como parte dos seus fluxos de trabalho. Isso habilita gerenciamento automatizado de documentos, compartilhamento de conhecimento e criação de workspaces sem esforço manual. Os agentes podem gerar novas páginas de projeto, fazer upload ou recuperar arquivos e organizar recursos dinamicamente, com base nas entradas do fluxo de trabalho. Ao conectar a Zoen ao SharePoint, você traz colaboração estruturada e gerenciamento de conteúdo para seus fluxos de automação — dando aos seus agentes a capacidade de coordenar atividades da equipe, exibir informações-chave e manter uma única fonte da verdade em toda a organização.
Integrate SharePoint into the workflow. Read/create pages, list sites, and work with lists (read, create, update items). Requires OAuth.
Create a new page in a SharePoint site
| Parameter | Type | Required | Description |
|---|
siteId | string | No | The ID of the SharePoint site (internal use) |
siteSelector | string | No | Select the SharePoint site |
pageName | string | Yes | The name of the page to create. Example: My-New-Page.aspx or Report-2024.aspx |
pageTitle | string | No | The title of the page (defaults to page name if not provided) |
pageContent | string | No | The content of the page |
| Parameter | Type | Description |
|---|
page | object | Created SharePoint page information |
↳ id | string | The unique ID of the created page |
↳ name | string | The name of the created page |
↳ title | string | The title of the created page |
↳ webUrl | string | The URL to access the page |
↳ pageLayout | string | The layout type of the page |
↳ createdDateTime | string | When the page was created |
↳ lastModifiedDateTime | string | When the page was last modified |
Read a specific page from a SharePoint site
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
pageId | string | No | The ID of the page to read. Example: a GUID like 12345678-1234-1234-1234-123456789012 |
pageName | string | No | The name of the page to read (alternative to pageId). Example: Home.aspx or About-Us.aspx |
maxPages | number | No | Maximum number of pages to return when listing all pages (default: 10, max: 50) |
nextPageUrl | string | No | Full @odata.nextLink URL from a previous Microsoft Graph page response |
| Parameter | Type | Description |
|---|
page | object | Information about the SharePoint page |
↳ id | string | The unique ID of the page |
↳ name | string | The name of the page |
↳ title | string | The title of the page |
↳ webUrl | string | The URL to access the page |
↳ pageLayout | string | The layout type of the page |
↳ description | string | The description of the page |
↳ createdDateTime | string | When the page was created |
↳ lastModifiedDateTime | string | When the page was last modified |
pages | array | List of SharePoint pages |
↳ page | object | page output from the tool |
↳ id | string | The unique ID of the page |
↳ name | string | The name of the page |
↳ title | string | The title of the page |
↳ webUrl | string | The URL to access the page |
↳ pageLayout | string | The layout type of the page |
↳ description | string | The description of the page |
↳ createdDateTime | string | When the page was created |
↳ lastModifiedDateTime | string | When the page was last modified |
↳ content | object | content output from the tool |
↳ content | string | Extracted text content from the page |
↳ canvasLayout | object | Raw SharePoint canvas layout structure |
content | object | Content of the SharePoint page |
↳ content | string | Extracted text content from the page |
↳ canvasLayout | object | Raw SharePoint canvas layout structure |
totalPages | number | Total number of pages found |
nextPageUrl | string | Full Microsoft Graph @odata.nextLink URL for the next page of results |
Update the title and/or content of a SharePoint page
| Parameter | Type | Required | Description |
|---|
siteId | string | No | The ID of the SharePoint site (internal use) |
siteSelector | string | No | Select the SharePoint site |
pageId | string | Yes | The ID of the page to update. Example: a GUID like 12345678-1234-1234-1234-123456789012 |
pageTitle | string | No | The new title of the page |
pageContent | string | No | The new text content of the page. Replaces the entire canvas layout of the page. |
| Parameter | Type | Description |
|---|
page | object | Updated SharePoint page information |
↳ id | string | The unique ID of the page |
↳ name | string | The name of the page |
↳ title | string | The title of the page |
↳ webUrl | string | The URL to access the page |
↳ pageLayout | string | The layout type of the page |
↳ createdDateTime | string | When the page was created |
↳ lastModifiedDateTime | string | When the page was last modified |
Publish the latest version of a SharePoint page, making it available to all users
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
pageId | string | Yes | The ID of the page to publish. Example: a GUID like 12345678-1234-1234-1234-123456789012 |
| Parameter | Type | Description |
|---|
published | boolean | Whether the page was published |
pageId | string | The ID of the published page |
Delete a page from a SharePoint site
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
pageId | string | Yes | The ID of the page to delete. Example: a GUID like 12345678-1234-1234-1234-123456789012 |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the page was deleted |
pageId | string | The ID of the deleted page |
List details of all SharePoint sites
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
groupId | string | No | The group ID for accessing a group team site. Example: a GUID like 12345678-1234-1234-1234-123456789012 |
nextPageUrl | string | No | Full @odata.nextLink URL from a previous Microsoft Graph page response |
| Parameter | Type | Description |
|---|
site | object | Information about the current SharePoint site |
↳ id | string | The unique ID of the site |
↳ name | string | The name of the site |
↳ displayName | string | The display name of the site |
↳ webUrl | string | The URL to access the site |
↳ description | string | The description of the site |
↳ createdDateTime | string | When the site was created |
↳ lastModifiedDateTime | string | When the site was last modified |
↳ isPersonalSite | boolean | Whether this is a personal site |
↳ root | object | Present (as an empty object) only when this site is the root of its site collection |
↳ siteCollection | object | siteCollection output from the tool |
↳ hostname | string | Site collection hostname |
sites | array | List of all accessible SharePoint sites |
↳ id | string | The unique ID of the site |
↳ name | string | The name of the site |
↳ displayName | string | The display name of the site |
↳ webUrl | string | The URL to access the site |
↳ description | string | The description of the site |
↳ createdDateTime | string | When the site was created |
↳ lastModifiedDateTime | string | When the site was last modified |
nextPageUrl | string | Full Microsoft Graph @odata.nextLink URL for the next page of results |
Create a new list in a SharePoint site
| Parameter | Type | Required | Description |
|---|
siteId | string | No | The ID of the SharePoint site (internal use) |
siteSelector | string | No | Select the SharePoint site |
listDisplayName | string | Yes | Display name of the list to create. Example: Project Tasks or Customer Contacts |
listDescription | string | No | Description of the list |
listTemplate | string | No | List template name (e.g., 'genericList') |
pageContent | json | No | Optional JSON of columns. Either a top-level array of column definitions or an object with { columns: [...] }. |
| Parameter | Type | Description |
|---|
list | object | Created SharePoint list information |
↳ id | string | The unique ID of the list |
↳ displayName | string | The display name of the list |
↳ name | string | The internal name of the list |
↳ webUrl | string | The web URL of the list |
↳ createdDateTime | string | When the list was created |
↳ lastModifiedDateTime | string | When the list was last modified |
↳ list | object | List properties (e.g., template) |
Get metadata (and optionally columns/items) for a SharePoint list
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
listId | string | No | The ID of the list to retrieve. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012 |
includeColumns | boolean | No | Whether to include column definitions when retrieving a specific list |
includeItems | boolean | No | Whether to include list items when retrieving a specific list |
nextPageUrl | string | No | Full @odata.nextLink URL from a previous Microsoft Graph page response |
| Parameter | Type | Description |
|---|
list | object | Information about the SharePoint list |
↳ id | string | The unique ID of the list |
↳ displayName | string | The display name of the list |
↳ name | string | The internal name of the list |
↳ webUrl | string | The web URL of the list |
↳ createdDateTime | string | When the list was created |
↳ lastModifiedDateTime | string | When the list was last modified |
↳ list | object | List properties (e.g., template) |
↳ columns | array | List column definitions |
lists | array | All lists in the site when no listId/title provided |
items | array | List items with expanded fields when reading list items |
↳ id | string | Item ID |
↳ fields | object | Field values for the item |
nextPageUrl | string | Full Microsoft Graph @odata.nextLink URL for the next page of results |
Update the properties (fields) on a SharePoint list item
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
listId | string | Yes | The ID of the list containing the item. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012 |
itemId | string | Yes | The ID of the list item to update. Example: 1, 42, or 123 |
listItemFields | json | Yes | Field values to update on the list item |
| Parameter | Type | Description |
|---|
item | object | Updated SharePoint list item |
↳ id | string | Item ID |
↳ fields | object | Updated field values |
Add a new item to a SharePoint list
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
listId | string | Yes | The ID of the list to add the item to. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012 |
listItemFields | json | Yes | Field values for the new list item |
| Parameter | Type | Description |
|---|
item | object | Created SharePoint list item |
↳ id | string | Item ID |
↳ fields | object | Field values for the new item |
Get a single item (with field values) from a SharePoint list
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
listId | string | Yes | The ID of the list containing the item. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012 |
itemId | string | Yes | The ID of the list item to retrieve. Example: 1, 42, or 123 |
| Parameter | Type | Description |
|---|
item | object | SharePoint list item with field values |
↳ id | string | Item ID |
↳ fields | object | Field values for the item |
Delete an item from a SharePoint list
| Parameter | Type | Required | Description |
|---|
siteSelector | string | No | Select the SharePoint site |
siteId | string | No | The ID of the SharePoint site (internal use) |
listId | string | Yes | The ID of the list containing the item. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012 |
itemId | string | Yes | The ID of the list item to delete. Example: 1, 42, or 123 |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the list item was deleted |
itemId | string | The ID of the deleted list item |
Upload files to a SharePoint document library
| Parameter | Type | Required | Description |
|---|
siteId | string | No | The ID of the SharePoint site |
driveId | string | No | The ID of the document library (drive). If not provided, uses default drive. Example: b!abc123def456 |
folderPath | string | No | Optional folder path within the document library. Example: /Documents/Subfolder or /Shared Documents/Reports |
fileName | string | No | Optional: override the uploaded file name. Example: report-2024.pdf |
files | file[] | Yes | Files to upload to SharePoint |
| Parameter | Type | Description |
|---|
uploadedFiles | array | Array of uploaded file objects |
↳ id | string | The unique ID of the uploaded file |
↳ name | string | The name of the uploaded file |
↳ webUrl | string | The URL to access the file |
↳ size | number | The size of the file in bytes |
↳ createdDateTime | string | When the file was created |
↳ lastModifiedDateTime | string | When the file was last modified |
fileCount | number | Number of files uploaded |
skippedFiles | array | Files that were skipped before upload |
↳ name | string | File name |
↳ size | number | File size in bytes |
↳ limit | number | Upload size limit in bytes |
↳ reason | string | Reason the file was skipped |
skippedCount | number | Number of files skipped |
errors | array | Per-file upload errors |
↳ name | string | File name |
↳ error | string | Error message |
↳ status | number | HTTP status from Microsoft Graph |
Download a file from a SharePoint document library
| Parameter | Type | Required | Description |
|---|
driveId | string | Yes | The ID of the document library (drive). Example: b!abc123def456 |
driveItemId | string | Yes | The ID of the file (drive item) to download |
fileName | string | No | Optional filename override (e.g., "report.pdf", "data.xlsx") |
| Parameter | Type | Description |
|---|
file | file | Downloaded file stored in execution files |
Get metadata for a file or folder in a SharePoint document library
| Parameter | Type | Required | Description |
|---|
driveId | string | Yes | The ID of the document library (drive). Example: b!abc123def456 |
driveItemId | string | Yes | The ID of the file or folder (drive item) to retrieve |
| Parameter | Type | Description |
|---|
driveItem | object | Metadata for the SharePoint file or folder |
↳ id | string | The unique ID of the drive item |
↳ name | string | The name of the file or folder |
↳ webUrl | string | The URL to access the item |
↳ size | number | The size of the item in bytes |
↳ createdDateTime | string | When the item was created |
↳ lastModifiedDateTime | string | When the item was last modified |
↳ file | object | Present if the item is a file (contains mimeType) |
↳ folder | object | Present if the item is a folder (contains childCount) |
↳ parentReference | object | Reference to the parent folder/drive |
Delete a file (or folder) from a SharePoint document library
| Parameter | Type | Required | Description |
|---|
driveId | string | Yes | The ID of the document library (drive). Example: b!abc123def456 |
driveItemId | string | Yes | The ID of the file (drive item) to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the file was deleted |
itemId | string | The ID of the deleted file |