nBold (预览版)

Teams 模板和创建自动化,包含频道、文件模板、文件夹结构、Planner 模板和任务;Microsoft Teams 的治理自动化。

此连接器在以下产品和区域中可用:

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人​​
Name nBold 支持
URL https://docs.nbold.co/api
Email support@nbold.co
连接器元数据
发布者 nBold
网站 https://nbold.co
隐私策略 https://nbold.co/legal/privacy
类别 生产力;IT作

nBold 连接器

概述

使用 nBold 连接器,可以使用团队、频道、网站、规划器等构建自动化,以简化协作,更好地管理协作环境。 nBold 让我们使用频道、文件模板、文件夹结构、Planner 开发板等构建团队模板;大规模自动从模板创建团队。

Features

  • 从模板创建 Teams:使用频道、文件、文件夹、Planner、列表等创建新团队。
  • 批准或拒绝团队请求:批准或拒绝团队创建请求
  • 管理团队:检索团队详细信息、存档团队和访问协作模板。
  • 安全性和合规性:确保跨 Microsoft Teams 进行适当的治理和合规性。

先决条件

需要以下各项

  • 仅限 1 个帐户的Microsoft Power Apps 或 Power Automate 高级计划。
  • 对 nBold 的有效试用版或付费订阅。
  • nBold 已安装并已连接到租户。

Authentication

此连接器需要 OAuth 身份验证。 若要获取凭据,请执行以下作:

  1. 转到连接器并登录。
  2. 向应用授予许可
  3. 一切正常

Operations

Triggers

  • 请求团队创建审批时:提交团队创建审批请求时触发。
  • 批准团队创建时:在批准团队创建请求时触发。
  • 当团队创建被拒绝时:拒绝团队创建请求时触发。
  • 使用协作模板创建团队时:从协作模板成功创建团队时触发。

行动

  • 基于协作模板创建团队:使用预定义的协作模板创建新团队。
  • 检索模板:提取可用协作模板的列表。
  • 获取团队详细信息:检索特定团队的详细信息。
  • 存档团队:存档团队以限制活动。
  • 取消团队存档:将存档的团队还原到活动状态。
  • 邀请团队中的成员:向指定团队添加新成员。
  • 获取团队的频道:检索团队中的所有频道。
  • 在团队中创建频道:在指定团队中创建新频道。
  • 获取团队的主频道:提取团队的默认主频道。
  • 在团队频道中创建选项卡:将选项卡添加到团队中的特定频道。

有关更多详细信息,请访问 nBold API 文档

正在创建连接

连接器支持以下身份验证类型:

默认 用于创建连接的参数。 所有区域 不可共享

违约

适用:所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

取消存档团队 (预览版)

取消团队存档。

团队预配审批

团队预配的批准

在团队中创建频道 (预览版)

创建新的团队频道。

在团队频道中创建选项卡(预览版)

在团队频道中创建新选项卡。

基于协作模板创建团队(预览版)

基于协作模板创建团队预配作业。 此模板可能包括文件、文件夹、Planner 任务、专用频道...

存档团队(预览版)

存档团队。

批准团队请求(预览版)

此终结点允许管理员或授权用户根据提供的团队 ID 批准团队请求。 审批作会将团队状态更新为已批准。

拒绝团队创建请求(预览版)

拒绝团队创建请求。

生成 Webhook 的签名(预览版)

从机密和 Webhook 有效负载生成签名。

获取团队的主要频道(预览版)

获取团队的主要频道。

获取团队的频道(预览版)

获取团队的所有频道。

获取团队(预览版)

获取有关团队的详细信息。

获取我的 Teams 协作模板(预览版)

获取受访问群体目标规则筛选的连接用户可访问的团队协作模板。

邀请团队中的成员(预览版)

邀请团队成员作为成员或所有者。

取消存档团队 (预览版)

取消团队存档。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

返回

Urchiving 团队正文。

团队未存档
object

团队预配审批

团队预配的批准

参数

名称 密钥 必需 类型 说明
模板编号
id True string

模板的唯一标识符。

模板名称
templateName string

模板的名称。

Name
name True string

团队的名称。

Description
description string

团队的说明。

欢迎消息
welcomeMessage string

团队的欢迎信息。

Members
Members object
Owners
Owners object
Metadata
metadata object

审批请求的其他元数据。

返回

团队审批响应。

审批响应
object

在团队中创建频道 (预览版)

创建新的团队频道。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

显示名称
displayName True string

通道的名称

描述
description string

通道的简要说明

类型成员身份
membershipType True string

通道的成员身份类型(例如标准或专用)

返回

