Microsoft Teams 连接器

::（信息）（）要下载应用程序，请访问：图书馆::：

微软团队连接器

郁金香与 Microsoft Teams 集成

简介

Microsoft Teams API 允许用户创建、读取和编辑 Teams 中的 Microsoft 团队和频道，并为其 Microsoft 账户设置正确的访问权限。此连接器的目标是使用 HTTP 连接器，使用微软的 Graph API（v1.0）将 Tulip 与微软集成，并为我们的客户提供可导入其实例的开箱即用连接器。

目的

我们将重点介绍不同的连接器功能，这些功能可通过 HTTP 调用微软的 Graph API(v1.0) 与 M365 Teams 交互来构建，以展示可用于各种用例的各种团队读写操作。

API 文档

微软图形 API 文档

前提条件

1. 在 Microsoft 365 上创建账户，并在 Microsoft Entra ID 中配置 OAuth 2.0 凭据。
2. 在 Microsoft 门户中使用所需范围注册 API。Azure - Entra ID

设置 excel 连接器的视频：

您也可以按照同样的步骤设置团队连接器。

郁金香连接详细信息

需要在 Tulip 的

连接器。

1. 运行于：云连接器主机
2. 主机：graph.microsoft.com
3. 端口：443
4. TLS: 是

OAuth 2：身份验证将转发到所有

连接器功能

**重要提示：**1.这是 Tulip 通过 https 与 Microsoft 的连接。访问由 Microsoft 端的身份验证控制。根据用于验证的 Teams 帐户，用户将拥有相同的访问权限。在连接器功能中，您可以进一步配置权限和访问级别。

连接器功能

1) 获取所有团队

目的

该连接器将使用用户的 Microsoft 团队账户获取其所属的所有团队。

端点

HTTP GET 调用端点 - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

所需输入

无需输入

所需输出提取器

1. teamID： 用于执行其他任务的团队的唯一标识符。
2. teamName：团队名称：团队的显示名称。
3. teamDescription：团队描述：团队描述。

2) 获取团队的所有频道

目的

此连接器将通过输入 teamID 获取团队的所有频道。

终端

HTTP GET 调用端点 - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

所需输入

以下是需要传递的 URL 参数

1. 团队 ID

所需输出提取器

1. channelId：通道的唯一标识符，用于执行其他任务。
2. channelName：频道的显示名称。
3. channelDescription：通道描述：频道的描述。

3) 创建新频道

目的

1. 用户可以输入团队 ID、频道名称和频道描述，Tulip 将根据提供的频道名称创建一个新频道。API 的响应将是频道的元数据和各种属性。这可进一步用于从频道中获取和更新数据。
2. 从 Microsoft Graph V1.0 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用，这些变量将被输送到其他连接器功能中。

端点

HTTP POST 调用端点 - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

所需输入

以下是作为请求体发送的参数

1. 团队 ID
2. 通道名称
3. 通道描述

必填输出提取器

1. channelId：通道的唯一标识符，用于执行其他任务。
2. channelName：通道的显示名称。
3. channelDescription：通道描述。

4) 更新通道属性

目的

1. 用户可以将团队 ID、频道 ID、新频道名称和新频道描述作为输入，Tulip 将根据提供的新频道名称和描述更新新频道。API 的响应将是频道的元数据和各种属性。这可进一步用于从频道中获取和更新数据。
2. 从 Microsoft Graph V1.0 API 提取的信息可在 Tulip 应用程序、Tulip 表或 Tulip 变量中进一步使用，这些变量将被输送到其他连接器功能中。

端点

HTTP PATCH 调用端点 https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

所需输入

以下是作为 URL 和/或请求体的一部分发送的参数

1. 团队 ID
2. 通道 ID
3. 通道名称
4. 通道描述

所需的输出提取器

我们不需要任何输出提取器。

5) 向频道发送消息

目的

用户可将团队 ID、频道 ID、主题和信息内容作为输入，Tulip 将根据提供的信息内容发送信息。

端点

HTTP POST 调用端点 - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

所需输入

以下是作为 URL 和/或请求正文的一部分发送的参数

1. 团队 ID
2. 频道 ID
3. 主题
4. 信息内容

所需的输出提取器

我们不需要任何输出提取器。

6) 获取特定频道的所有信息

目的

此连接器将获取特定频道的所有消息。

端点

HTTP GET 调用端点 - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

所需输入

以下是需要传递的 URL 参数。

1. 团队 ID
2. 通道 ID

所需输出提取器

1. messageId：用于执行其他任务的消息的唯一标识符。
2. messageContent（信息内容）：信息内容。
3. messageFrom：发件人的显示名称。

7)回复信息

目的

用户可将团队 ID、频道 ID、主题和信息内容作为回复信息的输入，郁金香将根据提供的信息内容发送回复。

端点

HTTP POST 调用端点 - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

所需输入

以下是作为 URL 和/或请求正文的一部分发送的参数

1. 团队 ID
2. 频道 ID
3. 信息 ID
4. 信息内容

所需的输出提取器

我们不需要任何输出提取器。

8) 删除频道

目的

用户可将团队 ID 和频道 ID 作为输入，Tulip 将根据所提供的输入删除特定频道。

端点

调用 HTTP DELETE 端点 -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

所需输入

以下是需要传递的 URL 参数

1. 团队 ID
2. 通道 ID

所需的输出提取器

我们不需要任何输出提取器。

9) 获取团队成员名单

目的

此连接器将获取特定团队的所有成员。

端点

HTTP GET 调用端点 https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

所需输入

以下是需要传递的 URL 参数。

1. 团队 ID

所需输出提取器

1. 成员 ID：成员的唯一标识符。
2. 成员姓名：成员的显示名称。
3. 成员电子邮件 ID：成员的电子邮件 ID。
4. 成员角色：成员在团队频道中的角色。

更多阅读

查看有关 Microsoft 连接器的更多信息

• 微软日历连接器
• Microsoft Outlook 连接器
• 微软 Excel 连接器