Slack

Slack 是一种团队通信工具，可将所有团队通信汇集在一个位置，随时随地立即搜索和可用。

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

服务 Class 区域
Copilot Studio 标准 除以下各项外的所有 Power Automate 区域 ：
     - 由世纪互联运营的中国云
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 标准 除以下各项外的所有 Power Apps 区域 ：
     - 由世纪互联运营的中国云
Power Automate 标准 除以下各项外的所有 Power Automate 区域 ：
     - 由世纪互联运营的中国云
联系人​​
Name Microsoft
URL https://support.microsoft.com/contactus
连接器元数据
发布者 Microsoft
Website https://slack.com/
隐私策略 https://slack.com/privacy-policy
Categories 协作;通信

已知问题和限制

  1. 根据 Slack API 文档，连接器使用的一些 Slack API 方法将在 2021 年 2 月停止运行，并且不适用于 2020 年 6 月 10 日之后新建的应用。 因此，请使用以下作的最新版本。

    操作：

  2. 创建组 已弃用，请使用最新版本的 “创建频道” 创建专用频道。

  3. 消息中的最大字符数限制为 4000。 有关更多详细信息，请参阅 Slack 的官方文档。

连接器深入

有关连接器的详细信息，请参阅 深入部分。

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒
触发器轮询的频率 1 120 秒

操作

列出公共频道

列出 slack 中的公共频道。
列出公共频道（分页支持）（预览版）

列出 slack 中的公共频道。
列出对话消息（预览版）

列出在对话中发布的消息（公共频道、专用频道、直接消息或组直接消息）。
列出通道 [已弃用]

此作已弃用。 请改用“列出公共频道”（分页支持）。

列出 Slack 中的通道。
列出邮件回复（预览版）

列出消息线程中的回复，包括父消息。
创建组 [已弃用]

在 Slack 中创建组。
创建通道 [已弃用]

此作已弃用。 请改用 “创建通道 ”。

在 Slack 中创建通道。
创建频道

在 Slack 中创建通道。
加入公共频道

在 Slack 中加入公共频道。
加入通道 [已弃用]

此作已弃用。 请改用 “加入公共频道 ”。

在 Slack 中加入频道。
发布消息 [已弃用]

此作已弃用。 请改用“发布”消息（V2）。

此作用于将消息发布到指定的通道。
发布消息 （V2）

此作用于将消息发布到指定的通道。
获取用户配置文件（预览版）

获取 Slack 用户的配置文件信息。 用于解析列表对话消息或列表邮件答复返回的邮件的作者。
设置请勿打扰

设置用户的“请勿打扰”状态。

列出公共频道

操作 ID:
ListChannels_V2

列出 slack 中的公共频道。

参数

名称 密钥 必需 类型 说明
对话类型
 types string

要包括的逗号分隔对话类型。 默认为public_channel。 显式包含private_channel、im 或 mpim 以列出其他聊天类型。
排除存档
 exclude_archived boolean

设置为 true 以排除存档的对话。
最大结果
 limit integer

要返回的最大会话数。
团队 ID
 team_id string

编码的团队 ID。仅组织范围的令牌是必需的。
Cursor
 cursor string

上一请求返回的分页游标。

返回

Body
ListChannels_Response

列出公共频道（分页支持）（预览版）

操作 ID:
ListChannels_V3

列出 slack 中的公共频道。

返回

Body
ListChannels_ResponseV3

列出对话消息（预览版）

操作 ID:
ListConversationMessages

列出在对话中发布的消息（公共频道、专用频道、直接消息或组直接消息）。

参数

名称 密钥 必需 类型 说明
对话 ID
 channel True string

要从中提取消息的会话。
最大结果
 limit integer

每页返回的最大消息数。
最早的时间戳
 oldest string

只有在此 Unix 时间戳之后的消息才会包含在结果中。
最新时间戳
 latest string

只有在此 Unix 时间戳之前的消息才会包含在结果中。
包含
 inclusive boolean

在结果中包含具有最早或最新时间戳的消息。
包括所有元数据
 include_all_metadata boolean

返回与每个消息关联的所有元数据。

返回

Body
ListMessages_Response

列出通道 [已弃用]

操作 ID:
ListChannels

此作已弃用。 请改用“列出公共频道”（分页支持）。

列出 Slack 中的通道。

返回

Body
ListChannels_Response

列出邮件回复（预览版）

操作 ID:
ListMessageReplies

列出消息线程中的回复，包括父消息。

参数

名称 密钥 必需 类型 说明
对话 ID
 channel True string

包含线程的会话。
父消息时间戳
 ts True string

启动线程的父消息的时间戳。 作为 ts 列表对话消息返回的消息的字段可用。
最大结果
 limit integer

