共用方式為

Microsoft 團隊

Microsoft Teams 使您能夠使用 Microsoft 365 在團隊工作區中獲取所有內容、工具和對話。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 標準 除下列區域外的所有 Power Automate 區域 ：
     - 由 21Vianet 營運的中國雲
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure 中國區域
Power Apps 標準 除下列區域外的所有 Power Apps 區域 ：
     - 由 21Vianet 營運的中國雲
Power Automate（自動化服務） 標準 除下列區域外的所有 Power Automate 區域 ：
     - 由 21Vianet 營運的中國雲
連絡人​​
名稱 Microsoft
URL https://support.microsoft.com/en-us/contactus
連接器中繼資料
Publisher Microsoft
網站 https://products.office.com/microsoft-teams/group-chat-software
隱私策略 https://privacy.microsoft.com/
類別 通敵;傳達

動作的已知問題和限制

簡短描述 Operations 完整描述
訊息大小限制 張貼最適化卡片並等待回應

在聊天或頻道中張貼最適化卡片

在聊天室或頻道中張貼訊息

在頻道中回覆訊息

在頻道中使用最適化卡片回覆

更新聊天或頻道中的最適化卡片		 當動作張貼訊息時，訊息大小限制約為 28 KB。 此限制包括所有 HTML 元素，例如文字、影像、連結、表格、提及等。 如果訊息大小超過 28 KB，動作會失敗，並顯示錯誤「要求實體太大」。
將來賓使用者設定為小組擁有者 將成員新增至團隊 當您將成員新增至小組時，您可以將來賓使用者設定為小組擁有者。
需要 Exchange Online 信箱 建立 Teams 會議 當您建立 Teams 會議並想要選取時區時，此動作需要 Exchange 線上信箱。
每次聊天的使用者數上限 建立聊天室 當您建立聊天時，此動作每次聊天最多可以處理 20 個使用者，但不支援來賓使用者。
需要工作流程應用程式 張貼最適化卡片並等待回應

在聊天或頻道中張貼最適化卡片

在聊天室或頻道中張貼訊息

在頻道中回覆訊息

在頻道中使用最適化卡片回覆

更新聊天或頻道中的最適化卡片		 這些動作需要工作流程 （先前稱為 Power Automate） 應用程式可用性，並在 Teams 系統管理中心將應用程式設定為「允許」狀態。
無法與觸發器結合使用 當有人回應調適型卡片時 在聊天或頻道中張貼最適化卡片 在「觸發器 + 接聽程式」工作流程中使用此觸發器可能會導致提交卡片時出現「發生問題，請重試」錯誤。 發生此錯誤的原因是觸發流程 （在聊天或頻道中張貼最適化卡片） 在張貼卡片後未處理叫用回應。 相反地，接聽程式流程的設計目的是要擷取叫用回應事件並繼續處理。 不過，由於觸發程式流程不會處理回應，因此會傳回錯誤。 使用 貼文最適化卡片，並等候回應 作為替代方案。

觸發程式的已知問題和限制

簡短描述 Operations 完整描述
僅支援每個流程的使用者 新增聊天訊息時 當您在 Teams 參與者的任何聊天中張貼新的聊天訊息時，觸發程序每個流程只能支援一個使用者。
僅支持單個單詞 當提到關鍵字時 對於長度超過一個單詞的短語，觸發器不會觸發。
針對所有訊息相關資料引發 當提到關鍵字時 此資料包括訊息寄件者，以及包含傳送訊息時間的文字。
僅針對新增至頻道的根訊息引發 新增頻道訊息時 將新訊息張貼至 Teams 中的頻道時，觸發程式不會針對現有頻道訊息的回覆引發。
僅適用於預設環境 針對選取的訊息

從撰寫框 （V2）

當有人回應最適化卡片時		 這些觸發程式僅在預設環境中運作。
不適用於來賓或外部使用者 針對選取的訊息

當有人回應最適化卡片時		 此觸發程序不適用於小組中的來賓或外部使用者。
輪詢間隔為 3 分鐘 新增頻道訊息時

在頻道留言中被提及的時候		 這些觸發器使用 3 分鐘的輪詢間隔。
輪詢間隔為 5 分鐘 新增團隊成員時

移除新團隊成員時		 由於基礎 API 的限制，這些觸發器會使用 5 分鐘的輪詢間隔。 這可能會導致觸發程序針對同一事件多次觸發。
不適用於具有隱藏成員的統一群組 新增團隊成員時

移除新團隊成員時		 這些觸發器不適用於具有隱藏成員的統一群組。
需要 Power Automate Actions 應用程式 針對選取的訊息 在 Power Automate 中，此觸發程序要求必須解除封鎖 Power Automate Actions 應用程式 （應用程式識別碼：00001016-de05-492e-9106-4828fc8a8687）。 使用系統管理員帳戶來檢查應用程式是否已在 Teams 系統管理中心啟用。
Microsoft Cloud for Sovereignty 不支援 針對選取的訊息
從撰寫框		 GCC、GCCH 和 DoD 等主權雲端不支援這些觸發器。

一般已知問題和限制

  • 若要使用 Teams 連線器，您必須啟用其中一個 訂用帳戶。
  • 目前不支援將訊息或調適型卡片張貼至私人頻道。
  • 使用 Power Virtual Agents 張貼訊息或卡片需要收件者在 Microsoft Teams 中安裝機器人。 如需詳細資訊，請參閱 在 Microsoft Teams 中傳送主動訊息給使用者。
  • 單一訊息最多只能 @mention 有 20 位使用者和 20 個標籤。

Microsoft Teams Webhook

收到 Teams Webhook 要求時

作業標識碼：TeamsIncomingWebhookTrigger

此觸發程式可讓您向觸發程式公開的端點提出 POST 要求，以啟動流程。 您可以將要求本文中的調適型卡片陣列傳送至觸發程序，以用於流程的後續動作。 此觸發器僅支援POST請求，不支援GET請求。

不同於已取代的 Office Webhook，收到 Teams Webhook 要求時觸發程式可讓使用者指定是否允許任何人、租使用者中的任何使用者，或只允許租使用者中的特定使用者子集呼叫觸發程式。 此觸發程式也不支援可採取動作的訊息，不同於已取代的 Office Webhook。

當您儲存流程時，觸發器的回呼 URL 將顯示給您。 您也可以透過編輯您在 Power Automate 或 Teams 的 Power Automate 設計工具中建立的流程來存取回呼 URL。

如需如何撰寫調適型卡片的詳細資訊，請參閱： 建立將調適型卡片張貼至 Microsoft Teams 的流程，以及 調適型卡片架構最佳做法 和 調適型卡片設計工具。

要求內文結構描述

請求主體
名稱 Key 為必填項目 類型 Description
型別 型別 yes 字串 值應該一律是「訊息」
attachments attachments yes 物件陣列 調適型卡片專案物件的陣列。 如需物件架構，請參閱下方的 AdaptiveCardItemSchema 。
AdaptiveCardItemSchema
名稱 Key 為必填項目 類型 Description
內容類型 內容類型 yes 字串 值應該一律是 “application/vnd.microsoft.card.adaptive”
內容網址 內容網址 yes 字串 值應一律為 Null
內容 內容 yes 物件 以 JSON 格式化的調適型卡片物件。 如需範例和範本，請參閱 https://adaptivecards.io/samples

請求內文範例

    {
       "type":"message",
       "attachments":[
          {
             "contentType":"application/vnd.microsoft.card.adaptive",
             "contentUrl":null,
             "content":{
                "$schema":"http://adaptivecards.io/schemas/adaptive-card.json",
                "type":"AdaptiveCard",
                "version":"1.2",
                "body":[
                    {
                    "type": "TextBlock",
                    "text": "For Samples and Templates, see [https://adaptivecards.io/samples](https://adaptivecards.io/samples)"
                    }
                ]
             }
          }
       ]
    }

最適化卡片 JSON 檔案的屬性如下：

  • 欄位必須 "type" 是 "message"。
  • 陣列包含 "attachments" 一組卡片物件。
  • 欄位 "contentType" 必須設定為 [最適化卡片類型]。
  • 物件 "content" 是以 JSON 格式化的卡片。

  1. 使用 Postman 測試您的最適化卡片：

    1. 使用 Postman 測試最適化卡片，將 POST 要求傳送至 URL，以建立以設定傳入 Webhook。
    2. 將 JSON 檔案貼到要求本文中，並在 Teams 中檢視最適化卡片訊息。

小提示

使用最適化卡片 程式碼範例和範本 來測試 POST 要求的主體。

傳送請求的範例

範例程式碼參考

var adaptiveCardJson = @"{
  ""type"": ""message"",
  ""attachments"": [
    {
      ""contentType"": ""application/vnd.microsoft.card.adaptive"",
      ""content"": {
        ""type"": ""AdaptiveCard"",
        ""body"": [
          {
            ""type"": ""TextBlock"",
            ""text"": ""Message Text""
          }
        ],
        ""$schema"": ""http://adaptivecards.io/schemas/adaptive-card.json"",
        ""version"": ""1.2""
      }
    }
  ]
}";

var webhookUrl = "Retrieve this from the url of the trigger, e.g. https://xxxxx.logic.azure.com:443/xxxxxxxxx";

var client = new HttpClient();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var content = new StringContent(adaptiveCardJson, System.Text.Encoding.UTF8, "application/json");
var response = await client.PostAsync(webhookUrl, content);

參數

名稱 Key 為必填項目 類型 Description
觸發驗證類型 觸發驗證類型 字串 流程是否可以由任何人、租用戶中的任何使用者觸發，或只能由租用戶中的特定使用者觸發。
觸發允許使用者 觸發允許使用者 字串 允許觸發流程的使用者清單。 只有在 triggerAuthenticationType 設定為「租使用者中的特定使用者」時才使用。
  • 如果您選取「任何人」驗證選項，請勿傳遞驗證權杖標頭，否則對觸發程式的 POST 要求將會失敗。
  • 如果您選取 [我的租使用者中的任何使用者] 或 [我的租使用者中的特定使用者] 驗證選項，您必須將要求中的驗證權杖傳遞至 [收到 Teams Webhook 要求時] 觸發程序。
  • 您可以在下列檔中找到所需宣告的詳細資訊： 新增 HTTP 要求觸發程式的 OAuth 驗證

