Slack

連線設定範例

本節列出您在建立連線時設定的各種欄位範例值。

Slack - UserToken 驗證連線類型

Slack - OAuth 2.0 驗證連線類型

實體、作業和動作

所有整合連接器都為已連結應用程式的物件提供一層抽象層。您只能透過這個抽象層存取應用程式的物件。抽象概念會以實體、作業和動作的形式提供給您。

• 實體： 實體可視為已連結應用程式或服務中的物件或屬性集合。實體的定義與連接器至連接器的定義不同。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可對實體執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體後，系統會產生可用於該實體的作業清單。如需作業的詳細說明，請參閱連接器工作中的實體作業。不過，如果連接器不支援任何實體作業，則 Operations 清單中不會列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合項目的一流函式。動作可讓您變更實體或多個實體，而這些變更會因連接器而異。通常，動作會包含一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會為空白。

動作

本節列出 Slack 連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

InviteUser 動作

這項操作會邀請使用者加入頻道。

InviteUser 動作的輸入參數

如需 InviteUser 動作的設定範例，請參閱「InviteUser 範例」。

CloseChannel 動作

這項動作會關閉即時訊息或多人即時訊息。

CloseChannel 的輸入參數

如需 CloseChannel 動作的設定範例，請參閱「CloseChannel 範例」。

JoinChannel 動作

這個動作可讓使用者加入現有的對話。

JoinChannel 的輸入參數

如需 JoinChannel 動作的設定範例，請參閱「JoinChannel 範例」。

LeaveChannel 動作

這項操作可讓使用者離開對話。

LeaveChannel 的輸入參數

如需 LeaveChannel 動作的設定範例，請參閱「LeaveChannel 範例」。

OpenChannel 動作

這項動作會開啟或繼續即時訊息或多人即時訊息。

OpenChannel 的輸入參數

如需 OpenChannel 動作的設定範例，請參閱「OpenChannel 範例」。

DownloadFile 動作

這項操作會下載檔案。

DownloadFile 的輸入參數

如需 DownloadFile 動作的設定範例，請參閱「DownloadFile 範例」。

EndDnd 動作

這項操作會結束使用者的勿擾模式。

EndDnd 動作的輸入參數

傳遞空白 JSON，例如 {}。

如需 EndDnd 動作的設定範例，請參閱「EndDnd 範例」。

SetSnooze 動作

這項動作會為使用者開啟請勿打擾模式，或變更其持續時間。

SetSnooze 動作的輸入參數

如需 SetSnooze 動作的設定方法範例，請參閱「SetSnooze 範例」。

EndSnooze 動作

這項操作會結束使用者的延遲模式。

EndSnooze 動作的輸入參數

傳遞空白 JSON，例如 {}。

如需 EndSnooze 動作的設定範例，請參閱「EndSnooze 範例」。

SendScheduleMessage 動作

這項操作會排定傳送訊息至頻道的時間。

SendScheduleMessage 動作的輸入參數

傳遞空白 JSON，例如 {}。

如需 SendScheduleMessage 動作的設定範例，請參閱「SendScheduleMessage 範例」。

行動號召範例

範例 - InviteUser

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 InviteUser 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ChannelId": "C06Q6NTRNA2",
     "Users": "U070MCLRREW"
   }

如果動作成功，InviteUser 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Success": "true"
}] 

範例 - CloseChannel

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 CloseChannel 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ChannelId": "C075U92TU4U"
   }

如果動作成功，CloseChannel 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Success": "true"
}] 

範例 - JoinChannel

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 JoinChannel 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ChannelId": "C06UMDTL1EH"
   }

如果動作成功，JoinChannel 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Success": "true"
}] 

範例 - LeaveChannel

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 LeaveChannel 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ChannelId": "C06UME4PM2R"
   }

如果動作成功，LeaveChannel 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Success": "true"
}]

範例：OpenChannel

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 OpenChannel 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "Users": "U06VCS3NDNC,U06NE4KAL0G",
   "ChannelId": "C071CU9UXFF"
   }

如果動作成功，OpenChannel 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
[{
"Success": "true"
}]

範例 - DownloadFile

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 DownloadFile 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "FileId": "F075UHEMSN8",
     "HasBytes": true
   }

如果動作成功，DownloadFile 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Success": "True",
  "ContentBytes": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA"
}]

其他事項

• 將「HasBytes」設為「True」，即可下載其他檔案格式 (例如 PDF 或 xlsx)，這些格式會以 Base 64 編碼格式提供內容。
• 如要下載 txt 格式的檔案，請將「HasBytes」設為「True」，並以位元組下載檔案內容。如要下載檔案的實際內容，請將「HasBytes」設為「False」。