每页返回的最大消息数。
最早的时间戳
 oldest string

只有在此 Unix 时间戳之后的消息才会包含在结果中。
最新时间戳
 latest string

只有在此 Unix 时间戳之前的消息才会包含在结果中。
包含
 inclusive boolean

在结果中包含具有最早或最新时间戳的消息。

返回

Body
ListMessages_Response

创建组 [已弃用]

操作 ID:
CreateGroup

在 Slack 中创建组。

参数

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

组的名称。

返回

名称 路径 类型 说明
Id
 group.id string

组的 ID。
Name
 group.name string

组的名称。

创建通道 [已弃用]

操作 ID:
CreateChannel

此作已弃用。 请改用 “创建通道 ”。

在 Slack 中创建通道。

参数

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

新通道的名称。

返回

Body
CreateChannel_Response

创建频道

操作 ID:
CreateChannel_V2

在 Slack 中创建通道。

参数

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

新通道的名称。
专用频道是吗？
 is_private boolean

频道为专用频道

返回

Body
CreateChannel_Response

加入公共频道

操作 ID:
JoinChannel_V2

在 Slack 中加入公共频道。

参数

名称 密钥 必需 类型 说明
通道名称
 channel string

通道的名称。

返回

Body
JoinChannel_ResponseV2

加入通道 [已弃用]

操作 ID:
JoinChannel

此作已弃用。 请改用 “加入公共频道 ”。

在 Slack 中加入频道。

参数

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

通道的名称。

返回

Body
JoinChannel_Response

发布消息 [已弃用]

操作 ID:
PostMessage

此作已弃用。 请改用“发布”消息（V2）。

此作用于将消息发布到指定的通道。

参数

名称 密钥 必需 类型 说明
通道名称
 channel True string

要向其发送消息的通道、专用组或 IM 通道。 可以是名称（例如：#general）或编码的 ID。
消息正文
 text True string

要发送的消息正文（少于 4000 个字符）。 有关格式设置选项，请参阅 https://api.slack.com/docs/formatting。
机器人名称
 username string

机器人的名称。
发布为用户
 as_user boolean

传递 true 以将消息作为经过身份验证的用户而不是机器人发布。
分析模式
 parse string

更改消息的处理方式。 有关详细信息，请参阅 https://api.slack.com/docs/formatting。
链接名称
 link_names integer

查找和链接频道名称和用户名。
展开链接
 unfurl_links boolean

传递 true 以启用主要基于文本的内容的展开。
展开媒体
 unfurl_media boolean

传递 false 以禁用媒体内容的展开。
图标 URL
 icon_url uri

要用作此消息图标的图像的 URL。
图标表情符号
 icon_emoji string

用作此消息图标的表情符号。

返回

名称 路径 类型 说明
成功结果
 ok boolean

指示作是否成功。
通道
 channel string

消息发布到的通道。
已创建 Date-Time
 ts string

yyyy-MM-ddTHH：mm：ss.fffZ
消息正文
 message.text string

消息正文。
消息 ID
 message.id string

消息的唯一标识符。
创建者 ID
 message.user string

发布消息的用户的唯一标识符。
创建时间
 message.created integer

创建消息时的 Unix 时间戳。
已删除
 message.is_user-deleted boolean

消息是否已删除。
错误消息
 error string

错误消息的详细信息（如果有）。

发布消息 （V2）

操作 ID:
PostMessage_V2

此作用于将消息发布到指定的通道。

参数

名称 密钥 必需 类型 说明
通道名称
 channel True string

要向其发送消息的通道、专用组或 IM 通道。 可以是名称（例如：#general）或编码的 ID。
消息正文
 text True string

要发送的消息正文。 Slack API 将截断包含 40,000 个字符以上的消息。 有关格式设置选项，请参阅 https://api.slack.com/docs/formatting
父消息时间戳
 thread_ts string

在线程中发布回复时父消息的时间戳。
广播到频道
 reply_broadcast boolean

传递 true 以同时向通道发送线程回复。
机器人名称
 username string

机器人的名称。
发布为用户
 as_user boolean

传递 true 以将消息作为经过身份验证的用户而不是机器人发布。
分析模式
 parse string

更改消息的处理方式。 有关详细信息，请参阅 https://api.slack.com/docs/formatting
Slack 标记分析
 mrkdwn boolean

Slack 标记分析设置。 默认启用。
链接名称
 link_names integer

查找和链接频道名称和用户名。
展开链接
 unfurl_links boolean

传递 true 以启用主要基于文本的内容的展开。
展开媒体
 unfurl_media boolean

传递 false 以禁用媒体内容的展开。
图标 URL
 icon_url uri

要用作此消息图标的图像的 URL。
图标表情符号
 icon_emoji string