退貨

名稱 路徑 類型 Description
body body 物件 輸出與傳送至觸發器的要求內文相同，請參閱上述範例，以取得輸出或要求內文結構描述的範例

節流限制

名稱 限制 註釋
並行呼入通話 ~1,000 您可以視需要減少並行要求數目或縮短持續時間。
每 5 分鐘讀取通話次數 低 6,000 美元;所有其他 60,000 此限制適用於從雲端流程的執行歷程記錄取得原始輸入和輸出的呼叫。 您可以視需要將工作負載分散到多個流程中。
每 5 分鐘叫用呼叫 低 4,500;所有其他 45,000 您可以視需要將工作負載分散到多個流程。

正在建立連線

連接器支援下列驗證類型：
Microsoft Teams 認證 （Teams GCC High） 使用 Microsoft Teams 認證 （Teams GCC High） 登入。 僅限 Azure Government 不可共享
Microsoft Teams 認證 （Teams 公用/Teams GCC） 使用 Microsoft Teams 認證 （Teams Public/Teams GCC） 登入。 僅限 Azure Government 不可共享
預設值 使用您的憑據登錄。 Azure Government 以外的所有區域 不可共享

Microsoft Teams 認證 （Teams GCC High）

驗證 ID：oauthGccHigh

適用：僅限 Azure Government

使用 Microsoft Teams 認證 （Teams GCC High） 登入。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

Microsoft Teams 認證 （Teams 公用/Teams GCC）

驗證 ID：oauthPublic

適用：僅限 Azure Government

使用 Microsoft Teams 認證 （Teams Public/Teams GCC） 登入。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

預設

適用：Azure Government 以外的所有區域

使用您的憑據登錄。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒
觸發輪詢的頻率 1 600 秒
每個連線的非取得請求 （適用於清單聊天、張貼摘要通知、張貼最適化卡片作為 Flow 機器人，以及任何其他 Flow 機器人作業） 25 300 秒鐘
每個連線的非 Get 要求 （所有其他作業） 300 300 秒鐘

動作

使用頻道中的最適化卡片回覆

使用調適型卡片回覆頻道訊息
傳送 Microsoft Graph HTTP 要求

建構 Microsoft Graph REST API 要求，以針對 Microsoft Teams 端點叫用。 支援下列區段： 第一個區段：/teams、/me、/users、第二個區段：頻道、聊天、installedApps、訊息、釘選訊息。 深入了解：https://docs.microsoft.com/en-us/graph/use-the-api
列出團隊標籤的成員

列出團隊標籤的成員
列出團隊的所有標籤

列出團隊的標籤
列出已加入的團隊

列出您所屬的 Microsoft Teams 中的所有小組
列出成員

列出群組聊天或頻道的直接成員
列出所有頻道

列出特定小組的所有頻道，包括與小組共用的頻道
列出相關聯的團隊

列出您直接成員的所有團隊，或是團隊內部託管的共用頻道的成員。
列出聊天記錄

列出您最近參與的聊天記錄
列出頻道

列出特定小組的所有頻道
列出頻道訊息的回覆

列出特定小組中頻道中訊息的回覆。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
刪除團隊標籤

從小組中刪除標籤
取得使用者的@mention權杖

建立權杖，可插入訊息或最適化卡片 @mention 給使用者。
取得團隊標籤的@mention權杖

建立權杖，可插入到訊息或最適化卡片中，以通道中的使用者身分傳送至 @mention 小組標籤。
取得小組中特定頻道的詳細資料

取得頻道詳細資料
取得訊息

從特定小組中的頻道取得訊息。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
取得訊息詳細資料

取得聊天或頻道中訊息的詳細資料。
在聊天室或頻道中張貼訊息

將訊息張貼至聊天室或頻道
在頻道中回覆訊息

使用訊息回覆頻道訊息
將您自己的最適化卡片作為 Flow 機器人張貼給使用者 [已取代]

新增 JSON 卡片定義，以建立 Teams 使用者的自訂訊息。 訊息可以包含影像、圖表、文字等。
將您自己的最適化卡片作為 Flow 機器人發佈到管道 [已棄用]

新增 JSON 卡片定義，以建立 Teams 頻道的自訂貼文。 該帖子可以包含圖像、圖表、文本等。
將成員新增至團隊

在 Microsoft Teams 中將成員新增至小組
將成員新增至團隊標籤

將使用者新增至團隊標籤
將最適化卡片張貼至 Teams 頻道，並等候回應 [已淘汰]

輕鬆自動化將訊息傳送至 Teams 通道的程式，其中包含繼續等候流程的動作。
將訊息以 Flow 機器人的形式發佈給使用者 [已棄用]

輕鬆自動化向 Teams 中的某人發送消息的過程。
將訊息以 Flow 機器人身分發佈至頻道 [已棄用]

輕鬆自動化將訊息張貼至 Teams 頻道的程式。
將調適型卡片張貼至 Teams 使用者，並等候回應 [已取代]

輕鬆自動化將訊息傳送給 Teams 使用者的程式，其中包含繼續等候流程的動作。
將選項作為 Flow 機器人發佈給使用者

將一組選項傳送給 Microsoft Teams 使用者，他們必須先回應這些選項，才能繼續流程。 此動作會暫停流程，直到使用者回應選項為止
建立 Teams 會議

在邀請底部建立一個連結的會議，以在 Microsoft Teams 上線上加入會議。
建立團隊

在 Microsoft Teams 中建立新小組
建立小組的標籤

在小組中建立標籤
建立聊天室

創建一對一或群聊
建立頻道

在指定的小組內建立新頻道
張貼摘要通知

將通知張貼至連結至聊天或小組的使用者活動摘要。
張貼最適化卡片並等待回應

將調適型卡片張貼至聊天或頻道，並等候任何使用者的回應。 這會暫停流程，直到任何使用者回應為止。
張貼訊息 [已棄用]

將訊息張貼至特定小組中的頻道。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
張貼訊息 （V2） [已棄用]

將訊息張貼至特定小組中的頻道。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
張貼訊息 （V3） [已棄用]

將訊息張貼至特定小組中的頻道。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
張貼訊息回覆 [已棄用]

在特定小組的頻道中張貼訊息的回覆。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
張貼訊息回覆 （V2） [已淘汰]

在特定小組的頻道中張貼訊息的回覆。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
從團隊標籤中刪除成員

從團隊標籤中刪除成員
更新聊天或頻道中的最適化卡片

更新現有的最適化卡片
班次：列出所有交換班次要求 [已淘汰]

此動作已被取代。 請改用 列出團隊中的所有交換班次請求 。

此作業會傳回排程中的所有交換班次要求
班次：列出所有優惠班次要求 [已取代]

此動作已被取代。 請改用 列出團隊中的所有選件轉移請求 。

此作業會傳回排程中的所有優惠方案班次請求
班次：列出所有排程群組 [已淘汰]

此動作已被取代。 請改用 列出團隊中的所有排程群組 。

此作業會傳回排程中的所有排程群組
班次：列出所有班次 [已淘汰]

此動作已被取代。 請改用 列出團隊中的所有班次 。

此作業會傳回指派給小組成員的所有班次
班次：列出所有請假原因 [已棄用]

此動作已被取代。 請改用列出 團隊中的所有請假原因 。

此作業會傳回與小組相關聯的請假原因清單。
班次：列出所有請假申請 [已淘汰]

此動作已被取代。 請改用列出 團隊中的所有請假請求 。

此作業會傳回排程中的所有請假要求
班次：列出所有開啟的班次 [已棄用]

此動作已被取代。 請改用 列出團隊中的所有空缺班次 。

此作業會傳回小組中的所有空缺班次
班次：列出所有開啟的班次要求 [已淘汰]

此動作已被取代。 請改用 列出團隊中的所有 Open Shift 請求 。

此作業會傳回排程中的所有未結班次變更要求
班次：刪除班次 [已棄用]

此動作已被取代。 請改用 刪除班次 。

此作業會使用班次的唯一識別碼刪除班次。
班次：刪除開啟的班次 [已淘汰]

此動作已被取代。 請改用 刪除空缺班次 。

此作業會刪除空缺班次。
班次：取得排程的詳細資料 [已取代]

此動作已被取代。 請改用 [取得排程] 的詳細資料 。

此作業會使用排程的唯一識別碼傳回排程的詳細資料。
班次：取得排程群組 [已淘汰]

此動作已被取代。 請改用 取得排程群組 。

此作業會使用排程群組的唯一識別碼傳回詳細資料。
班次：取得班次 [已取代]

此動作已被取代。 請改用 Get a Shift 。

此作業會使用班次的唯一識別碼傳回班次的詳細資料。
班次：取得空缺班次 [已取代]

此動作已被取代。 請改用 Get an Open Shift 。

此作業會傳回未開班次的詳細資料。
班次：建立新的開放班次 [已淘汰]

此動作已被取代。 請改用 建立新的空缺班次 。

在排程中建立新的空缺班次
班次：拒絕交換班次要求 [已淘汰]

此動作已被取代。 請改用「 拒絕交換班次」請求 。

此作業可讓使用者拒絕交換班次要求。
班次：拒絕優惠班次請求 [已淘汰]

此動作已被取代。 請改用 拒絕優惠轉移請求 。

此作業可讓使用者拒絕優惠方案班次請求。
班次：拒絕請假申請 [已棄用]

此動作已被取代。 請改用「 拒絕請假申請 」。

此作業可讓經理拒絕請假請求。
班次：拒絕開啟的班次要求 [已棄用]

此動作已被取代。 請改用 拒絕 Open Shift 請求 。

此作業可讓經理拒絕未結班次要求。
班次：更新空缺班次 [已淘汰]

此動作已被取代。 請改用 更新空缺班次 。

更新排程中的空缺班次。
班次：核准交換班次要求 [已淘汰]

此動作已被取代。 請改用 核准交換班次 要求 。

此作業可讓使用者核准交換班次要求。
班次：核准優惠班次要求 [已淘汰]