範例 - EndDnd

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 EndDnd 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {}

如果動作成功，EndDnd 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Success": "true"
}]  

範例：SetSnooze

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 SetSnooze 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

    {
     "NumOfMinutes": "60"
   }

如果動作成功，SetSnooze 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
 [{
  "Success": "true",
  "SnoozeEnabled": "true",
  "SnoozeEndTime": "1722842455",
  "SnoozeRemaining": "3600",
  "SnoozeIsIndefinite": "false"
}]

範例 - EndSnooze

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 EndSnooze 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {}

如果動作成功，EndSnooze 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
  [{
  "Success": "true",
  "DndEnabled": "true",
  "NextDndStartTime": "1722875400",
  "NextDndEndTime": "1722911400",
  "SnoozeEnabled": "false"
}]

範例：SendScheduleMessage

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 SendScheduleMessage 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

    {
     "Channel": "C07AMLB39JN",
     "PostAt": "2024-08-27 14:15:00.0",
     "Text": "Hello, World!",
     "ReplyBroadCast": false
    }

如果動作成功，SendScheduleMessage 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
   [{
  "Success": "true",
  "ok": "true",
  "scheduled_message_id": "Q07KD4YSG72",
  "channel": "C07AMLB39JN",
  "post_at": "1724768100",
  "message_user": "U071FD3TS8P",
  "message_type": "message",
  "message_bot_id": "B076304QR9V",
  "message_app_id": "A076HCDGHT5",
  "message_text": "Hello, World!",
  "message_team": "T071W04MGV8",
  "message_bot_profile_id": "B076304QR9V",
  "message_bot_profile_deleted": "false",
  "message_bot_profile_name": "Googlecloud_OAuth_Slack",
  "message_bot_profile_updated": "1717513424",
  "message_bot_profile_app_id": "A076HCDGHT5",
  "message_bot_profile_icons_image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
  "message_bot_profile_icons_image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
  "message_bot_profile_icons_image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png",
  "message_bot_profile_team_id": "T071W04MGV8",
  "message_blocks_type": "rich_text",
  "message_blocks_block_id": "MYA",
  "message_blocks_elements_type": "rich_text_section",
  "message_blocks_elements_elements_type": "text",
  "message_blocks_elements_elements_text": "Hello, World!"
}]

實體操作範例

本節說明如何在這個連接器中執行部分實體作業。

範例：列出「Messages」實體的記錄

本範例會列出 Messages 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Messages。
3. 選取 List 作業，然後按一下「Done」。

您也可以對下列實體執行清單作業：Files、MessageReplies、Pins、Reactions、Reminders、TeamInfo、UserGroups、Users、Channels、DND、Teams、UserProfile、ScheduledMessages、TeamProfileFields 和 TeamProfileSections。

範例：取得「通話」實體的記錄

這個範例會擷取 Calls 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Calls。
3. 選取 Get 作業，然後按一下「Done」。
4. 將實體 ID 設為 R070LKL3YKX，這是要傳遞的金鑰。如要設定實體 ID，請在「Connectors」工作中的「Task Input」部分，按一下「EntityId」，然後在「Default Value」欄位中輸入 R070LKL3YKX。

實體 ID 的值必須直接傳遞。在這個範例中，R070LKL3YKX 是唯一的主鍵值，並直接傳遞。

您也可以對下列實體執行 get 作業：通話、訊息回覆、訊息、回應、團隊資訊、提醒、使用者和頻道

範例：刪除「通話」實體的記錄

此範例會刪除 Calls 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Calls。
3. 選取 Delete 作業，然後按一下「Done」。
4. 將實體 ID 設為 R074DSKVDSS，這是要傳遞的金鑰。如要設定實體 ID，請在「Connectors」工作中的「Task Input」部分，按一下「EntityId」，然後在「Default Value」欄位中輸入 R074DSKVDSS。

   如果實體有兩個複合式商家或主鍵，您可以將 filterClause 設為 Id='R074DSKVDSS'。

您也可以對下列實體執行刪除作業：檔案、訊息回覆、訊息、置頂、回應和提醒。

範例：建立「通話」實體的記錄

這個範例會建立 Calls 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Calls。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ExternalUniqueId": "c249a48c-a154-43d6-a286-791df11927a4",
     "JoinURL": "https://example55.com/call"
   }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
     "Id": "R074LBCFBU3"
   } 