名称 路径 类型 说明
OData 元数据 URL
@odata.context uri

OData 上下文 URL

ID
id string

通道的唯一标识符

创建日期
createdDateTime date-time

创建通道时的时间戳

Name
displayName string

通道的名称

Description
description string

通道的简要说明

默认情况下收藏
isFavoriteByDefault boolean

指示通道是否默认被收藏

Email
email string

与频道关联的电子邮件地址(如果适用)

Web 链接
webUrl uri

用于访问通道的 Web URL

成员身份类型
membershipType string

通道的成员身份类型

存档状态
isArchived boolean

指示通道是否已存档

在团队频道中创建选项卡(预览版)

在团队频道中创建新选项卡。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

通道
channelId True string

团队频道 ID。

选项卡名称
displayName True string

选项卡的名称

Teams 应用绑定 URL
teamsApp@odata.bind True uri

要与选项卡关联的 Teams 应用的 OData 绑定 URL

选项卡实体 ID
entityId string

选项卡内容的唯一标识符

选项卡内容 URL
contentUrl uri

加载选项卡内容的 URL

选项卡网站 URL
websiteUrl uri

与选项卡关联的网站 URL

选项卡删除 URL
removeUrl uri

要删除/卸载选项卡的 URL

返回

名称 路径 类型 说明
ID
id string

团队频道选项卡 ID

显示名称
displayName string

团队频道选项卡显示名称

ID
configuration.entityId string

配置实体 ID

内容 URL
configuration.contentUrl string

配置内容 URL

网站 URL
configuration.websiteUrl string

配置网站 URL

删除 URL
configuration.removeUrl string

配置删除 URL

ID
teamsApp.id string

团队频道选项卡 Teams 应用 ID

外部 ID
teamsApp.externalId string

团队频道选项卡 Teams 应用外部 ID

显示名称
teamsApp.displayName string

团队频道选项卡 Teams 应用显示名称

分发方法
teamsApp.distributionMethod string

团队频道选项卡 Teams 应用分发方法

排序顺序索引
sortOrderIndex string

团队频道选项卡排序顺序索引

Web URL
webUrl string

团队频道选项卡 Web URL

基于协作模板创建团队(预览版)

基于协作模板创建团队预配作业。 此模板可能包括文件、文件夹、Planner 任务、专用频道...

参数

名称 密钥 必需 类型 说明
协作模板
id True string

协作模板 ID

工作组名称
name string

请求的团队名称

团队说明
description string

请求的团队说明

团队欢迎消息
welcomeMessage string

请求的团队欢迎消息

团队成员 ID
id string

团队成员 ID。

负责人 ID
id string

团队所有者 ID

Metadata
metadata object

作为 JSON 对象的其他元数据。 有关详细信息,请参阅 https://docs.nbold.co/api/latest/reference/Models/TeamProvisioningRequest

返回

名称 路径 类型 说明
ID
id string

创建时自动生成的作业 ID

日志
log array of string

JobLogsEntry 的集合。

类型
type string