此動作已被取代。 請改用 核准優惠班次請求 。

此作業可讓收件者/管理員核准優惠方案班次請求。
班次：核准請假申請 [已淘汰]

此動作已被取代。 請改用「 核准請假」要求 。

此作業可讓經理核准請假申請。
班次：核准開啟班次要求 [已棄用]

此動作已被取代。 請改用核 准空班請求 。

此作業可讓經理核准「開放輪班」要求。
組建團隊

取得 Microsoft Teams 中小組的詳細數據。
聊天或頻道中的明信片

將卡片張貼至聊天室或頻道

使用頻道中的最適化卡片回覆

作業識別碼：
ReplyWithCardToConversation

使用調適型卡片回覆頻道訊息

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
貼入
 location True string

選取選項
回覆最適化卡片要求
 body True dynamic

回覆最適化卡片要求

傳回

身體
PostToConversationResponse

傳送 Microsoft Graph HTTP 要求

作業識別碼：
HttpRequest

建構 Microsoft Graph REST API 要求，以針對 Microsoft Teams 端點叫用。 支援下列區段： 第一個區段：/teams、/me、/users、第二個區段：頻道、聊天、installedApps、訊息、釘選訊息。 深入了解：https://docs.microsoft.com/en-us/graph/use-the-api

參數

名稱 機碼 必要 類型 Description
URI
 Uri True string

完整或相對 URI。 範例：https://graph.microsoft.com/{version}/{resource}
方法
 Method True string

HTTP 方法 （預設值為 GET）
身體
 Body binary

請求本文內容
內容-類型
 ContentType string

內文的內容類型標頭 （預設值為 application/json）
自訂標頭1
 CustomHeader1 string

自訂標頭 1. 以格式指定：header-name：header-value
自訂標頭2
 CustomHeader2 string

自訂標頭 2. 以格式指定：header-name：header-value
自訂標頭3
 CustomHeader3 string

自訂標題 3. 以格式指定：header-name：header-value
自訂標頭4
 CustomHeader4 string

自訂標題 4. 以格式指定：header-name：header-value
自訂標頭5
 CustomHeader5 string

自訂標題 5. 以格式指定：header-name：header-value

傳回

response
ObjectWithoutType

列出團隊標籤的成員

作業識別碼：
GetTagMembers

列出團隊標籤的成員

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
標記
 tagId True string

選取標籤

傳回

身體
GetTagMembersResponseSchema

列出團隊的所有標籤

作業識別碼：
GetTags

列出團隊的標籤

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊

傳回

身體
GetTagsResponseSchema

列出已加入的團隊

作業識別碼：
GetAllTeams

列出您所屬的 Microsoft Teams 中的所有小組

傳回

名稱 路徑 類型 Description
團隊列表
 value array of object

您所屬的團隊列表
Description
 value.description string

小組的選擇性描述
名稱
 value.displayName string

小組的名稱
ID
 value.id string

小組的唯一識別碼，也稱為 Microsoft 365 群組識別碼

列出成員

作業識別碼：
ListMembers

列出群組聊天或頻道的直接成員

參數

名稱 機碼 必要 類型 Description
螺紋類型
 threadType True string

選擇訊息類型
列出成員要求
 body True dynamic

清單成員要求

傳回

清單成員回應結構描述

身體
ListMembersResponseSchema

列出所有頻道

作業識別碼：
GetAllChannelsForTeam

列出特定小組的所有頻道，包括與小組共用的頻道

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
篩選查詢
 $filter string

用於限制傳回專案的 OData 篩選查詢 （例如 membershipType eq 'standard'） 。
訂購方式
 $orderby string

用於指定項目順序的 OData orderBy 查詢選項（例如 displayName asc）。

傳回

名稱 路徑 類型 Description
頻道列表
 value array of ChannelWithOwnerTeamId

特定小組的一或多個頻道清單

列出相關聯的團隊

作業識別碼：
GetAllAssociatedTeams

列出您直接成員的所有團隊，或是團隊內部託管的共用頻道的成員。

傳回

名稱 路徑 類型 Description
團隊列表
 value array of AssociatedTeamInfo

與您相關聯的團隊清單

列出聊天記錄

作業識別碼：
GetChats

列出您最近參與的聊天記錄

參數

名稱 機碼 必要 類型 Description
聊天類型
 chatType True string

按類型篩選
主題
 topic True string

依是否定義主題名稱來篩選

傳回

名稱 路徑 類型 Description
聊天清單
 value array of object

您參與的一或多個聊天清單
主題
 value.topic string

聊天的主題或主題。 僅適用於群聊
建立日期時間
 value.createdDateTime date-time

建立聊天的日期和時間
上次更新日期時間
 value.lastUpdatedDateTime date-time

上次重新命名聊天或上次更新其成員清單的日期和時間
交談識別碼
 value.id string

聊天的唯一識別碼

列出頻道

作業識別碼：
GetChannelsForGroup

列出特定小組的所有頻道

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
篩選查詢
 $filter string

用於限制傳回專案的 OData 篩選查詢 （例如 membershipType eq 'standard'） 。
訂購方式
 $orderby string

用於指定項目順序的 OData orderBy 查詢選項（例如 displayName asc）。

傳回

名稱 路徑 類型 Description
頻道列表
 value array of GetChannelResponse

特定小組的一或多個頻道清單

列出頻道訊息的回覆

作業識別碼：
ListRepliesToMessage

列出特定小組中頻道中訊息的回覆。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID
Message
 messageId True string

訊息 ID
最新回覆計算
 $top integer

要傳回的最新回覆數目。 預設值為 20。 支援的值介於 1 到 50 之間。

傳回

列出回覆回應結構描述

身體
ListRepliesResponseSchema

刪除團隊標籤

作業識別碼：
DeleteTag

從小組中刪除標籤

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
標記
 tagId True string

選取標籤

取得使用者的@mention權杖

作業識別碼：
AtMentionUser

建立權杖，可插入訊息或最適化卡片 @mention 給使用者。

參數

名稱 機碼 必要 類型 Description
User
 userId True string

指定使用者主體或使用者 ID @mention

傳回

@mention 記號

身體
AtMentionUser_V1

取得團隊標籤的@mention權杖

作業識別碼：
AtMentionTag

建立權杖，可插入到訊息或最適化卡片中，以通道中的使用者身分傳送至 @mention 小組標籤。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
標記
 tagId True string

選取標籤

傳回

@mention 標籤的權杖

身體
AtMentionTagResponse

取得小組中特定頻道的詳細資料

作業識別碼：
GetChannel

取得頻道詳細資料

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID

傳回

取得小組頻道詳細資料回應

身體
GetChannelResponse

取得訊息

作業識別碼：
GetMessagesFromChannel

從特定小組中的頻道取得訊息。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID

傳回

身體
GetMessagesFromChannel_Response

取得訊息詳細資料

作業識別碼：
GetMessageDetails

取得聊天或頻道中訊息的詳細資料。

參數

名稱 機碼 必要 類型 Description
Message
 messageId True string

訊息 ID
訊息類型
 threadType True string

選擇訊息類型
取得訊息詳細資料要求
 body True dynamic

取得訊息詳細資料要求

傳回

此作業會輸出隨機的結果。

在聊天室或頻道中張貼訊息

作業識別碼：
PostMessageToConversation

將訊息張貼至聊天室或頻道

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
貼入
 location True string

選取選項
張貼訊息請求
 body True dynamic

張貼訊息要求

傳回

身體
PostToConversationResponse

在頻道中回覆訊息

作業識別碼：
ReplyWithMessageToConversation

使用訊息回覆頻道訊息

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
貼入
 location True string

選取選項
回覆訊息要求
 body True dynamic

回覆訊息要求

傳回

身體
PostToConversationResponse

將您自己的最適化卡片作為 Flow 機器人張貼給使用者 [已取代]

作業識別碼：
PostUserAdaptiveCard

新增 JSON 卡片定義，以建立 Teams 使用者的自訂訊息。 訊息可以包含影像、圖表、文字等。

參數

名稱 機碼 必要 類型 Description
張貼最適化卡片要求
 PostAdaptiveCardRequest True dynamic

貼文最適化卡片要求

傳回

身體
MessageId

將您自己的最適化卡片作為 Flow 機器人發佈到管道 [已棄用]

作業識別碼：
PostChannelAdaptiveCard

新增 JSON 卡片定義，以建立 Teams 頻道的自訂貼文。 該帖子可以包含圖像、圖表、文本等。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
張貼最適化卡片要求
 PostAdaptiveCardRequest True dynamic

貼文最適化卡片要求

傳回

身體
MessageId

將成員新增至團隊

作業識別碼：
AddMemberToTeam

在 Microsoft Teams 中將成員新增至小組

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
User
 userId True string

要新增的使用者主體名稱或 Microsoft Entra ID
將使用者設定為團隊擁有者
 owner boolean

True，如果使用者應該是小組擁有者

將成員新增至團隊標籤

作業識別碼：
AddMemberToTag

將使用者新增至團隊標籤

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
標記
 tagId True string

選取標籤
使用者的 ID
 userId True string

要新增至標籤的成員的使用者 ID 必須採用「550e8400-e29b-41d4-a716-446655440000」之格式。

傳回

身體
AddMemberToTagResponseSchema

將最適化卡片張貼至 Teams 頻道，並等候回應 [已淘汰]

作業識別碼：
SubscribeChannelFlowContinuation

輕鬆自動化將訊息傳送至 Teams 通道的程式，其中包含繼續等候流程的動作。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
更新訊息
 updateMessage string

回應後要包含在原始卡片更新中的訊息
應該更新卡片
 shouldUpdateCard boolean

是否更新卡片後的回應
Channel
 channelId True string

新增頻道 ID
Message
 messageBody True string

傳回

此作業會輸出隨機的結果。

將訊息以 Flow 機器人的形式發佈給使用者 [已棄用]

作業識別碼：
PostUserNotification

輕鬆自動化向 Teams 中的某人發送消息的過程。

參數

名稱 機碼 必要 類型 Description
張貼通知請求
 PostNotificationRequest True dynamic

貼文通知要求

將訊息以 Flow 機器人身分發佈至頻道 [已棄用]