用作此消息图标的表情符号。

返回

发布到 Slack 通道的消息的详细信息。

Body
PostMessageResponse

获取用户配置文件（预览版）

操作 ID:
GetUserProfile

获取 Slack 用户的配置文件信息。 用于解析列表对话消息或列表邮件答复返回的邮件的作者。

参数

名称 密钥 必需 类型 说明
用户 ID
 user True string

要获取其配置文件信息的用户的 ID。

返回

Body
GetUserProfile_Response

设置请勿打扰

操作 ID:
SetDND

设置用户的“请勿打扰”状态。

参数

名称 密钥 必需 类型 说明
分钟数
 num_minutes string

设置的分钟数不会打扰。

返回

名称 路径 类型 说明
已启用暂停
 snooze_enabled boolean

是否启用暂停。

触发器

创建文件时

创建文件时

创建文件时

操作 ID:
OnNewFile

创建文件时

参数

名称 密钥 必需 类型 说明
通道
 channel True string

通道的名称。

返回

名称 路径 类型 说明
Id
 id string

文件的 ID
已创建
 created integer

创建文件时。
Name
 name string

文件的名称。
Title
 title string

文件的标题。

定义

通道

频道

名称 路径 类型 说明
Id
 id string

通道的 ID。
Name
 name string

通道的名称。
是公共频道
 is_channel boolean

此对话是否为公共频道。
专用频道
 is_group boolean

此对话是否为私人频道。
是直接消息
 is_im boolean

此对话是否是两个用户之间的直接消息。
是组直接消息
 is_mpim boolean

此对话是否为组直接消息。
专用
 is_private boolean

此对话是否为专用对话。
已存档
 is_archived boolean

此对话是否已存档。
是成员
 is_member boolean

经过身份验证的用户是否是此对话的成员。
用户 ID
 user string

对于直接消息，会话中其他用户的 ID。
成员数
 num_members integer

此对话中的成员数。

ListChannels_Response

名称 路径 类型 说明
channels
 channels array of Channel
下一个游标
 response_metadata.next_cursor string

要传递给下一个请求的游标。 当没有更多结果时为空。

ListChannels_ResponseV3

名称 路径 类型 说明
value
 value array of Channel

SlackMessage

Slack 对话中发布的消息。

名称 路径 类型 说明
消息 ID
 ts string

消息的唯一时间戳标识符。
作者 ID
 user string

发布消息的用户的 ID。 使用“获取用户配置文件”将此解析为用户。
消息正文
 text string

消息正文。
消息类型
 type string

消息的类型。
线程 ID
 thread_ts string

父消息的时间戳（如果此消息是线程的一部分）。
回复计数
 reply_count integer

如果消息启动线程，则答复数。

ListMessages_Response

名称 路径 类型 说明
value
 value array of SlackMessage

SlackUserProfile

Slack 用户的其他配置文件详细信息。

名称 路径 类型 说明
显示名称
 display_name string

用户为其配置文件选择的显示名称。
实名
 real_name string

用户的名字和姓氏。
Email
 email string

用户的电子邮件地址。
虚拟形象 URL
 image_72 string

用户头像的 72x72 像素版本的 URL。

SlackUser

Slack 用户。

名称 路径 类型 说明
Id
 id string

用户的 ID。
用户名
 name string

用户的 Slack 用户名。
实名
 real_name string

用户的名字和姓氏。
是机器人
 is_bot boolean

用户是否为机器人。
已停用
 deleted boolean

用户帐户是否已停用。
时区
 tz string

用户的可读时区。
Profile
 profile SlackUserProfile

Slack 用户的其他配置文件详细信息。

GetUserProfile_Response

名称 路径 类型 说明
成功结果
 ok boolean

指示作是否成功。
用户
 user SlackUser

Slack 用户。
错误消息
 error string

错误消息的详细信息（如果有）。

CreateChannel_Response

名称 路径 类型 说明
通道
 channel Channel

频道

JoinChannel_Response

名称 路径 类型 说明
已在频道中
 already_in_channel boolean

用户是否已在频道中。
通道
 channel Channel

频道

JoinChannel_ResponseV2

名称 路径 类型 说明
通道
 channel Channel

频道
警告
 warning string

用户是否已在频道中。

PostMessageResponse

发布到 Slack 通道的消息的详细信息。

名称 路径 类型 说明
成功结果
 ok boolean

指示作是否成功。
通道
 channel string

消息发布到的通道。
创建时间
 ts string

创建消息时的 Unix 时间戳。
消息类型
 message.type string

消息的类型。
消息正文
 message.text string

消息正文。
创建时间
 message.ts string

创建消息时的 Unix 时间戳。
错误消息
 error string

错误消息的详细信息（如果有）。