作业类型(例如 ProvisioningRequest

状态
status string

作业当前状态

进展
progress integer

作业当前进度

数据
data object

作业数据(例如对象 ProvisioningRequest

存档团队(预览版)

存档团队。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

定义是否设置团队成员在与团队关联的 SharePoint Online 网站上只读的权限
shouldSetSpoSiteReadOnlyForMembers boolean

定义是否设置团队成员在与团队关联的 SharePoint Online 网站上只读的权限。

返回

团队存档正文。

团队存档
object

批准团队请求(预览版)

此终结点允许管理员或授权用户根据提供的团队 ID 批准团队请求。 审批作会将团队状态更新为已批准。

参数

名称 密钥 必需 类型 说明
审批请求
approvalRequestId True string

要批准的审批请求的 ID。

ID
id True string

通过指定用户 ID 来模拟审批者。 如果为空,则会自动分配为审批者。

Message
message string

要发送到请求者的消息。

Name
name string

重写请求者定义的团队名称。

Description
description string

重写请求者定义的团队说明。

欢迎消息
welcomeMessage string

重写请求者定义的欢迎消息。

返回

审批请求的响应。

审批请求正文
object

拒绝团队创建请求(预览版)

拒绝团队创建请求。

参数

名称 密钥 必需 类型 说明
审批请求
approvalRequestId True string

要拒绝的审批请求的 ID。

ID
id string

通过指定用户 ID 来模拟审批者。 如果为空,则会自动分配为审批者。

Message
message string

要发送到请求者的消息。

返回

审批请求拒绝的响应。

审批请求拒绝正文
object

生成 Webhook 的签名(预览版)

从机密和 Webhook 有效负载生成签名。

参数

名称 密钥 必需 类型 说明
机密
secret True password

Webhook 机密

有效负载
payload True object

Webhook 负载

返回

名称 路径 类型 说明
Signature
signature string

计算挂钩签名

获取团队的主要频道(预览版)

获取团队的主要频道。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

返回

名称 路径 类型 说明
ID
id string

团队频道 ID

创建日期时间
createdDateTime string

团队频道创建日期时间

显示名称
displayName string

团队频道显示名称

Description
description string

团队频道说明

会员资格类型
membershipType string

团队频道成员身份类型

获取团队的频道(预览版)

获取团队的所有频道。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

返回

名称 路径 类型 说明
团队频道
array of object

Microsoft Teams 团队的频道。

ID
id string

团队频道 ID

创建日期时间
createdDateTime string

团队频道创建日期时间

显示名称
displayName string

团队频道显示名称

Description
description string

团队频道说明

会员资格类型
membershipType string

团队频道成员身份类型

获取团队(预览版)

获取有关团队的详细信息。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

返回

名称 路径 类型 说明
团队 ID
id string

团队的唯一标识符

团队创建日期
createdDateTime date-time

创建团队时的时间戳

团队名称
displayName string

团队的名称

团队说明
description string

团队的简要说明

内部团队 ID
internalId string

团队的内部标识符

团队分类
classification string

团队分类(如果适用)

团队专用化
specialization string

团队的专用化类型

团队可见性
visibility string

团队的可见性

团队 Web 链接
webUrl uri

用于访问团队的 Web URL

团队存档状态
isArchived boolean

指示团队是否已存档

仅限所有者的成员身份
isMembershipLimitedToOwners boolean

指示成员身份是否限制为所有者

Teams 搜索
discoverySettings.showInTeamsSearchAndSuggestions boolean

Teams 搜索和建议。

标记设置
tagSettings object

与标记相关的设置

获取我的 Teams 协作模板(预览版)

获取受访问群体目标规则筛选的连接用户可访问的团队协作模板。

返回

名称 路径 类型 说明
Collection
value array of object

目录模板数组

ID
value.templateConfiguration.id string

协作模板 ID。

Name
value.templateConfiguration.name string

协作模板名称。

Description
value.templateConfiguration.description string

协作模板说明。

图片 URL
value.templateConfiguration.pictureUrl string

协作模板图片 URL。

语言
value.templateConfiguration.language string

协作模板语言。

已启用
value.templateConfiguration.enabled

定义是否启用协作模板。

需要
value.templateConfiguration.approval.requireApproval

定义协作模板是否需要审批。

团队成员
value.templateConfiguration.approval.approvalTeam array of object

审批团队的成员。

ID
value.templateConfiguration.approval.approvalTeam.id string

用户 ID (来自 Active Directory)

Name
value.templateConfiguration.approval.approvalTeam.name string

用户显示名称(来自 Active Directory)

Members
value.templateConfiguration.permanentMembership.members array of object

永久成员团队成员。

ID
value.templateConfiguration.permanentMembership.members.id string

用户 ID (来自 Active Directory)

Name
value.templateConfiguration.permanentMembership.members.name string

用户显示名称(来自 Active Directory)

Owners
value.templateConfiguration.permanentMembership.owners array of object

永久成员团队成员。

ID
value.templateConfiguration.permanentMembership.owners.id string

用户 ID (来自 Active Directory)

Name
value.templateConfiguration.permanentMembership.owners.name string

用户显示名称(来自 Active Directory)

已启用
value.templateConfiguration.audienceTargeting.enabled

特定于协作模板的访问群体。

规则
value.templateConfiguration.audienceTargeting.rules string

定义受众目标规则。

ID
value.clonedTeam.teamId string

协作模板源团队 ID。

Name
value.clonedTeam.teamName string

协作模板源团队名称。

Apps
value.clonedTeam.includeApps

定义是否应从源团队克隆应用。

选项卡
value.clonedTeam.includeTabs

定义是否应从源团队克隆选项卡。

设置
value.clonedTeam.includeSettings

定义是否应从源团队克隆团队设置。

渠道
value.clonedTeam.includeChannels

定义是否应从源团队克隆通道。

Membership
value.clonedTeam.includeMembers

定义成员身份(成员和所有者)。

命名约定
value.newTeam.namingConvention string

定义新团队名称的命名约定。

电子邮件约定
value.newTeam.emailConvention string

定义电子邮件的命名约定。

说明约定
value.newTeam.descriptionConvention string

定义新团队的说明约定。

欢迎消息约定
value.newTeam.welcomeMessageConvention string

定义新团队的欢迎消息约定。

默认团队名称
value.newTeam.defaultName string

定义默认团队名称。 在新的团队预配表单中。

默认团队说明
value.newTeam.defaultDescription

定义默认团队说明。 类型:字符串

默认欢迎消息
value.newTeam.defaultWelcomeMessage string

定义默认团队欢迎消息。

团队隐私
value.newTeam.teamPrivacy string

定义新的团队隐私级别(公共/专用)。

请求者所有权
value.newTeam.addRequesterAsTeamOwner

定义新团队的请求者。

邀请团队中的成员(预览版)

邀请团队成员作为成员或所有者。

参数

名称 密钥 必需 类型 说明
团队
teamId True string

团队 ID。

ID
id True string

用户 ID

团队成员身份角色
role True string

团队成员身份角色(成员/所有者)

返回

名称 路径 类型 说明
@odata.context
@odata.context string

OData 上下文 URL

@odata.type
@odata.type string

OData 类型标识符

ID
id string

唯一标识符

角色
role string

用户角色

displayName
displayName string

用户显示名称

历史记录开始日期时间
visibleHistoryStartDateTime date-time

可见历史记录的开始日期时间

用户 ID
userId string

用户标识符

Email
email email

用户电子邮件地址

租户 ID
tenantId string

租户标识符

触发器

使用协作模板创建团队时(预览版)

使用协作模板创建团队时。

团队创建被拒绝时(预览版)

团队创建被拒绝时。

批准团队创建时(预览版)

批准团队创建时。

请求团队创建审批时(预览版)

请求团队创建审批时。

使用协作模板创建团队时(预览版)

使用协作模板创建团队时。

参数

名称 密钥 必需 类型 说明
Webhook 名称
name True string

Name

Webhook 说明
description True string

Webhook 说明

机密
secret password

可用于验证 Webhook 通知消息的密钥

列出
id string

模板名称。

返回

名称 路径 类型 说明
相关 ID
correlation_id string

用于跟踪请求的唯一标识符。

凭据 ID
credentials.id string

凭据的唯一标识符。

凭据类型
credentials.type string

凭据类型(例如service_account)。

服务帐户对象 ID
credentials.service_account_object_id string

服务帐户的对象 ID。

服务帐户名称
credentials.service_account_name string

服务帐户的名称。

服务帐户 UPN
credentials.service_account_upn string

服务帐户的用户主体名称。

访问令牌
credentials.service_account_access_token string

服务帐户的访问令牌。

刷新令牌
credentials.service_account_refresh_token string

刷新服务帐户的令牌。

续订成功
credentials.renewal_success boolean

指示令牌续订是否成功。

续订错误消息
credentials.renewal_error_message string

令牌续订失败时出现错误消息。

授予的权限
credentials.granted_permissions string

授予服务帐户的权限。

缺少权限
credentials.missing_permissions string

服务帐户缺少的权限。

报表隐藏选项
credentials.reports_concealed_option boolean

指示报表是否被隐藏。

创建时间
credentials.created_at date-time

创建凭据时的时间戳。

已更新时间
credentials.updated_at date-time

上次更新凭据时的时间戳。

组织 ID
credentials.organization_id string

组织的标识符(如果适用)。

ID
tenant.id string

租户的唯一标识符。

租户 ID
tenant.tenant_id string

租户标识符。

团队 ID
team.id string

团队的唯一标识符。

显示名称
team.displayName string

团队的名称。

@odata.context
team.sharepoint.@odata.context string

SharePoint 网站的 OData 上下文。

Created DateTime
team.sharepoint.createdDateTime date-time

SharePoint 网站的创建日期和时间。

Description
team.sharepoint.description string

SharePoint 网站的说明。

SharePoint ID
team.sharepoint.id string

SharePoint 网站的标识符。

上次修改的 DateTime
team.sharepoint.lastModifiedDateTime date-time

SharePoint 网站的上次修改日期和时间。

Name
team.sharepoint.name string

SharePoint 网站名称。

Web URL
team.sharepoint.webUrl string

SharePoint 网站的 URL。

显示名称
team.sharepoint.displayName string

SharePoint 网站的显示名称。

team.sharepoint.root object

SharePoint 网站的根对象。

Hostname
team.sharepoint.siteCollection.hostname string

网站集的主机名。

模板编号
template.id string

模板的标识符。

模板名称
template.name string

模板的名称。

请求者 ID
requester.id string

请求者的唯一标识符。

显示名称
requester.displayName string

请求者的显示名称。

Email
requester.mail string

请求者的电子邮件地址。

交易 ID
metadata.deal_room_hs.deal_id string

HubSpot 交易的标识符。

创建时间
metadata.deal.createdAt date-time

交易创建时间戳。

已存档
metadata.deal.archived boolean

指示交易是否已存档。

交易 ID
metadata.deal.id string

交易的标识符。

金额
metadata.deal.properties.amount string

交易金额。

截止日期
metadata.deal.properties.closedate date-time

交易的预期收盘日期。

创建日期
metadata.deal.properties.createdate date-time

交易的创建日期。

交易名称
metadata.deal.properties.dealname string

交易的名称。

交易阶段
metadata.deal.properties.dealstage string

交易的当前阶段。

上次修改日期
metadata.deal.properties.hs_lastmodifieddate date-time

上次修改的时间戳。

HubSpot 对象 ID
metadata.deal.properties.hs_object_id string

HubSpot 交易的唯一标识符。

HubSpot 所有者 ID
metadata.deal.properties.hubspot_owner_id string

HubSpot 中的所有者标识符。

管道
metadata.deal.properties.pipeline string

销售管道标识符。

已更新时间
metadata.deal.updatedAt date-time

上次更新交易时的时间戳。

状态
status string

作的状态。

团队创建被拒绝时(预览版)

团队创建被拒绝时。

参数

名称 密钥 必需 类型 说明
Webhook 名称
name True string

Name

Webhook 说明
description True string

Webhook 说明

机密
secret password

可用于验证 Webhook 通知消息的密钥

返回

名称 路径 类型 说明
ID
tenant.id string

当前租户 ID

ID
requester.id string

请求者 ID

显示名称
requester.displayName string

请求者显示名称

Email
requester.mail string

请求者电子邮件

请求编号
approval.id string

审批请求 ID

ID
approval.approver.id string

审批者 ID

Message
approval.approver.message string

审批者消息

ID
template.id string

模板编号

Name
template.name string

模板名称

审批者
template.approvers array of object

审批者正文。

物品
template.approvers object

项正文

常任理事国和所有者
template.permanentMembership object

常任理事国和所有者

Name
request.team.name string

请求的团队名称

Description
request.team.description string

请求的团队说明

欢迎消息
request.team.welcomeMessage string

请求的团队欢迎消息

成员和所有者
request.membership object

请求的成员和所有者

批准团队创建时(预览版)

批准团队创建时。

参数

名称 密钥 必需 类型 说明
Webhook 名称
name True string

Name

Webhook 说明
description True string

Webhook 说明

机密
secret password

可用于验证 Webhook 通知消息的密钥

返回

名称 路径 类型 说明
ID
tenant.id string

当前租户 ID

ID
requester.id string

请求者 ID

显示名称
requester.displayName string

请求者显示名称

Email
requester.mail string

请求者电子邮件

请求编号
approval.id string

审批请求 ID

ID
approval.approver.id string

审批者 ID

Message
approval.approver.message string

审批者消息

ID
template.id string

模板编号

Name
template.name string

模板名称

审批者
template.approvers array of object

审批者正文。

物品
template.approvers object

项正文

常任理事国和所有者
template.permanentMembership object

常任理事国和所有者

Name
request.team.name string

请求的团队名称

Description
request.team.description string

请求的团队说明

欢迎消息
request.team.welcomeMessage string

请求的团队欢迎消息

成员和所有者
request.membership object

请求的成员和所有者

职位编号
provisioning.id string

预配作业 ID

请求团队创建审批时(预览版)

请求团队创建审批时。

参数

名称 密钥 必需 类型 说明
Webhook 名称
name True string

Name

Webhook 说明
description True string

Webhook 说明

机密
secret password

可用于验证 Webhook 通知消息的密钥

返回

名称 路径 类型 说明
ID
tenant.id string

当前租户 ID

ID
requester.id string

请求者 ID

显示名称
requester.displayName string

请求者显示名称

Email
requester.mail string

请求者电子邮件

请求编号
approval.id string

审批请求 ID

ID
approval.approver.id string

审批者 ID

消息
approval.approver.message string

审批者消息

ID
template.id string

模板编号

Name
template.name string

模板名称

Approval
template.approvers array of object

审批团队

物品
template.approvers object

项正文

常任理事国和所有者
template.permanentMembership object

常任理事国和所有者

Name
request.team.name string

请求的团队名称

Description
request.team.description string

请求的团队说明

欢迎消息
request.team.welcomeMessage string

请求的团队欢迎消息

成员和所有者
request.membership object

请求的成员和所有者

定义

对象

这是类型“object”。