作業識別碼：
PostChannelNotification

輕鬆自動化將訊息張貼至 Teams 頻道的程式。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
張貼通知請求
 PostNotificationRequest True dynamic

貼文通知要求

將調適型卡片張貼至 Teams 使用者，並等候回應 [已取代]

作業識別碼：
SubscribeUserFlowContinuation

輕鬆自動化將訊息傳送給 Teams 使用者的程式，其中包含繼續等候流程的動作。

參數

名稱 機碼 必要 類型 Description
更新訊息
 updateMessage string

回應後要包含在原始卡片更新中的訊息
應該更新卡片
 shouldUpdateCard boolean

是否更新卡片後的回應
Recipient
 to True string

新增電子郵件地址
總結
 summary string

訊息摘要
是警報
 isAlert boolean

訊息是否會顯示在活動摘要中
Message
 messageBody True string

傳回

此作業會輸出隨機的結果。

將選項作為 Flow 機器人發佈給使用者

作業識別碼：
SubscribeUserMessageWithOptions

將一組選項傳送給 Microsoft Teams 使用者，他們必須先回應這些選項，才能繼續流程。 此動作會暫停流程，直到使用者回應選項為止

參數

名稱 機碼 必要 類型 Description
包含選項訂閱要求的使用者訊息
 UserMessageWithOptionsSubscriptionRequest True dynamic

具有選項訂閱要求的使用者訊息

傳回

此作業會輸出隨機的結果。

建立 Teams 會議

作業識別碼：
CreateTeamsMeeting

在邀請底部建立一個連結的會議，以在 Microsoft Teams 上線上加入會議。

參數

名稱 機碼 必要 類型 Description
行事曆 ID
 calendarid True string

選取值
主旨
 subject True string

活動主旨行的文字
活動訊息內容
 content True string

活動內容
時區
 timeZone True string

活動時區
開始時間
 dateTime True date-no-tz

事件的開始時間 （例如： '2017-08-29T04：00：00'）
結束時間
 dateTime True date-no-tz

事件結束時間 （例如：「2017-08-29T05：00：00」）
所需出席者
 requiredAttendees email

活動所需的出席者以分號分隔
可選出席者
 optionalAttendees email

活動的可選出席者，以分號分隔
顯示名稱
 displayName string

與位置相關聯的名稱
重要性
 importance string

事件重要性：低、正常或高
週期性模式
 type string

週期的模式。 會議週期性時需要
週期間隔
 interval integer

出現之間的單位數，其中單位可以是天、週、月或年，視類型而定。 會議週期性時需要
星期幾
 daysOfWeek array of string

以逗號分隔的星期幾（例如：「星期一、星期三、星期五」）
週指數
 index string

指定事件發生在一週中的哪一天。 預設值為第一個
週期開始日期
 startDate date

週期的開始日期，格式為 YYYY-MM-DD。 會議週期性時需要
週期結束日期
 endDate date

週期的結束日期，格式為 YYYY-MM-DD
全天活動
 isAllDay boolean

如果事件持續一整天，請設為 true
活動前提醒時間
 reminderMinutesBeforeStart integer

提醒警示發生的事件開始時間前的分鐘數
啟用提醒事項
 isReminderOn boolean

如果警示設定為提醒使用者事件，請設定為 true
狀態顯示為
 showAs string

活動期間要顯示的狀態
要求回應
 responseRequested boolean

如果寄件者想要在接受事件時回應，請設定為 true

傳回

已建立之新會議的回應

身體
NewMeetingRespone

建立團隊

作業識別碼：
CreateATeam

在 Microsoft Teams 中建立新小組

參數

名稱 機碼 必要 類型 Description
小組名稱
 displayName True string

小組的名稱
Description
 description True string

小組的選擇性描述
可見度
 visibility string

團隊的可見性

傳回

身體
CreateATeamResponse

建立小組的標籤

作業識別碼：
CreateTag

在小組中建立標籤

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
顯示名稱
 displayName True string

在 Microsoft Teams 中向使用者顯示的標籤名稱。
會員 ID
 members True string

以分號分隔的使用者 ID 清單，識別碼的格式必須為「550e8400-e29b-41d4-a716-446655440000」。

傳回

為團隊建立的標籤

標記
CreateTagResponseSchema

建立聊天室

作業識別碼：
CreateChat

創建一對一或群聊

參數

名稱 機碼 必要 類型 Description
Title
 topic string

標題，僅在群聊中顯示
要新增的成員
 members True string

使用者的 ID，以分號區隔

傳回

已建立新聊天的回應

身體
NewChatResponse

建立頻道

作業識別碼：
CreateChannel

在指定的小組內建立新頻道

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Description
 description string

頻道的選用文字描述
名稱
 displayName True string

Microsoft Teams 中顯示的頻道名稱

傳回

名稱 路徑 類型 Description
Description
 description string

頻道的選用文字描述
顯示名稱
 displayName string

Microsoft Teams 中顯示的頻道名稱
ID
 id string

頻道的唯一識別碼

張貼摘要通知

作業識別碼：
PostFeedNotification

將通知張貼至連結至聊天或小組的使用者活動摘要。

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
通知類型
 notificationType True string

選擇通知類型
發佈摘要通知要求
 body True dynamic

貼文摘要通知要求

張貼最適化卡片並等待回應

作業識別碼：
PostCardAndWaitForResponse

將調適型卡片張貼至聊天或頻道，並等候任何使用者的回應。 這會暫停流程，直到任何使用者回應為止。

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
貼入
 location True string

選取選項
流程繼續訂閱要求
 body True dynamic

流程繼續訂閱要求

傳回

此作業會輸出隨機的結果。

張貼訊息 [已棄用]

作業識別碼：
PostMessageToChannel

將訊息張貼至特定小組中的頻道。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID
Message
 content True html

訊息內文。

張貼訊息 （V2） [已棄用]

作業識別碼：
PostMessageToChannelV2

將訊息張貼至特定小組中的頻道。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID
主旨
 subject string

訊息的主旨。
Message
 content True string

訊息內文。
類型
 contentType True string

內容類型：html 或文字。

張貼訊息 （V3） [已棄用]

作業識別碼：
PostMessageToChannelV3

將訊息張貼至特定小組中的頻道。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID
主旨
 subject string

訊息的主旨。
Message
 content True html

訊息內文。

傳回

身體
MessageId

張貼訊息回覆 [已棄用]

作業識別碼：
PostReplyToMessage

在特定小組的頻道中張貼訊息的回覆。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID
Message
 messageId True string

訊息 ID
主旨
 subject string

訊息的主旨。
回覆
 content True string

訊息內文。
類型
 contentType True string

內容類型：html 或文字。

張貼訊息回覆 （V2） [已淘汰]

作業識別碼：
PostReplyToMessageV2

在特定小組的頻道中張貼訊息的回覆。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID
Message
 messageId True string

訊息 ID
主旨
 subject string

訊息的主旨。
回覆
 content True html

訊息內文。

從團隊標籤中刪除成員

作業識別碼：
DeleteTagMember

從團隊標籤中刪除成員

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
標記
 tagId True string

選取標籤
標籤成員ID
 tagMemberId True string

要從標籤中移除的成員識別碼

更新聊天或頻道中的最適化卡片

作業識別碼：
UpdateCardInConversation

更新現有的最適化卡片

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
貼入
 location True string

選取選項
更新調適型卡片要求
 body True dynamic

更新最適化卡片要求

班次：列出所有交換班次要求 [已淘汰]

作業識別碼：
ListSwapShiftsChangeRequests

此動作已被取代。 請改用 列出團隊中的所有交換班次請求 。

此作業會傳回排程中的所有交換班次要求

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
最高計數
 $top integer

要擷取的要求總數
請求狀態
 state string

要求狀態篩選

傳回

名稱 路徑 類型 Description
交換班次變更要求清單
 value array of SwapShiftsChangeRequestResponse

排程中的交換班次變更請求清單

班次：列出所有優惠班次要求 [已取代]

作業識別碼：
ListOfferShiftRequests

此動作已被取代。 請改用 列出團隊中的所有選件轉移請求 。

此作業會傳回排程中的所有優惠方案班次請求

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
最高計數
 $top integer

要擷取的要求總數
請求狀態
 state string

要求狀態篩選

傳回

名稱 路徑 類型 Description
優惠班次要求清單
 value array of OfferShiftRequestResponse

排程中的選件班次請求清單

班次：列出所有排程群組 [已淘汰]

作業識別碼：
ListSchedulingGroups

此動作已被取代。 請改用 列出團隊中的所有排程群組 。

此作業會傳回排程中的所有排程群組

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
最高計數
 $top integer

要擷取的項目總數

傳回

名稱 路徑 類型 Description
排程群組清單
 value array of SchedulingGroupResponse

排程中的排程群組清單

班次：列出所有班次 [已淘汰]

作業識別碼：
ListShifts

此動作已被取代。 請改用 列出團隊中的所有班次 。

此作業會傳回指派給小組成員的所有班次

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
從開始時間開始
 startTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
最高計數
 $top integer

要擷取的班次總數

傳回

名稱 路徑 類型 Description
班次清單
 value array of ShiftResponse

排程中的班次清單

班次：列出所有請假原因 [已棄用]

作業識別碼：
ListTimeOffReasons

此動作已被取代。 請改用列出 團隊中的所有請假原因 。

此作業會傳回與小組相關聯的請假原因清單。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
最高計數
 $top integer

要擷取的請假原因總數

傳回

休假原因清單。

與團隊相關聯的請假原因清單
GetTimeOffReasonsResponse

班次：列出所有請假申請 [已淘汰]

作業識別碼：
ListTimeOffRequests

此動作已被取代。 請改用列出 團隊中的所有請假請求 。

此作業會傳回排程中的所有請假要求

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
最高計數
 $top integer

要擷取的要求總數
請求狀態
 state string

要求狀態篩選

傳回

名稱 路徑 類型 Description
請假申請清單
 value array of TimeOffRequestResponse

排程中的請假申請清單

班次：列出所有開啟的班次 [已棄用]

作業識別碼：
ListOpenShifts

此動作已被取代。 請改用 列出團隊中的所有空缺班次 。