範例：建立「Messages」實體的記錄

這個範例會建立 Messages 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Messages。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ChannelId": "C06UF15CB0V",
     "Text": "This is google cloud created Message"
   }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
   "Id": "1723008314.867479",
   "ChannelId": "C06UF15CB0V"
   }   

範例：建立 Pins 實體的記錄

這個範例會建立 Pins 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Pins。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "ChannelId": "C06UF15CB0V",
   "Id": "1723008314.867479",
   "Type": "message"
   }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
   "Id": "1723008314.867479",
   "Type": "message",
   "ChannelId": "C06UF15CB0V"
   }

範例：建立 Reactions 實體的記錄

這個範例會建立 Reactions 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Reactions。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ChannelId": "C06UPA4KRD0",
     "Id": "1716375032.038669",
     "Type": "message",
     "Name": "raised_hands"
   }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
     "Success": true
   }   

範例：建立提醒事項實體的記錄

這個範例會建立 Reminders 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Reminders。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "Text": "this is a reminder",
     "Time": "2025-10-15 14:30:00"
   }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
     "Id": "Rm074P0X9JCV"
   } 
    

範例：建立管道實體的記錄

這個範例會建立 Channels 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Channels。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "Name": "googlecloudcreatedchannel",
   "IsPublic": true
   } 

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
   "Id": "C074MBW5N2G"
   } 
     

範例：建立 MessageReplies 實體的記錄

這個範例會建立 MessageReplies 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 MessageReplies。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "ChannelId": "C076HCY07UN",
   "Text": "This is generated text",
   "ParentMessageId": "1717659095.881619"
   }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

    
   {
   "Id": "1717659183.033599",
   "ChannelId": C076HCY07UN,
   "ParentMessageId": "1717659095.881619"
   }
    

範例：更新「通話」實體的記錄

這個範例會更新 Calls 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Calls。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "JoinURL": "https://example55.com/call/google-cloud",
     "Title": "title"
   }

5. 將實體 ID 設為 R074LB76Q5R。如要設定實體 ID，請按一下「entityId」，然後在「Default Value」欄位中輸入 R074LB76Q5R。

   您可以將 filterClause 設為 R074LB76Q5R，而非指定 entityId。

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
     "Id": "null"
   }  

範例：更新「Messages」實體的記錄

這個範例會更新 Messages 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Messages。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "Text": "Google Cloud Updated Message"
   }  

5. 將 filterClause 設為 ChannelId = 'C06UPA4KRD0' 和 Id = '1716369465.000129'。如要設定 filterClause，請按一下「filterClause」，然後在「Default Value」欄位中輸入 ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129'。

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
     "Id": null,
     "ChannelId": null
   }  

範例：更新使用者實體的記錄

這個範例會更新 Users 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
     "ProfileDisplayName": "Vaibhav"
   } 

5. 將實體 ID 設為 U06Q6VDJYSU。如要設定實體 ID，請按一下「entityId」，然後在「Default Value」欄位中輸入 U06Q6VDJYSU。

   您可以將 filterClause 設為 U06Q6VDJYSU，而非指定 entityId。

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
   "Id": null
   } 

範例：更新頻道實體的記錄

這個範例會更新 Channels 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Channels。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "Purpose": "This is the one channel that will always include everyone."
   }

5. 將實體 ID 設為 C06MAP1JDSB。如要設定實體 ID，請按一下「entityId」，然後在「Default Value」欄位中輸入 C06MAP1JDSB。

   您可以將 filterClause 設為 C06MAP1JDSB，而非指定 entityId。

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
   "Id": "C06MAP1JDSB"
   }

範例：更新 MessageReplies 實體的記錄

這個範例會更新 MessageReplies 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 MessageReplies。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "Text": "Updated Text"
   }

5. 將 filterClause 設為 ChannelId = 'C06UPA4KRD0' 和 Id = '1716369465.000129'。如要設定 filterClause，請按一下「filterClause」，然後在「Default Value」欄位中輸入 ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129'。

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
   "Id": null,
   "ChannelId": null,
   "ParentMessageId": null
   }   

範例：更新 UserProfile 實體的記錄

這個範例會更新 UserProfile 實體的記錄。

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 UserProfile。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

    {
     "CustomFields": "{\"Xf079082Q70B\": {\"value\": \"Patna Bihar\",\"alt\": \"\"}}",
     "Phone": "8767787654",
     "StatusText": "Long train Journey to work"
    }

   如果整合成功，Connector 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
   
   }