Slack
Slack 是一種團隊溝通工具，可將您的所有團隊溝通集中在一個地方，無論您身在何處，都可以立即搜索和使用。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 由 21Vianet 營運的中國雲 |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL | https://support.microsoft.com/contactus |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://slack.com/ |
| 隱私策略 | https://slack.com/privacy-policy |
| 類別 | 通敵;傳達 |
已知問題和限制
根據 Slack API 文檔，連接器使用的某些 Slack API 方法將在 2021 年 2 月停止運行，並且在 2020 年 6 月 10 日之後將無法與新創建的應用程序一起使用。 因此，請使用以下操作的最新版本。
動作：
訊息中的字元數上限限制為 4000。 有關更多詳細信息，請參閱 Slack 的 官方文件。
連接器深入
有關連接器的更多資訊，請參閱 深入部分。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 120 秒 |
動作
| 列出公用頻道 （分頁支援） （預覽版） |
列出 Slack 中的公共頻道。 |
| 列出公開頻道 |
列出 Slack 中的公共頻道。 |
| 列出對話訊息（預覽） |
列出對話中發布的訊息（公開頻道、私人頻道、私訊或群組私訊）。 |
| 列出頻道 [已淘汰] |
此動作已被取代。 請改用 列出公用頻道 （分頁支援）。
|
| 加入公開頻道 |
加入 Slack 中的公開頻道。 |
| 加入頻道 [已淘汰] |
此動作已被取代。 請改用 加入公開頻道 。
|
| 取得使用者資料（預覽） |
取得 Slack 用戶的個人檔案資訊。 對於解決由列表對話訊息或列表訊息回覆回覆的訊息作者時非常有用。 |
| 建立群組 [已棄用] |
在 Slack 中建立群組。 |
| 建立頻道 |
在 Slack 中建立頻道。 |
| 建立頻道 [已棄用] |
此動作已被取代。 請改用 建立頻道 。
|
| 張貼訊息 [已棄用] |
此動作已被取代。 請改用「 張貼訊息 （V2）」 。
|
| 清單訊息回覆（預覽） |
在訊息串中列出回覆，包括父訊息。 |
| 設置請勿打擾 |
設定使用者的請勿打擾狀態。 |
| 貼文訊息 （V2） |
此作業可用來將訊息張貼至指定的通道。 |
列出公用頻道 （分頁支援） （預覽版）
列出公開頻道
列出 Slack 中的公共頻道。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
對話類型
|
types | string |
包含逗號分隔的對話類型。 預設是public_channel。 明確包含 private_channel、IM 或 MPIM，以列出其他對話類型。 |
|
|
排除 已存檔
|
exclude_archived | boolean |
設為 true，以排除存檔對話。 |
|
|
最大結果
|
limit | integer |
最多要回傳的對話數量。 |
|
|
小組標識碼
|
team_id | string |
編碼的隊伍識別碼。只有組織性代幣才需要。 |
|
|
Cursor
|
cursor | string |
頁碼游標依先前請求返回。 |
傳回
列出對話訊息（預覽）
列出對話中發布的訊息（公開頻道、私人頻道、私訊或群組私訊）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
交談 Id
|
channel | True | string |
對話用來取訊息。 |
|
最大結果
|
limit | integer |
每頁最多可回傳的訊息數。 |
|
|
最古老的時間戳記
|
oldest | string |
只有此 Unix 時間戳之後的訊息才會包含在結果中。 |
|
|
最新時間戳記
|
latest | string |
結果中僅包含此 Unix 時間戳之前的訊息。 |
|
|
包含項
|
inclusive | boolean |
在結果中加入帶有最舊或最新時間戳記的訊息。 |
|
|
包含所有元資料
|
include_all_metadata | boolean |
回傳與每則訊息相關的所有元資料。 |
傳回
列出頻道 [已淘汰]
加入公開頻道
加入頻道 [已淘汰]
取得使用者資料（預覽）
取得 Slack 用戶的個人檔案資訊。 對於解決由列表對話訊息或列表訊息回覆回覆的訊息作者時非常有用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者 ID
|
user | True | string |
使用者的 ID 以取得個人檔案資訊。 |
傳回
建立群組 [已棄用]
在 Slack 中建立群組。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | string |
群組的名稱。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
group.id | string |
群組的識別碼。 |
|
名稱
|
group.name | string |
群組的名稱。 |
建立頻道
在 Slack 中建立頻道。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | string |
新通道的名稱。 |
|
|
是私人頻道嗎？
|
is_private | boolean |
頻道是否私有 |
傳回
建立頻道 [已棄用]
張貼訊息 [已棄用]
此動作已被取代。 請改用「 張貼訊息 （V2）」 。
此作業可用來將訊息張貼至指定的通道。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頻道名稱
|
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 |
表情符號用作此消息的圖標。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功結果
|
ok | boolean |
指出作業是否成功。 |
|
Channel
|
channel | string |
訊息張貼到的通道。 |
|
創建 Date-Time
|
ts | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
訊息文字
|
message.text | string |
訊息內文。 |
|
訊息標識碼
|
message.id | string |
訊息的唯一識別碼。 |
|
創作者 ID
|
message.user | string |
張貼訊息之使用者的唯一識別碼。 |
|
創建時間
|
message.created | integer |
建立訊息時的 Unix 時間戳記。 |
|
已刪除
|
message.is_user-deleted | boolean |
訊息是否已刪除。 |
|
錯誤訊息
|
error | string |
錯誤訊息的詳細資料 （如果有的話）。 |
清單訊息回覆（預覽）
在訊息串中列出回覆，包括父訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
交談 Id
|
channel | True | string |
包含這條線索的對話。 |
|
父訊息時間戳記
|
ts | True | string |
啟動該執行緒的父訊息的時間戳記。 可作為 |
|
最大結果
|
limit | integer |
每頁最多可回傳的訊息數。 |
|
|
最古老的時間戳記
|
oldest | string |
只有此 Unix 時間戳之後的訊息才會包含在結果中。 |
|
|
最新時間戳記
|
latest | string |
結果中僅包含此 Unix 時間戳之前的訊息。 |
|
|
包含項
|
inclusive | boolean |
在結果中加入帶有最舊或最新時間戳記的訊息。 |
傳回
設置請勿打擾
設定使用者的請勿打擾狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
分鐘數
|
num_minutes | string |
設置的分鐘數請勿打擾。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已啟用貪睡
|
snooze_enabled | boolean |
是否啟用貪睡。 |
貼文訊息 （V2）
此作業可用來將訊息張貼至指定的通道。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
頻道名稱
|
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 |
通過真（pass 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 頻道的訊息詳細資訊。
觸發程序
| 建立檔案時 |
建立檔案時 |
建立檔案時
建立檔案時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Channel
|
channel | True | string |
頻道的名稱。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
檔案的 ID |
|
已建立
|
created | integer |
建立檔案的時間。 |
|
名稱
|
name | string |
檔案的檔名。 |
|
Title
|
title | string |
檔案的標題。 |
定義
Channel
頻道
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
通道的識別碼。 |
|
名稱
|
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
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
通道
|
channels | array of Channel | |
|
下一個游標
|
response_metadata.next_cursor | string |
游標要傳遞到下一個請求。 當沒有更多結果時，他會感到空虛。 |
ListChannels_ResponseV3
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of Channel |
SlackMessage
一則在 Slack 對話中發布的訊息。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息標識碼
|
ts | string |
訊息的唯一時間戳記識別碼。 |
|
作者編號
|
user | string |
發訊息的用戶身分。 用 Get User Profile 來解決這個問題給使用者。 |
|
訊息文字
|
text | string |
訊息內文。 |
|
訊息類型
|
type | string |
訊息的類型。 |
|
討論串編號
|
thread_ts | string |
如果父訊息是執行緒的一部分，則是父訊息的時間戳記。 |
|
回覆數
|
reply_count | integer |
如果這則訊息引發討論串，回覆的數量。 |
ListMessages_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of SlackMessage |
SlackUserProfile
Slack 用戶的額外個人資料。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
display_name | string |
使用者為其個人檔案選擇的顯示名稱。 |
|
真名
|
real_name | string |
使用者的名字和姓氏。 |
|
Email
|
string |
使用者的電子郵件地址。 |
|
|
頭像網址
|
image_72 | string |
使用者頭像的 72x72 像素版本網址。 |
SlackUser
一個 Slack 用戶。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
id | string |
用戶的識別碼。 |
|
使用者名稱
|
name | string |
該用戶的 Slack 用戶名。 |
|
真名
|
real_name | string |
使用者的名字和姓氏。 |
|
是機器人
|
is_bot | boolean |
使用者是否是機器人。 |
|
已停用
|
deleted | boolean |
使用者的帳號是否已被停用。 |
|
時區
|
tz | string |
使用者的人類可讀時區。 |
|
Profile
|
profile | SlackUserProfile |
Slack 用戶的額外個人資料。 |
GetUserProfile_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功結果
|
ok | boolean |
指出作業是否成功。 |
|
User
|
user | SlackUser |
一個 Slack 用戶。 |
|
錯誤訊息
|
error | string |
錯誤訊息的詳細資料 （如果有的話）。 |
CreateChannel_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Channel
|
channel | Channel |
頻道 |
JoinChannel_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已在頻道中
|
already_in_channel | boolean |
使用者是否已經在頻道中。 |
|
Channel
|
channel | Channel |
頻道 |
JoinChannel_ResponseV2
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Channel
|
channel | Channel |
頻道 |
|
警告
|
warning | string |
使用者是否已經在頻道中。 |
PostMessage回應
發佈到 Slack 頻道的訊息詳細資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功結果
|
ok | boolean |
指出作業是否成功。 |
|
Channel
|
channel | string |
訊息張貼到的通道。 |
|
創建時間
|
ts | string |
建立訊息時的 Unix 時間戳記。 |
|
訊息類型
|
message.type | string |
訊息的類型。 |
|
訊息文字
|
message.text | string |
訊息內文。 |
|
創建時間
|
message.ts | string |
建立訊息時的 Unix 時間戳記。 |
|
錯誤訊息
|
error | string |
錯誤訊息的詳細資料 （如果有的話）。 |