此作業會傳回小組中的所有空缺班次

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
從開始時間開始
 startTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
最高計數
 $top integer

要擷取的開啟班次總數

傳回

名稱 路徑 類型 Description
開啟班次清單
 value array of OpenShiftResponse

排程中的空缺班次清單

班次：列出所有開啟的班次要求 [已淘汰]

作業識別碼：
ListOpenShiftChangeRequests

此動作已被取代。 請改用 列出團隊中的所有 Open Shift 請求 。

此作業會傳回排程中的所有未結班次變更要求

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
最高計數
 $top integer

要擷取的要求總數
請求狀態
 state string

要求狀態篩選

傳回

名稱 路徑 類型 Description
開啟班次變更要求清單
 value array of OpenShiftChangeRequestResponse

排程中的空班變更請求清單

班次：刪除班次 [已棄用]

作業識別碼：
DeleteShift

此動作已被取代。 請改用 刪除班次 。

此作業會使用班次的唯一識別碼刪除班次。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
班次識別碼
 shiftId True string

班次的唯一識別碼。

班次：刪除開啟的班次 [已淘汰]

作業識別碼：
DeleteOpenShift

此動作已被取代。 請改用 刪除空缺班次 。

此作業會刪除空缺班次。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
開啟班次 ID
 openShiftId True string

空缺班次的唯一 ID。

班次：取得排程的詳細資料 [已取代]

作業識別碼：
GetSchedule

此動作已被取代。 請改用 [取得排程] 的詳細資料 。

此作業會使用排程的唯一識別碼傳回排程的詳細資料。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊

傳回

排程實體

身體
ScheduleResponse

班次：取得排程群組 [已淘汰]

作業識別碼：
GetSchedulingGroup

此動作已被取代。 請改用 取得排程群組 。

此作業會使用排程群組的唯一識別碼傳回詳細資料。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
排程群組 ID
 schedulingGroupId True string

排程群組的唯一識別碼。

傳回

排程群組實體

排程群組
SchedulingGroupResponse

班次：取得班次 [已取代]

作業識別碼：
GetShift

此動作已被取代。 請改用 Get a Shift 。

此作業會使用班次的唯一識別碼傳回班次的詳細資料。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
班次識別碼
 shiftId True string

班次的唯一識別碼。

傳回

轉移實體

轉變
ShiftResponse

班次：取得空缺班次 [已取代]

作業識別碼：
GetOpenShift

此動作已被取代。 請改用 Get an Open Shift 。

此作業會傳回未開班次的詳細資料。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
開啟班次 ID
 openShiftId True string

空缺班次的唯一 ID。

傳回

開啟班次實體

開放班次
OpenShiftResponse

班次：建立新的開放班次 [已淘汰]

作業識別碼：
CreateOpenShift

此動作已被取代。 請改用 建立新的空缺班次 。

在排程中建立新的空缺班次

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
排程群組 ID
 schedulingGroupId string

排程群組 ID
顯示名稱
 displayName string

顯示名稱
註釋
 notes string

註釋
從開始時間開始
 startDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Theme
 theme string

Theme
開放插槽計數
 openSlotCount True integer

開放插槽計數
已付費
 isPaid boolean

已付費
從開始時間開始
 startDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Code
 code string

Code
顯示名稱
 displayName string

顯示名稱

傳回

開啟班次實體

開放班次
OpenShiftResponse

班次：拒絕交換班次要求 [已淘汰]

作業識別碼：
SwapShiftsChangeRequestDecline

此動作已被取代。 請改用「 拒絕交換班次」請求 。

此作業可讓使用者拒絕交換班次要求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
交換班次變更要求識別碼
 swapShiftsChangeRequestId True string

要求的唯一ID
收件人/經理的訊息
 message string

拒絕要求時的訊息。

班次：拒絕優惠班次請求 [已淘汰]

作業識別碼：
OfferShiftRequestDecline

此動作已被取代。 請改用 拒絕優惠轉移請求 。

此作業可讓使用者拒絕優惠方案班次請求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
優惠班次要求識別碼
 offerShiftRequestId True string

選件班次請求的唯一ID
收件人/經理的訊息
 message string

拒絕要求時的訊息。

班次：拒絕請假申請 [已棄用]

作業識別碼：
TimeOffRequestDecline

此動作已被取代。 請改用「 拒絕請假申請 」。

此作業可讓經理拒絕請假請求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
請假申請 ID
 timeOffRequestId True string

請假申請的唯一識別碼
經理留言
 message string

當請求被拒絕時，管理員向寄件者/收件者發送的訊息。

班次：拒絕開啟的班次要求 [已棄用]

作業識別碼：
OpenShiftChangeRequestDecline

此動作已被取代。 請改用 拒絕 Open Shift 請求 。

此作業可讓經理拒絕未結班次要求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
開啟班次變更要求 ID
 openShiftChangeRequestId True string

要求的唯一ID
經理留言
 message string

當請求被拒絕時，管理員向寄件者/收件者發送的訊息。

班次：更新空缺班次 [已淘汰]

作業識別碼：
UpdateOpenShift

此動作已被取代。 請改用 更新空缺班次 。

更新排程中的空缺班次。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
開啟班次 ID
 openShiftId True string

空缺班次的唯一 ID。
排程群組 ID
 schedulingGroupId string

排程群組 ID
顯示名稱
 displayName string

顯示名稱
註釋
 notes string

註釋
從開始時間開始
 startDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Theme
 theme string

Theme
開放插槽計數
 openSlotCount True integer

開放插槽計數
已付費
 isPaid boolean

已付費
從開始時間開始
 startDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime True date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Code
 code string

Code
顯示名稱
 displayName string

顯示名稱

傳回

開啟班次實體

開放班次
OpenShiftResponse

班次：核准交換班次要求 [已淘汰]

作業識別碼：
SwapShiftsChangeRequestApprove

此動作已被取代。 請改用 核准交換班次 要求 。

此作業可讓使用者核准交換班次要求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
交換班次變更要求識別碼
 swapShiftsChangeRequestId True string

要求的唯一ID
收件人/經理的訊息
 message string

接受要求時的訊息。

班次：核准優惠班次要求 [已淘汰]

作業識別碼：
OfferShiftRequestApprove

此動作已被取代。 請改用 核准優惠班次請求 。

此作業可讓收件者/管理員核准優惠方案班次請求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
優惠班次要求識別碼
 offerShiftRequestId True string

選件班次請求的唯一ID
收件人/經理的訊息
 message string

接受要求時的訊息。

班次：核准請假申請 [已淘汰]

作業識別碼：
TimeOffRequestApprove

此動作已被取代。 請改用「 核准請假」要求 。

此作業可讓經理核准請假申請。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
請假申請 ID
 timeOffRequestId True string

請假申請的唯一識別碼
經理留言
 message string

接受請求時，管理員向寄件者/收件者發送的訊息。

班次：核准開啟班次要求 [已棄用]

作業識別碼：
OpenShiftChangeRequestApprove

此動作已被取代。 請改用核 准空班請求 。

此作業可讓經理核准「開放輪班」要求。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊
開啟班次變更要求 ID
 openShiftChangeRequestId True string

要求的唯一ID
經理留言
 message string

接受請求時，管理員向寄件者/收件者發送的訊息。

組建團隊

作業識別碼：
GetTeam

取得 Microsoft Teams 中小組的詳細數據。

參數

名稱 機碼 必要 類型 Description
球隊
 teamId True string

選擇團隊

傳回

取得小組回應

身體
GetTeamResponse

聊天或頻道中的明信片

作業識別碼：
PostCardToConversation

將卡片張貼至聊天室或頻道

參數

名稱 機碼 必要 類型 Description
發佈為
 poster True string

選取選項
貼入
 location True string

選取選項
明信片請求
 body True dynamic

請求明信片

傳回

身體
PostToConversationResponse

觸發程序

在頻道留言中被提及的時候

當將目前使用者新增至小組中的頻道的新 @mentions 訊息時觸發。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
將新訊息新增至聊天或頻道時

在指定的聊天或頻道中張貼新訊息時觸發。 如果訊息已編輯，則不會觸發。
從撰寫框 （V2）

此觸發程式可讓您從 Microsoft Teams 中的撰寫訊息方塊啟動流程。 （僅適用於 Power Automate。
新增團隊成員時

當成員新增至指定小組時觸發
新增聊天訊息時

當用戶參與的任何聊天中發布新消息時觸發。
新增頻道訊息時

當新訊息張貼至小組中的頻道時觸發。 請注意，只有在通道中新增根訊息時，才會觸發此觸發程式。 對現有通道訊息的回覆不會導致觸發事件引發。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
當我@mentioned

當將目前使用者新增至指定聊天或頻道的新 @mentions 訊息時觸發。
當提到關鍵字時

在指定的聊天或頻道中提及關鍵字時觸發。 如果訊息已編輯，則不會觸發。
當有人回應最適化卡片時

此觸發程式可讓您處理張貼在 Microsoft Teams 中的調適型卡片的回應。 （僅適用於 Power Automate。
當有人在聊天室中對訊息做出反應時

當有人對指定聊天或頻道中的訊息做出反應時觸發。
移除新團隊成員時

從指定小組中移除成員時觸發
針對選取的訊息 （V2）

此觸發程序可讓您在 Microsoft Teams 中啟動所選訊息的流程。 （僅適用於 Power Automate。

在頻道留言中被提及的時候

作業識別碼：
OnNewChannelMessageMentioningMe

當將目前使用者新增至小組中的頻道的新 @mentions 訊息時觸發。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID

傳回

名稱 路徑 類型 Description
attachments
 attachments array of object

attachments
items
 attachments object
內容
 body.content string

訊息內容
內容類型
 body.contentType string

內容的型別。 可能的值為 text 和 html
建立時間戳記
 createdDateTime date-time

建立聊天訊息的時間戳記
已刪除
 deleted boolean

已刪除
etag
 etag string

聊天訊息的版本號碼。
應用程式
 from.application object

應用程式
裝置
 from.device string

裝置
顯示名稱
 from.user.displayName string

顯示名稱
ID
 from.user.id string

