Microsoft Teams 连接器

微软 365 连接器

用于与 Teams、Outlook 和 Office Suite 等 Microsoft 应用程序集成。

目的

使用本文档将 Tulip 应用程序与 Teams、Office 套件和 Outlook 等 Microsoft 365 产品集成。

前提条件

API 文档

微软图形 API 文档

此连接器所需的作用域

连接器功能

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 连接器