使用者的識別碼
身份提供程式
 from.user.identityProvider string

身份提供程式
識別碼
 id string

訊息的唯一 ID
重要性
 importance string

訊息的重要性。 可能的值為：正常、高、緊急。
上次修改時間戳記
 lastModifiedDateTime string

建立聊天訊息 （初始設定） 或修改的時間戳記，包括新增或移除回應的時間戳記
地區設定
 locale string

用戶端設定的聊天訊息地區設定。
提及
 mentions array of object

聊天訊息中提及的實體清單。 支援的實體包括：使用者、機器人、小組和通道。
items
 mentions object
訊息類型
 messageType string

聊天訊息的類型
反應
 reactions array of object

此聊天訊息的回應 （例如，按讚）
items
 reactions object
回覆標識
 replyToId string

執行緒父訊息的識別碼
主題
 subject string

聊天訊息的主旨，選用
摘要
 summary string

可用於推播通知和摘要檢視或後援檢視的訊息摘要文字

將新訊息新增至聊天或頻道時

作業識別碼：
WebhookNewMessageTrigger

在指定的聊天或頻道中張貼新訊息時觸發。 如果訊息已編輯，則不會觸發。

參數

名稱 機碼 必要 類型 Description
訊息類型
 threadType True string

選擇訊息類型
requestBody
 requestBody dynamic

這是 Webhook 的要求內文

傳回

此作業會輸出隨機的結果。

從撰寫框 （V2）

作業識別碼：
OnComposeMessageV2

此觸發程式可讓您從 Microsoft Teams 中的撰寫訊息方塊啟動流程。 （僅適用於 Power Automate。

參數

名稱 機碼 必要 類型 Description
operationId
 operationId True string
主持人
 host object
parameters
 parameters True object
結構描述
 schema object

傳回

名稱 路徑 類型 Description
body
 body object

新增團隊成員時

作業識別碼：
OnGroupMembershipAdd

當成員新增至指定小組時觸發

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊

傳回

名稱 路徑 類型 Description
使用者識別碼
 id string

使用者的唯一識別碼

新增聊天訊息時

作業識別碼：
WebhookChatMessageTrigger

當用戶參與的任何聊天中發布新消息時觸發。

傳回

訊息詳細資料

身體
ChatMessageWebhookResponseSchema

新增頻道訊息時

作業識別碼：
OnNewChannelMessage

當新訊息張貼至小組中的頻道時觸發。 請注意，只有在通道中新增根訊息時，才會觸發此觸發程式。 對現有通道訊息的回覆不會導致觸發事件引發。 對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊
Channel
 channelId True string

頻道 ID

傳回

名稱 路徑 類型 Description
attachments
 attachments array of object

attachments
items
 attachments object
內容
 body.content string

訊息內容
內容類型
 body.contentType string

內容的型別。 可能的值為 text 和 html
建立時間戳記
 createdDateTime date-time

建立聊天訊息的時間戳記
已刪除
 deleted boolean

已刪除
etag
 etag string

聊天訊息的版本號碼。
應用程式
 from.application object

應用程式
裝置
 from.device string

裝置
顯示名稱
 from.user.displayName string

顯示名稱
ID
 from.user.id string

使用者的識別碼
身份提供程式
 from.user.identityProvider string

身份提供程式
識別碼
 id string

訊息的唯一 ID
重要性
 importance string

訊息的重要性。 可能的值為：正常、高、緊急。
上次修改時間戳記
 lastModifiedDateTime string

建立聊天訊息 （初始設定） 或修改的時間戳記，包括新增或移除回應的時間戳記
地區設定
 locale string

用戶端設定的聊天訊息地區設定。
提及
 mentions array of object

聊天訊息中提及的實體清單。 支援的實體包括：使用者、機器人、小組和通道。
items
 mentions object
訊息類型
 messageType string

聊天訊息的類型
反應
 reactions array of object

此聊天訊息的回應 （例如，按讚）
items
 reactions object
回覆標識
 replyToId string

執行緒父訊息的識別碼
主題
 subject string

聊天訊息的主旨，選用
摘要
 summary string

可用於推播通知和摘要檢視或後援檢視的訊息摘要文字

當我@mentioned

作業識別碼：
WebhookAtMentionTrigger

當將目前使用者新增至指定聊天或頻道的新 @mentions 訊息時觸發。

參數

名稱 機碼 必要 類型 Description
訊息類型
 threadType True string

選擇訊息類型
requestBody
 requestBody dynamic

這是 Webhook 的要求內文

傳回

此作業會輸出隨機的結果。

當提到關鍵字時

作業識別碼：
WebhookKeywordTrigger

在指定的聊天或頻道中提及關鍵字時觸發。 如果訊息已編輯，則不會觸發。

參數

名稱 機碼 必要 類型 Description
訊息類型
 threadType True string

選擇訊息類型
要搜尋的關鍵字
 $search True string

要搜尋的關鍵字以逗號分隔的清單
requestBody
 requestBody dynamic

這是 Webhook 的要求內文

傳回

此作業會輸出隨機的結果。

當有人回應最適化卡片時

作業識別碼：
TeamsCardTrigger

此觸發程式可讓您處理張貼在 Microsoft Teams 中的調適型卡片的回應。 （僅適用於 Power Automate。

傳回

此作業會輸出隨機的結果。

當有人在聊天室中對訊息做出反應時

作業識別碼：
WebhookMessageReactionTrigger

當有人對指定聊天或頻道中的訊息做出反應時觸發。

參數

名稱 機碼 必要 類型 Description
追蹤表情符號
 reactionKey True string

選擇表情符號來監控訊息反應
觸發頻率
 frequency True string

流程應該由每個反應觸發，還是只由特定訊息的第一個反應觸發
誰可以觸發？
 runningPolicy True string

指定誰可以觸發此工作流程
訊息類型
 threadType True string

選擇訊息類型
requestBody
 requestBody dynamic

這是 Webhook 的要求內文

傳回

訊息詳細資料

身體
MessageReactionWebhookResponseSchema

移除新團隊成員時

作業識別碼：
OnGroupMembershipRemoval

從指定小組中移除成員時觸發

參數

名稱 機碼 必要 類型 Description
球隊
 groupId True string

選擇團隊

傳回

名稱 路徑 類型 Description
使用者識別碼
 id string

使用者的唯一識別碼

針對選取的訊息 （V2）

作業識別碼：
OnMessageSelectedV2

此觸發程序可讓您在 Microsoft Teams 中啟動所選訊息的流程。 （僅適用於 Power Automate。

參數

名稱 機碼 必要 類型 Description
operationId
 operationId True string
主持人
 host object
parameters
 parameters True object
結構描述
 schema object

傳回

名稱 路徑 類型 Description
body
 body object

定義

GetTagsResponseSchema

名稱 路徑 類型 Description
value
 value array of object
ID
 value.id string

標籤的唯一識別碼
團隊ID
 value.teamId string

定義標籤之小組的識別碼
顯示名稱
 value.displayName string

在 Microsoft Teams 中向使用者顯示的標籤名稱。
會員人數
 value.memberCount integer

指派給標籤的使用者數目

GetTagMembersResponseSchema

名稱 路徑 類型 Description
value
 value array of object
標籤成員 ID
 value.id string

成員的唯一識別碼
租戶識別碼
 value.tenantId string

標籤成員所屬租用戶的ID
使用者顯示名稱
 value.displayName string

成員的顯示名稱
使用者識別碼
 value.userId string

成員的使用者 ID

CreateTagResponseSchema

為團隊建立的標籤

名稱 路徑 類型 Description
ID
 id string

標籤的唯一識別碼
團隊ID
 teamId string

定義標籤之小組的識別碼
顯示名稱
 displayName string

在 Microsoft Teams 中向使用者顯示的標籤名稱。
會員人數
 memberCount integer

指派給標籤的使用者數目

AddMemberToTagResponseSchema

名稱 路徑 類型 Description
ID
 userId string

新增至標籤的成員的使用者ID

ListMembersResponseSchema

清單成員回應結構描述

名稱 路徑 類型 Description
成員名單
 value array of object

清單成員回應
顯示名稱
 value.displayName string

成員的顯示名稱
電子郵件
 value.email string

會員的電子郵件地址
ID
 value.id string

會員的用戶 ID
角色
 value.roles array of string

該成員的角色
租戶識別碼
 value.tenantId string

成員的租戶 ID
使用者識別碼
 value.userId string

會員的使用者 ID
對話的可見歷史記錄開始時間
 value.visibleHistoryStartDateTime string

時間戳記，表示與交談成員共用交談歷程記錄的時間

ListRepliesResponseSchema

列出回覆回應結構描述

名稱 路徑 類型 Description
訊息回覆清單
 value array of object

清單回覆回應
ID
 value.id string

回覆ID
回覆 ID
 value.replyToId string

要回覆之訊息的識別碼
Etag
 value.etag string

回覆的 ETag
訊息類型
 value.messageType string

訊息類型
建立日期時間
 value.createdDateTime string

回覆的建立時間戳記
上次修改日期時間
 value.lastModifiedDateTime string

回覆的上次修改時間戳記
上次編輯日期時間
 value.lastEditedDateTime string

回覆的上次編輯時間戳記
刪除日期時間
 value.deletedDateTime string

回覆的刪除時間戳記
主旨
 value.subject string

回覆主題
總結
 value.summary string

回覆摘要
聊天 ID
 value.chatId string

與回覆相關聯的聊天 ID
重要性
 value.importance string

回覆的重要性
Locale
 value.locale string

回覆的地區設定
網址
 value.webUrl string

回覆的 Web URL
違反政策
 value.policyViolation object

政策違規詳細資料
活動詳情
 value.eventDetail object

與回覆相關聯的事件詳細資料
Application
 value.from.application object

申請詳情
Device
 value.from.device object

裝置詳細資料
使用者識別碼
 value.from.user.id string

使用者識別碼
顯示名稱
 value.from.user.displayName string

使用者的顯示名稱
使用者身分類型
 value.from.user.userIdentityType string

使用者身分識別類型
租戶識別碼
 value.from.user.tenantId string

使用者的租用戶識別碼
內容類型
 value.body.contentType string

回覆的內容類型
Content
 value.body.content string

回覆內容
團隊ID
 value.channelIdentity.teamId string

團隊ID
頻道 ID
 value.channelIdentity.channelId string

頻道 ID
Attachments
 value.attachments array of object

回覆中的附件
items
 value.attachments object
提及
 value.mentions array of object

回覆中的提及
items
 value.mentions object
回應
 value.reactions array of object

對回覆的反應
items
 value.reactions object
訊息歷史記錄
 value.messageHistory array of object

訊息的歷史記錄
items
 value.messageHistory object

MessageReactionWebhookResponseSchema

訊息詳細資料

名稱 路徑 類型 Description
執行緒類型
 threadType string
聊天識別碼
 chatId string

聊天的唯一識別碼
團隊編號
 teamId string

團隊的唯一識別碼
通道標識
 channelId string

頻道的唯一識別碼
訊息標識符
 messageId string

已回應訊息的 ID
回覆 Id
 replyToId string

執行緒父訊息的識別碼
訊息連結
 messageLink string

反應訊息的連結
UserId
 userId string

反應使用者的 ID
訊息反應
 messageReaction string

使用的訊息反應

ChatMessageWebhook回應架構

訊息詳細資料

名稱 路徑 類型 Description
Message
 value array of object

訊息詳細資料回應
交談識別碼
 value.conversationId string

聊天的唯一識別碼
ID
 value.messageId string

訊息 ID
Link
 value.linkToMessage string

留言連結

訊息標識符

名稱 路徑 類型 Description
訊息 ID
 id string

唯一訊息識別碼

GetMessagesFromChannel_Response

名稱 路徑 類型 Description
@odata.上下文
 @odata.context string

@odata.context
@odata.計數
 @odata.count integer

@odata.count
@odata.next連結
 @odata.nextLink string

@odata.nextLink
訊息清單
 value OnNewChannelMessage_Response

小組中特定頻道的一或多則訊息清單

OnNewChannelMessage_Response

小組中特定頻道的一或多則訊息清單

名稱 路徑 類型 Description
attachments
 attachments array of object

attachments
items
 attachments object
內容
 body.content string

訊息內容
內容類型
 body.contentType string

內容的型別。 可能的值為 text 和 html
建立時間戳記
 createdDateTime date-time

建立聊天訊息的時間戳記
已刪除
 deleted boolean

已刪除
etag
 etag string

聊天訊息的版本號碼。
應用程式
 from.application object

應用程式
裝置
 from.device string

裝置
顯示名稱
 from.user.displayName string

顯示名稱
ID
 from.user.id string

使用者的識別碼
身份提供程式
 from.user.identityProvider string

身份提供程式
識別碼
 id string

訊息的唯一 ID
重要性
 importance string

訊息的重要性。 可能的值為：正常、高、緊急。
上次修改時間戳記
 lastModifiedDateTime string

建立聊天訊息 （初始設定） 或修改的時間戳記，包括新增或移除回應的時間戳記
地區設定
 locale string

用戶端設定的聊天訊息地區設定。
提及
 mentions array of object

聊天訊息中提及的實體清單。 支援的實體包括：使用者、機器人、小組和通道。
items
 mentions object
訊息類型
 messageType string

聊天訊息的類型
反應
 reactions array of object

此聊天訊息的回應 （例如，按讚）
items
 reactions object
回覆標識
 replyToId string

執行緒父訊息的識別碼
主題
 subject string

聊天訊息的主旨，選用
摘要
 summary string

可用於推播通知和摘要檢視或後援檢視的訊息摘要文字

GetTeam回應

取得小組回應

名稱 路徑 類型 Description
團隊ID
 id string

團隊的唯一識別碼
顯示名稱
 displayName string

小組的名稱
團隊簡介
 description string

團隊的描述，選用
內部 ID
 internalId string

團隊的內部 ID
團隊的網頁網址
 webUrl string

超連結，將移至 Microsoft Teams 用戶端中的小組
Archived
 isArchived boolean

此小組是否處於唯讀模式
成員設定
 memberSettings MemberSettings

設定成員是否可以在團隊中執行某些動作，例如建立頻道和新增機器人
訪客設定
 guestSettings GuestSettings

設定來賓是否可以在小組中建立、更新或刪除頻道的設定
訊息設定
 messagingSettings MessagingSettings

在團隊中配置消息和提及的設置
有趣的設置
 funSettings FunSettings

配置在團隊中使用 Giphy、模因和貼紙的設置
探索設定
 discoverySettings DiscoverySettings

設定其他人可探索的小組。

關聯團隊資訊

代表與使用者相關聯的小組

名稱 路徑 類型 Description
團隊ID
 id string

團隊的唯一識別碼
顯示名稱
 displayName string

小組的名稱
租戶識別碼
 tenantId string

此小組所屬的 Microsoft Entra 租用戶識別碼

GetChannel回應

取得小組頻道詳細資料回應

名稱 路徑 類型 Description
頻道 ID
 id string

通道的唯一識別碼
顯示名稱
 displayName string

頻道的名稱
頻道說明
 description string

通道的說明，選用
頻道的電子郵件地址
 email string

用於將訊息傳送至頻道的電子郵件地址
小組租用戶識別碼
 tenantId string

Microsoft Entra 租使用者的識別碼。
Microsoft Teams 中頻道的超連結
 webUrl string

Microsoft Teams 中頻道的超連結
頻道的 SharePoint 資料夾 URL
 filesFolderWebUrl string

頻道的 SharePoint 資料夾 URL
頻道建立時間
 createdDateTime date-time

建立通道的時間戳記。 唯讀模式
通道的類型。
 membershipType string

頻道成員資格類型

ChannelWithOwnerTeamId

具有擁有者小組識別碼的頻道資源

名稱 路徑 類型 Description
object

具有擁有者小組識別碼的頻道資源

GetTimeOffReasons回應

休假原因清單。

名稱 路徑 類型 Description
包含請假原因的陣列
 value array of object

請假原因清單。
請假原因 ID
 value.id string

請假原因的唯一識別碼。
創建時間
 value.createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改日期時間
 value.lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
顯示名稱
 value.displayName string

顯示名稱
圖示類型
 value.iconType string

圖示類型
處於活動狀態
 value.isActive boolean

處於活動狀態
上次修改者
 value.lastModifiedBy LastModifiedBy

上次修改者

TimeOffRequest回應

請假申請實體

名稱 路徑 類型 Description
ID
 id string

TimeOff 請求的唯一 ID。
創建時間
 createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改時間
 lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
指派至
 assignedTo string

請求指派給的人員：「管理員」或「收件者」
State
 state string

「已批准」、「待處理」或「已拒絕」
傳送時間
 senderDateTime date-time

傳送請求的時間
寄件者訊息
 senderMessage string

來自要求寄件者的訊息
寄件者 ID
 senderUserId string

傳送要求之使用者的識別碼
經理行動時間
 managerActionDateTime date-time

經理回應的時間
經理訊息
 managerActionMessage string

經理的留言
管理員 ID
 managerUserId string

回應的管理員識別碼
從開始時間開始
 startDateTime date-time

請求關閉的開始時間
結束時間
 endDateTime date-time

請求關閉時間結束
請假原因識別碼
 timeOffReasonId string

TimeOff 原因的識別碼

OfferShiftRequest回應

優惠班次要求實體

名稱 路徑 類型 Description
ID
 id string

優惠班次請求的唯一ID。
創建時間
 createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改時間
 lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
指派至
 assignedTo string

請求指派給的人員：「管理員」或「收件者」
State
 state string

「已批准」、「待處理」或「已拒絕」
傳送時間
 senderDateTime date-time

傳送請求的時間
寄件者訊息
 senderMessage string

來自要求寄件者的訊息
寄件者 ID
 senderUserId string

傳送要求之使用者的識別碼
寄件者班次識別碼
 senderShiftId string

寄件者的班次識別碼
接收器時間
 recipientActionDateTime date-time

收件人回覆的時間
收件者訊息
 recipientActionMessage string

來自收件者的訊息
收件者 ID
 recipientUserId string

請求收件者的 ID
經理行動時間
 managerActionDateTime date-time

經理回應的時間
經理訊息
 managerActionMessage string

經理的留言
管理員 ID
 managerUserId string

回應的管理員識別碼

交換班次變更要求回應

交換班次要求實體

名稱 路徑 類型 Description
ID
 id string

交換班次請求的唯一 ID。
創建時間
 createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改時間
 lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
指派至
 assignedTo string

請求指派給的人員：「管理員」或「收件者」
State
 state string

「已批准」、「待處理」或「已拒絕」
傳送時間
 senderDateTime date-time

傳送請求的時間
寄件者訊息
 senderMessage string

來自要求寄件者的訊息
寄件者 ID
 senderUserId string

傳送要求之使用者的識別碼
寄件者班次識別碼
 senderShiftId string

寄件者的班次識別碼
接收器時間
 recipientActionDateTime date-time

收件人回覆的時間
收件者訊息
 recipientActionMessage string

來自收件者的訊息
收件者 ID
 recipientUserId string

請求收件者的 ID
收件者班次識別碼
 recipientShiftId string

收件者的班次識別碼
經理行動時間
 managerActionDateTime date-time

經理回應的時間
經理訊息
 managerActionMessage string

經理的留言
管理員 ID
 managerUserId string

回應的管理員識別碼

OpenShiftChangeRequestResponse

開啟班次變更要求實體

名稱 路徑 類型 Description
ID
 id string

「開啟班次變更」要求的唯一 ID。
創建時間
 createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改時間
 lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
指派至
 assignedTo string

請求指派給的人員：「管理員」或「收件者」
State
 state string

「已批准」、「待處理」或「已拒絕」
傳送時間
 senderDateTime date-time

傳送請求的時間
寄件者訊息
 senderMessage string

來自要求寄件者的訊息
寄件者 ID
 senderUserId string

傳送要求之使用者的識別碼
經理行動時間
 managerActionDateTime date-time

經理回應的時間
經理訊息
 managerActionMessage string

經理的留言
管理員 ID
 managerUserId string

回應的管理員識別碼
開啟班次 ID
 openShiftId string

所要求的空缺班次的 ID

OpenShift回應

開啟班次實體

名稱 路徑 類型 Description
ID
 id string

空缺班次的唯一 ID。
建立日期時間
 createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改日期時間
 lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
排程群組 ID
 schedulingGroupId string

排程群組 ID
上次修改者
 lastModifiedBy LastModifiedBy

上次修改者
共享開放班次
 sharedOpenShift SharedOpenShift

開放班次的共享版本
輪班選秀
 draftOpenShift DraftOpenShift

開放班的初步版本

共享OpenShift

開放班次的共享版本

名稱 路徑 類型 Description
顯示名稱
 displayName string

顯示名稱
註釋
 notes string

註釋
從開始時間開始
 startDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Theme
 theme string

Theme
開放插槽計數
 openSlotCount integer

開放插槽計數
activities
 activities Activities

輪班活動

草稿OpenShift

開放班的初步版本

名稱 路徑 類型 Description
顯示名稱
 displayName string

顯示名稱
註釋
 notes string

註釋
從開始時間開始
 startDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Theme
 theme string

Theme
開放插槽計數
 openSlotCount integer

開放插槽計數
activities
 activities Activities

輪班活動

Shift回應

轉移實體

名稱 路徑 類型 Description
ID
 id string

班次的唯一識別碼。
建立日期時間
 createdDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
修改日期時間
 lastModifiedDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
指派給使用者 ID
 userId string

指派給使用者 ID
排程群組 ID
 schedulingGroupId string

排程群組 ID
上次修改者
 lastModifiedBy LastModifiedBy

上次修改者
共享班次
 sharedShift SharedShift

輪班的共享版本
輪班
 draftShift DraftShift

轉變的初步版本

共享班次

輪班的共享版本

名稱 路徑 類型 Description
顯示名稱
 displayName string

顯示名稱
註釋
 notes string

註釋
從開始時間開始
 startDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Theme
 theme string

Theme
activities
 activities Activities

輪班活動

草稿轉移

轉變的初步版本

名稱 路徑 類型 Description
顯示名稱
 displayName string

顯示名稱
註釋
 notes string

註釋
從開始時間開始
 startDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Theme
 theme string

Theme
activities
 activities Activities

輪班活動

ScheduleResponse

排程實體

名稱 路徑 類型 Description
排程 ID
 id string

排程的唯一 ID。
排程時區
 timeZone string

排程的時區。
排程佈建狀態
 provisionStatus string

排程的供應狀態。
排程供應狀態碼
 provisionStatusCode string

排程的供應狀態代碼。

CreateATeam回應

名稱 路徑 類型 Description
新的團隊 ID
 newTeamId string

剛建立之小組的小組識別碼

PostToConversation回應

名稱 路徑 類型 Description
訊息 ID
 id string

唯一訊息ID
留言連結
 messageLink string

連結至 Microsoft Teams 中的訊息
交談識別碼
 conversationId string

聊天的唯一識別碼

Activities

輪班活動

名稱 路徑 類型 Description
已付費
 isPaid boolean

已付費
從開始時間開始
 startDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
結束時間
 endDateTime date-time

yyyy-MM-ddTHH：mm：ss.fffZ （UTC格式）
Code
 code string

Code
顯示名稱
 displayName string

顯示名稱

排程群組回應

排程群組實體

名稱 路徑 類型 Description
ID
 id string

排程群組的唯一識別碼。
顯示名稱
 displayName string

排程群組的顯示名稱。
處於活動狀態
 isActive boolean

指出在建立新實體或更新現有實體時是否可以使用排程群組。
使用者 ID
 userIds array of string

排程群組中使用者的 ID 清單。

AtMentionUser_V1

@mention 記號

名稱 路徑 類型 Description
@提及
 atMention string

@mention使用者的權杖。 此屬性可以插入訊息中

AtMentionTag回應

@mention 標籤的權杖

名稱 路徑 類型 Description
@mention標籤
 atMention string

標籤的 @mention權杖 。 它可以插入到人員傳送的訊息和最適化卡片中

NewChat回應

已建立新聊天的回應

名稱 路徑 類型 Description
交談識別碼
 id string

聊天的唯一識別碼

新會議回應

已建立之新會議的回應

名稱 路徑 類型 Description
ID
 id string

事件唯一識別碼
建立的時間戳記
 createdDateTime string

建立事件的時間戳記
上次修改時間戳記
 lastModifiedDateTime string

事件上次修改的時間戳記
類別
 categories array of

與事件相關聯的類別
時區
 timeZone string

活動時區
活動前提醒時間
 reminderMinutesBeforeStart integer

提醒警示發生的事件開始時間前的分鐘數
已啟用提醒
 isReminderOn boolean

如果警示設定為提醒使用者事件，請設定為 true
具有附件
 hasAttachments boolean

如果事件有附件，請設定為 true
主旨
 subject string

活動主旨行的文字
身體預覽
 bodyPreview string

與事件相關聯之訊息預覽
重要性
 importance string

事件的重要性。 可能的值為：低、正常、高
敏感度
 sensitivity string

事件的敏感性
是一整天
 isAllDay boolean

如果事件持續一整天，請設為 true
已取消
 isCancelled boolean

如果事件已取消，則設為 true
是組織者
 isOrganizer boolean

如果行事曆擁有者是活動的召集人，請設定為 true
請求回應
 responseRequested boolean

召集人希望受邀者傳送對活動的回應
顯示為
 showAs string

要顯示的狀態。 可能的值為：free、tempative、busy、oof、workingElsewhere、unknown。
類型
 type string

事件類型。 可能的值為：singleInstance、occurrence、exception、seriesMaster
最後的網頁
 webLink string

在 Outlook 網頁版中開啟事件的 URL。
線上會議網址
 onlineMeetingUrl string

線上會議的 URL
允許新的時間提案
 allowNewTimeProposals boolean

如果會議召集人允許受邀者在回應時提議新時間，則為 True
週期性模式
 recurrence.pattern object

事件的頻率
週期範圍
 recurrence.range object

活動的持續時間
回應
 responseStatus.response string

回應類型。 可能的值為：none、organizer、tempativelyAccepted、accepted、declined、notResponded
Time
 responseStatus.time string

傳回回應的日期和時間
內容類型
 body.contentType string

內容的型別。 可能的值為 text 和 html
活動訊息內容
 body.content string

活動內容
日期和時間
 start.dateTime string

事件的開始時間 （例如： '2017-08-29T04：00：00'）
日期和時間
 end.dateTime string

事件結束時間 （範例：「2017-08-29T04：00：00」）
顯示名稱
 location.displayName string

與位置相關聯的名稱
與會者
 attendees array of object

活動與會者集合
型別
 attendees.type string

出席者類型：必要、選擇性、資源
response
 attendees.status.response string

回應類型。 可能的值為：none、organizer、tempativelyAccepted、accepted、declined、notResponded
time
 attendees.status.time string

傳回回應的日期和時間
名稱
 attendees.emailAddress.name string

出席者的顯示名稱
address
 attendees.emailAddress.address string

出席者的電子郵件地址
名稱
 organizer.emailAddress.name string

召集人的顯示名稱
address
 organizer.emailAddress.address string

召集人的電子郵件地址
加入網址
 onlineMeeting.joinUrl string

啟動線上會議的外部連結

最後修改者

上次修改者

名稱 路徑 類型 Description
Application
 application string

Application
Device
 device string

Device
交談
 conversation string

交談
身份識別碼
 user.id string

身份識別碼
顯示名稱
 user.displayName string

顯示名稱

成員設定

設定成員是否可以在團隊中執行某些動作，例如建立頻道和新增機器人

名稱 路徑 類型 Description
允許成員建立/更新頻道
 allowCreateUpdateChannels boolean

如果設定為true，成員可以新增和更新頻道
允許成員刪除頻道
 allowDeleteChannels boolean

如果設定為 true，成員可以刪除頻道
允許成員添加/刪除應用程序
 allowAddRemoveApps boolean

如果設為 true，成員可以新增和移除應用程式
允許成員建立/更新/移除標籤
 allowCreateUpdateRemoveTabs boolean

如果設定為 true，成員可以新增、更新及移除索引標籤
允許成員建立/更新/移除連接器
 allowCreateUpdateRemoveConnectors boolean

如果設定為 true，成員可以新增、更新及移除連接器

GuestSettings

設定來賓是否可以在小組中建立、更新或刪除頻道的設定

名稱 路徑 類型 Description
允許來賓建立/更新頻道
 allowCreateUpdateChannels boolean

如果設定為 true，來賓可以新增和更新頻道
允許訪客刪除頻道
 allowDeleteChannels boolean

如果設定為 true，來賓可以刪除頻道

訊息設定

在團隊中配置消息和提及的設置

名稱 路徑 類型 Description
允許使用者編輯訊息
 allowUserEditMessages boolean

如果設為 true，使用者可以編輯其訊息
允許使用者刪除訊息
 allowUserDeleteMessages boolean

如果設為 true，使用者可以刪除其訊息
允許擁有者刪除郵件
 allowOwnerDeleteMessages boolean

如果設定為 true，擁有者可以刪除任何訊息
允許團隊提及
 allowTeamMentions boolean

如果設定為 true， @team 則允許提及
允許頻道提及
 allowChannelMentions boolean

如果設定為 true， @channel 則允許提及

趣味設定

配置在團隊中使用 Giphy、模因和貼紙的設置

名稱 路徑 類型 Description
允許 giphy
 allowGiphy boolean

如果設定為 true，則啟用 Giphy 使用
Giphy 內容評級
 giphyContentRating string

Giphy 內容評級。 可能的值為：moderate、strict
允許貼紙和模因
 allowStickersAndMemes boolean

如果設定為 true，則可讓使用者包含貼圖和迷因
允許自訂迷因
 allowCustomMemes boolean

如果設定為 true，則可讓使用者包含自訂迷因

探索設定

設定其他人可探索的小組。

名稱 路徑 類型 Description
顯示在小組的搜尋和建議中
 showInTeamsSearchAndSuggestions boolean

如果設定為 true，則小組會透過 Teams 用戶端的搜尋和建議來顯示

物件無類型