Microsoft 團隊

Microsoft Teams 讓你能在 Microsoft 365 的團隊工作空間中取得所有內容、工具和對話內容。

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

服務	Class	Regions
Copilot Studio	標準	除以下部分外，所有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 個使用者，但不支援來賓使用者。
需要工作流程應用程式	張貼最適化卡片並等待回應在聊天或頻道中張貼最適化卡片在聊天室或頻道中張貼訊息在頻道中回覆訊息在頻道中使用最適化卡片回覆更新聊天或頻道中的最適化卡片	這些操作需要 Workflows（前稱 Power Automate）應用程式的可用性，以及在 Teams 管理中心將應用程式設定為「允許」狀態。
無法與觸發器結合使用當有人回應調適型卡片時	在聊天或頻道中張貼最適化卡片	在「觸發器 + 接聽程式」工作流程中使用此觸發器可能會導致提交卡片時出現「發生問題，請重試」錯誤。發生此錯誤的原因是觸發流程（在聊天或頻道中張貼最適化卡片）在張貼卡片後未處理叫用回應。相反地，接聽程式流程的設計目的是要擷取叫用回應事件並繼續處理。不過，由於觸發程式流程不會處理回應，因此會傳回錯誤。使用貼文最適化卡片，並等候回應作為替代方案。
Flow Bot 不支援政府雲端（GCC/GCCH/DoD）租戶	張貼最適化卡片並等待回應在聊天或頻道中張貼最適化卡片在聊天室或頻道中張貼訊息在頻道中回覆訊息在頻道中使用最適化卡片回覆更新聊天或頻道中的最適化卡片	Flow Bot 海報選項僅在商業租戶中提供。政府雲端（GCC/GCCH/DoD）租戶不支援此功能。在政府雲端租戶中使用 Flow Bot 時，該動作會失敗，錯誤訊息為「BotNotInConversationRoster - 該機器人不屬於對話名單」。在政府雲端環境中工作時，請使用使用者海報選項，而非 Flow Bot。

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

簡短描述	Operations	完整描述
僅支援每個流程的使用者	新增聊天訊息時	當您在 Teams 參與者的任何聊天中張貼新的聊天訊息時，觸發程序每個流程只能支援一個使用者。
僅支持單個單詞	當提到關鍵字時	對於長度超過一個單詞的短語，觸發器不會觸發。
針對所有訊息相關資料引發	當提到關鍵字時	此資料包括訊息寄件者，以及包含傳送訊息時間的文字。
僅針對新增至頻道的根訊息引發	新增頻道訊息時	將新訊息張貼至 Teams 中的頻道時，觸發程式不會針對現有頻道訊息的回覆引發。
僅適用於預設環境	針對選取的訊息從撰寫框（V2）當有人回應最適化卡片時	這些觸發程式僅在預設環境中運作。
不適用於來賓或外部使用者	針對選取的訊息當有人回應最適化卡片時	此觸發程序不適用於小組中的來賓或外部使用者。
輪詢間隔為 3 分鐘	新增頻道訊息時在頻道留言中被提及的時候	這些觸發器使用 3 分鐘的輪詢間隔。
輪詢間隔為 5 分鐘	新增團隊成員時移除新團隊成員時	由於基礎 API 的限制，這些觸發器會使用 5 分鐘的輪詢間隔。這可能會導致觸發程序針對同一事件多次觸發。
不適用於具有隱藏成員的統一群組	新增團隊成員時移除新團隊成員時	這些觸發器不適用於具有隱藏成員的統一群組。
需要 Power Automate Actions 應用程式	針對選取的訊息	在 Power Automate 中，此觸發條件要求必須解除封鎖 Power Automate 動作應用程式（應用程式編號：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 設計器中建立的流程，來存取回調網址。

欲了解更多如何撰寫自適應卡的資訊，請參考：Create 流程將自適應卡張貼至 Microsoft Teams，以及 Adaptive Card 架構最佳實務以及 Adaptive card designer。

要求內文結構描述

Teams 的 webhook 操作支援兩種不同的請求主體結構：一種設計給一組調適型卡片，另一種則是針對單一訊息卡設計的。

請求本體（自適應卡片）

名稱	Key	為必填項目	類型	Description
型別	型別	yes	字串	值應該一律是「訊息」
attachments	attachments	否	物件陣列	調適型卡片專案物件的陣列。如需物件架構，請參閱下方的 AdaptiveCardItemSchema 。

請求主體（訊息卡）

請求主體應該是有效的訊息卡物件。關於範例與物件，請參見訊息卡結構與範例及訊息CarSchema

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)"
                    }
                ]
             }
          }
       ]
    }

訊息卡架構

名稱	Key	為必填項目	類型	Description
內容類型	內容類型	yes	字串	值應該一律是 “application/vnd.microsoft.card.adaptive”
內容網址	內容網址	yes	字串	值應一律為 Null
內容	內容	yes	物件	以 JSON 格式化的調適型卡片物件。如需範例和範本，請參閱 https://adaptivecards.io/samples

請求主體範例（訊息卡）

    {
    "@type": "MessageCard",
    "@context": "http://schema.org/extensions",
    "themeColor": "0076D7",
    "summary": "Larry Bryant created a new task",
    "sections": [{
        "activityTitle": "Larry Bryant created a new task",
        "activitySubtitle": "On Project Tango",
        "activityImage": "https://adaptivecards.io/content/cats/3.png",
        "facts": [{
            "name": "Assigned to",
            "value": "Unassigned"
        }, {
            "name": "Due date",
            "value": "Mon May 01 2017 17:07:18 GMT-0700 (Pacific Daylight Time)"
        }, {
            "name": "Status",
            "value": "Not started"
        }],
        "markdown": true
    }],
    "potentialAction": [{
        "@type": "ActionCard",
        "name": "Add a comment",
        "inputs": [{
            "@type": "TextInput",
            "id": "comment",
            "isMultiline": false,
            "title": "Add a comment here for this task"
        }],
        "actions": [{
            "@type": "HttpPOST",
            "name": "Add comment",
            "target": "https://learn.microsoft.com/outlook/actionable-messages"
        }]
    }, {
        "@type": "ActionCard",
        "name": "Set due date",
        "inputs": [{
            "@type": "DateInput",
            "id": "dueDate",
            "title": "Enter a due date for this task"
        }],
        "actions": [{
            "@type": "HttpPOST",
            "name": "Save",
            "target": "https://learn.microsoft.com/outlook/actionable-messages"
        }]
    }, {
        "@type": "OpenUri",
        "name": "Learn More",
        "targets": [{
            "os": "default",
            "uri": "https://learn.microsoft.com/outlook/actionable-messages"
        }]
    }, {
        "@type": "ActionCard",
        "name": "Change status",
        "inputs": [{
            "@type": "MultichoiceInput",
            "id": "list",
            "title": "Select a status",
            "isMultiSelect": "false",
            "choices": [{
                "display": "In Progress",
                "value": "1"
            }, {
                "display": "Active",
                "value": "2"
            }, {
                "display": "Closed",
                "value": "3"
            }]
        }],
        "actions": [{
            "@type": "HttpPOST",
            "name": "Save",
            "target": "https://learn.microsoft.com/outlook/actionable-messages"
        }]
    }]
}

    {
      "type": "message",
      "attachments": [
        {
          "contentType": "application/vnd.microsoft.card.adaptive",
          "content": {
            "type": "AdaptiveCard",
            "body": [
              {
                "type": "Image",
                "url": "data&colon;image/jpeg;base64,/xxxxxxxx"
              }
            ],
            "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
            "version": "1.0"
          }
        }
      ]
    }

在此範例中，影像會以 URL 設定為 Base64 編碼影像資料的型別 Image 附件包含在內。請確定您取代 /xxxxxxxx 為實際的 Base64 編碼影像資料。

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

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

使用 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);

範例程式碼參考

var formatted_Card_Payload = {
        "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": "Submitted response:"+ response
                        }
                    ]
                }
            }
        ]
    }

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

axios.post(webhookUrl , formatted_Card_Payload )
    .then(res => {
        console.log(`statusCode: ${res.status}`)
        console.log(res)
    })
    .catch(error => {
        console.error(error)
    })

參數

名稱	Key	為必填項目	類型	Description
觸發驗證類型	觸發驗證類型		字串	流程是否可以由任何人、租用戶中的任何使用者觸發，或只能由租用戶中的特定使用者觸發。
觸發允許使用者	觸發允許使用者		字串	允許觸發流程的使用者清單。只有在 triggerAuthenticationType 設定為「租使用者中的特定使用者」時才使用。

如果您選取「任何人」驗證選項，請勿傳遞驗證權杖標頭，否則對觸發程式的 POST 要求將會失敗。
如果您選取 [我的租使用者中的任何使用者] 或 [我的租使用者中的特定使用者] 驗證選項，您必須將要求中的驗證權杖傳遞至 [收到 Teams Webhook 要求時] 觸發程序。
您可以在下列檔中找到所需宣告的詳細資訊：新增 HTTP 要求觸發程式的 OAuth 驗證

退貨

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

節流限制

你的 Power Automate 效能設定檔決定了「當收到 Teams webhook 請求時」觸發器的限速限制。您可以在效能設定檔中判斷您的效能設定檔。
這些限制與執行階段端點要求限制相同。
如需流程節流限制的一般資訊，請參閱自動化、排程和即時流程的限制。

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

正在建立連線

連接器支援下列驗證類型：


Microsoft Teams 資歷（GCC 高隊）	使用 Microsoft Teams 憑證登入（Teams GCC High）。	Azure Government only	不可共享
Microsoft Teams憑證（Teams 公開/Teams GCC）	請使用 Microsoft Teams 憑證登入（Teams 公開版/Teams GCC）。	Azure Government only	不可共享
預設值	使用您的憑據登錄。	除 Azure Government 外的所有區域	不可共享

Microsoft Teams 憑證（Teams GCC 高難度）

驗證 ID：oauthGccHigh

適用： Azure Government only

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

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

Microsoft Teams 憑證（Teams 公開版/Teams GCC）

驗證 ID：oauthPublic

適用： Azure Government only

請使用 Microsoft Teams 憑證登入（Teams 公開版/Teams GCC）。

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

預設

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

使用您的憑據登錄。

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

節流限制

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

動作

使用頻道中的最適化卡片回覆	使用調適型卡片回覆頻道訊息
列出 AI 洞察	列出線上會議所需的 AI 生成洞見。需要 Microsoft 365 Copilot 授權。
列出區段	列出目前使用者的團隊合作區塊
列出團隊標籤的成員	列出團隊標籤的成員
列出團隊的所有標籤	列出團隊的標籤
列出小組成員	列出 Microsoft Teams 中團隊成員
列出已加入的團隊	列出你所屬的 Microsoft Teams 中所有團隊
列出所有頻道	列出特定小組的所有頻道，包括與小組共用的頻道
列出相關聯的團隊	列出您直接成員的所有團隊，或是團隊內部託管的共用頻道的成員。
列出聊天記錄	列出您最近參與的聊天記錄
列出頻道	列出特定小組的所有頻道
列出頻道訊息的回覆	列出特定小組中頻道中訊息的回覆。對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
列表聊天或頻道成員	列出群組聊天或頻道的直接成員
刪除一個區段	刪除目前使用者的團隊工作區塊
刪除團隊標籤	從小組中刪除標籤
取得使用者的@mention權杖	建立權杖，可插入訊息或最適化卡片 @mention 給使用者。
取得團隊標籤的@mention權杖	建立權杖，可插入到訊息或最適化卡片中，以通道中的使用者身分傳送至 @mention 小組標籤。
取得小組中特定頻道的詳細資料	取得頻道詳細資料
取得所有臨時通話記錄	取得登入用戶臨時通話的所有文字記錄
取得所有臨時通話錄音	取得登入用戶臨時通話的所有錄音
取得會議逐字稿	取得線上會議的特定逐字稿
取得會議逐字稿內容	取得會議逐字稿的內容
取得會議錄影內容	取得會議錄影的內容串流
取得訊息詳細資料	取得聊天或頻道中訊息的詳細資料。
取得通話逐字稿	拿到一份特定的逐字稿，用於臨時通話
取得通話逐字稿內容	取得通話記錄的內容
取得通話錄音	為臨時通話取得特定錄音
取得通話錄音內容	取得通話錄音內容
名單通話錄音	列出臨時通話的所有錄音
在聊天中收到訊息	從一對一或群組聊天中擷取訊息
在聊天室或頻道中張貼訊息	將訊息張貼至聊天室或頻道
在頻道中回覆訊息	使用訊息回覆頻道訊息
在頻道中接收訊息	從特定小組中的頻道取得訊息。對於共用頻道，團隊 ID 必須參照主持人團隊，也就是擁有共享頻道的團隊。
將一名成員從團隊中移除	移除 Microsoft Teams 團隊中的成員
將您自己的最適化卡片作為 Flow 機器人張貼給使用者 [已取代]	新增 JSON 卡片定義，以建立 Teams 使用者的自訂訊息。訊息可以包含影像、圖表、文字等。
將您自己的最適化卡片作為 Flow 機器人發佈到管道 [已棄用]	新增 JSON 卡片定義，以建立 Teams 頻道的自訂貼文。該帖子可以包含圖像、圖表、文本等。
將成員新增至團隊	在 Microsoft Teams 中新增一名成員到 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 必須參照主持人團隊，也就是擁有共享頻道的團隊。
從區塊中移除項目	移除使用者自訂團隊合作區塊中的一項物品。底層的聊天室、頻道、會議或社群不會被刪除;項目會回到其預設的系統定義區塊。
從團隊標籤中刪除成員	從團隊標籤中刪除成員
從通道中移除直接成員	移除 Microsoft Teams 中某個頻道的直接成員。頻道必須是私人頻道或共享頻道。
拿個隊牌	從團隊獲得特定ID標籤
拿到一個區域	依ID獲得特定的團隊合作區塊
新增一位使用者加入聊天室	在 Microsoft Teams 中新增一個聊天室的使用者。
新增成員到頻道	在 Microsoft Teams 中新增一個頻道成員。頻道必須是私人頻道或共享頻道。
更新某個區段	更新目前使用者的團隊工作區塊
更新球隊標籤	更新團隊中標籤的顯示名稱
更新聊天或頻道中的最適化卡片	更新現有的最適化卡片
會議逐字稿列表	列出線上會議的所有逐字稿
會議錄音列表	列出線上會議的所有錄音
清單章節項目	列出團隊合作區塊中的項目（聊天室、頻道、會議、社群）。每個物品一次只屬於一個區塊。
獲取 AI 洞察	為線上會議獲得特定的 AI 生成洞察。需要 Microsoft 365 Copilot 授權。
班次：列出所有交換班次要求 [已淘汰]	此動作已被取代。請改用列出團隊中的所有交換班次請求。 ~~此作業會傳回排程中的所有交換班次要求~~
班次：列出所有優惠班次要求 [已取代]	此動作已被取代。請改用列出團隊中的所有選件轉移請求。 ~~此作業會傳回排程中的所有優惠方案班次請求~~
班次：列出所有排程群組 [已淘汰]	此動作已被取代。請改用列出團隊中的所有排程群組。 ~~此作業會傳回排程中的所有排程群組~~
班次：列出所有班次 [已淘汰]	此動作已被取代。請改用列出團隊中的所有班次。 ~~此作業會傳回指派給小組成員的所有班次~~
班次：列出所有請假原因 [已棄用]	此動作已被取代。請改用列出團隊中的所有請假原因。 ~~此作業會傳回與小組相關聯的請假原因清單。~~
班次：列出所有請假申請 [已淘汰]	此動作已被取代。請改用列出團隊中的所有請假請求。 ~~此作業會傳回排程中的所有請假要求~~
班次：列出所有開啟的班次 [已棄用]	此動作已被取代。請改用列出團隊中的所有空缺班次。 ~~此作業會傳回小組中的所有空缺班次~~
班次：列出所有開啟的班次要求 [已淘汰]	此動作已被取代。請改用列出團隊中的所有 Open Shift 請求。 ~~此作業會傳回排程中的所有未結班次變更要求~~
班次：刪除班次 [已棄用]	此動作已被取代。請改用刪除班次。 ~~此作業會使用班次的唯一識別碼刪除班次。~~
班次：刪除開啟的班次 [已淘汰]	此動作已被取代。請改用刪除空缺班次。 ~~此作業會刪除空缺班次。~~
班次：取得排程的詳細資料 [已取代]	此動作已被取代。請改用 [取得排程] 的詳細資料。 ~~此作業會使用排程的唯一識別碼傳回排程的詳細資料。~~
班次：取得排程群組 [已淘汰]	此動作已被取代。請改用取得排程群組。 ~~此作業會使用排程群組的唯一識別碼傳回詳細資料。~~
班次：取得班次 [已取代]	此動作已被取代。請改用 Get a Shift 。 ~~此作業會使用班次的唯一識別碼傳回班次的詳細資料。~~
班次：取得空缺班次 [已取代]	此動作已被取代。請改用 Get an Open Shift 。 ~~此作業會傳回未開班次的詳細資料。~~
班次：建立新的開放班次 [已淘汰]	此動作已被取代。請改用建立新的空缺班次。 ~~在排程中建立新的空缺班次~~
班次：拒絕交換班次要求 [已淘汰]	此動作已被取代。請改用「拒絕交換班次」請求。 ~~此作業可讓使用者拒絕交換班次要求。~~
班次：拒絕優惠班次請求 [已淘汰]	此動作已被取代。請改用拒絕優惠轉移請求。 ~~此作業可讓使用者拒絕優惠方案班次請求。~~
班次：拒絕請假申請 [已棄用]	此動作已被取代。請改用「拒絕請假申請」。 ~~此作業可讓經理拒絕請假請求。~~
班次：拒絕開啟的班次要求 [已棄用]	此動作已被取代。請改用拒絕 Open Shift 請求。 ~~此作業可讓經理拒絕未結班次要求。~~
班次：更新空缺班次 [已淘汰]	此動作已被取代。請改用更新空缺班次。 ~~更新排程中的空缺班次。~~
班次：核准交換班次要求 [已淘汰]	此動作已被取代。請改用核准交換班次要求。 ~~此作業可讓使用者核准交換班次要求。~~
班次：核准優惠班次要求 [已淘汰]	此動作已被取代。請改用核准優惠班次請求。 ~~此作業可讓收件者/管理員核准優惠方案班次請求。~~
班次：核准請假申請 [已淘汰]	此動作已被取代。請改用「核准請假」要求。 ~~此作業可讓經理核准請假申請。~~
班次：核准開啟班次要求 [已棄用]	此動作已被取代。請改用核准空班請求。 ~~此作業可讓經理核准「開放輪班」要求。~~
發送 Microsoft Graph HTTP 請求	請建構一個 Microsoft Graph REST API 請求，針對 Microsoft Teams 端點呼叫。這些區塊支援：第一區段：/teams、/me、/users 第二區段：頻道、聊天室、安裝應用程式、訊息、置頂訊息、線上會議。深入了解：https://docs.microsoft.com/en-us/graph/use-the-api
移動一個區段項目	原子方式將項目從一個用戶定義的團隊工作區塊移動到另一個用戶定義區塊。每個物品一次只能屬於一個區塊。此動作會將該項目從當前區塊移除，並加入目標區塊。
組建團隊	在 Microsoft Teams 中取得團隊的詳細資料。
給自己留言	會向已登入使用者在 Microsoft Teams 的備忘錄聊天室發送訊息。
聊天或頻道中的明信片	將卡片張貼至聊天室或頻道
通話記錄	列出臨時通話的所有逐字稿
錄音會議	會拿到一段特定的線上會議錄音
預約線上會議	取得線上會議的屬性與關係。你可以用會議編號、加入網頁網址或加入會議 ID 查詢會議。

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

作業識別碼：: ReplyWithCardToConversation

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

參數

名稱	機碼	必要	類型	Description
發佈為	poster	True	string	選取選項
貼入	location	True	string	選取選項
回覆最適化卡片要求	body	True	dynamic	回覆最適化卡片要求

傳回

身體: PostToConversationResponse

列出 AI 洞察

作業識別碼：: ListAiInsights

列出線上會議所需的 AI 生成洞見。需要 Microsoft 365 Copilot 授權。

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼

傳回

身體: AiInsightCollectionResponse

列出區段

作業識別碼：: ListSections

列出目前使用者的團隊合作區塊

傳回

身體: ListSectionsResponse

列出團隊標籤的成員

作業識別碼：: GetTagMembers

列出團隊標籤的成員

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
標記	tagId	True	string	選取標籤

傳回

身體: GetTagMembersResponseSchema

列出團隊的所有標籤

作業識別碼：: GetTags

列出團隊的標籤

參數

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

傳回

身體: GetTagsResponseSchema

列出小組成員

作業識別碼：: ListTeamMembers

列出 Microsoft Teams 中團隊成員

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	選擇團隊
篩選查詢	$filter		string	用於限制傳回專案的 OData 篩選查詢（例如 membershipType eq 'standard'）。
頂端	$top		string	OData 頂端查詢選項，用以指定回傳的最大條目數。

傳回

清單成員回應結構描述

身體: ListMembersResponseSchema

列出已加入的團隊

作業識別碼：: GetAllTeams

列出你所屬的 Microsoft Teams 中所有團隊

傳回

名稱	路徑	類型	Description
團隊列表	value	array of object	您所屬的團隊列表
Description	value.description	string	小組的選擇性描述
名稱	value.displayName	string	小組的名稱
ID	value.id	string	團隊的唯一識別碼，也稱為 Microsoft 365 群組 ID

列出所有頻道

作業識別碼：: 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

列表聊天或頻道成員

作業識別碼：: ListMembers

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

參數

名稱	機碼	必要	類型	Description
螺紋類型	threadType	True	string	選擇訊息類型
篩選查詢	$filter		string	用於限制傳回專案的 OData 篩選查詢（例如 membershipType eq 'standard'）。
列出成員要求	body	True	dynamic	清單成員要求

傳回

清單成員回應結構描述

身體: ListMembersResponseSchema

刪除一個區段

作業識別碼：: DeleteSection

刪除目前使用者的團隊工作區塊

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼
Etag	If-Match	True	string	你列出區段時回傳的註解值 @microsoft.graph.sectionsVersion ，或 @odata.etag 是先前檢索過的任何區段的值。這是實現樂觀並發控制所必需的。

刪除團隊標籤

作業識別碼：: 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

取得所有臨時通話記錄

作業識別碼：: GetAllAdhocCallTranscripts

取得登入用戶臨時通話的所有文字記錄

參數

名稱	機碼	類型	Description
開始日期時間	startDateTime	date-time	開始日期與時間以篩選成績單
結束日期時間	endDateTime	date-time	篩選成績單的結束日期與時間
頂端	$top	integer	需回傳的逐字稿數量
跳過代幣	$skiptoken	string	分頁跳過標記
三角洲代幣	$deltatoken	string	用於追蹤變更的 delta 代幣

傳回

身體: CallTranscriptCollectionResponse

取得所有臨時通話錄音

作業識別碼：: GetAllAdhocCallRecordings

取得登入用戶臨時通話的所有錄音

參數

名稱	機碼	類型	Description
開始日期時間	startDateTime	date-time	開始日期與時間以篩選錄音
結束日期時間	endDateTime	date-time	錄音過濾的結束日期與時間
頂端	$top	integer	回歸錄音的數量
跳過代幣	$skiptoken	string	分頁跳過標記
三角洲代幣	$deltatoken	string	用於追蹤變更的 delta 代幣

傳回

身體: CallRecordingCollectionResponse

取得會議逐字稿

作業識別碼：: GetMeetingTranscript

取得線上會議的特定逐字稿

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼
成績單 ID	transcriptId	True	string	逐字稿識別碼

傳回

通話記錄

身體: CallTranscriptResponse

取得會議逐字稿內容

作業識別碼：: GetMeetingTranscriptContent

取得會議逐字稿的內容

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼
成績單 ID	transcriptId	True	string	逐字稿識別碼

傳回

response: string

取得會議錄影內容

作業識別碼：: GetMeetingRecordingContent

取得會議錄影的內容串流

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼
錄音識別碼	recordingId	True	string	錄音識別碼

傳回

response: file

取得訊息詳細資料

作業識別碼：: GetMessageDetails

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

參數

名稱	機碼	必要	類型	Description
Message	messageId	True	string	訊息 ID
訊息類型	threadType	True	string	選擇訊息類型
取得訊息詳細資料要求	body	True	dynamic	取得訊息詳細資料要求

傳回

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

取得通話逐字稿

作業識別碼：: GetCallTranscript

拿到一份特定的逐字稿，用於臨時通話

參數

名稱	機碼	必要	類型	Description
通話識別碼	callId	True	string	呼號
成績單 ID	transcriptId	True	string	逐字稿識別碼

傳回

通話記錄

身體: CallTranscriptResponse

取得通話逐字稿內容

作業識別碼：: GetCallTranscriptContent

取得通話記錄的內容

參數

名稱	機碼	必要	類型	Description
通話識別碼	callId	True	string	呼號
成績單 ID	transcriptId	True	string	逐字稿識別碼

傳回

response: string

取得通話錄音

作業識別碼：: GetCallRecording

為臨時通話取得特定錄音

參數

名稱	機碼	必要	類型	Description
通話識別碼	callId	True	string	呼號
錄音識別碼	recordingId	True	string	錄音識別碼

傳回

通話錄音

身體: CallRecordingResponse

取得通話錄音內容

作業識別碼：: GetCallRecordingContent

取得通話錄音內容

參數

名稱	機碼	必要	類型	Description
通話識別碼	callId	True	string	呼號
錄音識別碼	recordingId	True	string	錄音識別碼

傳回

response: file

名單通話錄音

作業識別碼：: ListCallRecordings

列出臨時通話的所有錄音

參數

名稱	機碼	必要	類型	Description
通話識別碼	callId	True	string	呼號

傳回

身體: CallRecordingCollectionResponse

在聊天中收到訊息

作業識別碼：: GetMessagesFromChat

從一對一或群組聊天中擷取訊息

參數

名稱	機碼	必要	類型	Description
交談識別碼	chatId	True	string	聊天的唯一識別碼
篩選查詢	$filter		string	用於限制傳回專案的 OData 篩選查詢（例如 membershipType eq 'standard'）。
訂購方式	$orderby		string	用於指定項目順序的 OData orderBy 查詢選項（例如 displayName asc）。
頂端	$top		string	OData 頂端查詢選項，用以指定回傳的最大條目數。

傳回

身體: GetMessagesFromConversation_Response

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

作業識別碼：: PostMessageToConversation

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

參數

名稱	機碼	必要	類型	Description
發佈為	poster	True	string	選取選項
貼入	location	True	string	選取選項
張貼訊息請求	body	True	dynamic	張貼訊息要求

傳回

身體: PostToConversationResponse

在頻道中回覆訊息

作業識別碼：: ReplyWithMessageToConversation

使用訊息回覆頻道訊息

參數

名稱	機碼	必要	類型	Description
發佈為	poster	True	string	選取選項
貼入	location	True	string	選取選項
回覆訊息要求	body	True	dynamic	回覆訊息要求

傳回

身體: PostToConversationResponse

在頻道中接收訊息

作業識別碼：: GetMessagesFromChannel

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

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
Channel	channelId	True	string	頻道 ID

傳回

身體: GetMessagesFromConversation_Response

將一名成員從團隊中移除

作業識別碼：: RemoveMemberFromTeam

移除 Microsoft Teams 團隊中的成員

參數

名稱	機碼	必要	類型	Description
球隊	teamId	True	string	選擇團隊
會員編號	membershipId	True	string	要從團隊中移除的成員身份

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

作業識別碼：: PostUserAdaptiveCard

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

參數

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

傳回

身體: MessageId

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

作業識別碼：: PostChannelAdaptiveCard

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

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
張貼最適化卡片要求	PostAdaptiveCardRequest	True	dynamic	貼文最適化卡片要求

傳回

身體: MessageId

將成員新增至團隊

作業識別碼：: AddMemberToTeam

在 Microsoft Teams 中新增一名成員到 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	具有選項訂閱要求的使用者訊息

傳回

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

將項目加入區塊

作業識別碼：: AddSectionItem

將目前在系統定義區塊中的項目（聊天室、頻道、會議或社群）加入使用者定義的團隊工作區塊。使用移動區段項目來重新定位已在另一個使用者定義區塊中的項目。

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼
Etag	If-Match	True	string	你列出區段時回傳的註解值 @microsoft.graph.sectionsVersion ，或 @odata.etag 是先前檢索過的任何區段的值。這是實現樂觀並發控制所必需的。
項目 ID	id	True	string	新增該群組、頻道、會議或社群的對話 ID。對於社群項目，服務會自動將 ID 正規化為 19：{id}@EngageCommunity 格式。

傳回

團隊合作區塊中的一個項目（聊天室、頻道、會議或社群）

身體: SectionItemResponse

建立 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

建立一個區塊

作業識別碼：: CreateSection

為現有使用者建立新的團隊合作區塊

參數

名稱	機碼	必要	類型	Description
Etag	If-Match	True	string	你列出區段時回傳的註解值 @microsoft.graph.sectionsVersion ，或 @odata.etag 是先前檢索過的任何區段的值。這是實現樂觀並發控制所必需的。
顯示名稱	displayName	True	string	該區段的顯示名稱
圖示類型	iconType		string	圖示類型。表情符號 Unicode 字元。
是擴展的	isExpanded		boolean	該區是否被擴展
排序類型	sortType		string	該區段的排序類型

傳回

團隊合作部門

身體: SectionResponse

建立團隊

作業識別碼：: 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 中出現的樣貌
會員類型	membershipType		string	頻道的類型。私人頻道僅限特定會員使用。共享頻道可以與團隊外的使用者分享。預設是標準。

傳回

名稱	路徑	類型	Description
Description	description	string	頻道的選用文字描述
顯示名稱	displayName	string	頻道名稱在 Microsoft Teams 中出現的樣貌
ID	id	string	頻道的唯一識別碼
會員類型	membershipType	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	訊息內文。

從區塊中移除項目

作業識別碼：: RemoveSectionItem

移除使用者自訂團隊合作區塊中的一項物品。底層的聊天室、頻道、會議或社群不會被刪除;項目會回到其預設的系統定義區塊。

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼
章節項目編號	sectionItemId	True	string	章節項目 ID（底層聊天、頻道、會議或社群的對話 ID）
Etag	If-Match	True	string	你列出區段時回傳的註解值 @microsoft.graph.sectionsVersion ，或 @odata.etag 是先前檢索過的任何區段的值。這是實現樂觀並發控制所必需的。

從團隊標籤中刪除成員

作業識別碼：: DeleteTagMember

從團隊標籤中刪除成員

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
標記	tagId	True	string	選取標籤
標籤成員ID	tagMemberId	True	string	要從標籤中移除的成員識別碼

從通道中移除直接成員

作業識別碼：: RemoveMemberFromChannel

移除 Microsoft Teams 中某個頻道的直接成員。頻道必須是私人頻道或共享頻道。

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
Channel	channelId	True	string	頻道 ID
會員編號	membershipId	True	string	直接移除該會員的會員編號

拿個隊牌

作業識別碼：: GetTag

從團隊獲得特定ID標籤

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
標記	tagId	True	string	選取標籤

傳回

為團隊建立的標籤

標記: CreateTagResponseSchema

拿到一個區域

作業識別碼：: GetSection

依ID獲得特定的團隊合作區塊

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼

傳回

團隊合作部門

身體: SectionResponse

新增一位使用者加入聊天室

作業識別碼：: AddMemberToChat

在 Microsoft Teams 中新增一個聊天室的使用者。

參數

名稱	機碼	必要	類型	Description
交談識別碼	chatId	True	string	聊天的唯一識別碼
User	userId	True	string	使用者主體名稱或 Microsoft Entra ID 以新增
將使用者設為聊天室擁有者	owner		boolean	沒錯，如果使用者應該是聊天室擁有者的話
可見歷史開始日期	visibleHistoryStartDateTime		date-time	時間戳記代表新成員能看到聊天歷史的多遠。若未特別說明，則不分享歷史。

新增成員到頻道

作業識別碼：: AddMemberToChannel

在 Microsoft Teams 中新增一個頻道成員。頻道必須是私人頻道或共享頻道。

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
Channel	channelId	True	string	頻道 ID
User	userId	True	string	使用者主體名稱或 Microsoft Entra ID 以新增
設定使用者為頻道擁有者	owner		boolean	沒錯，如果使用者應該是頻道擁有者

更新某個區段

作業識別碼：: UpdateSection

更新目前使用者的團隊工作區塊

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼
Etag	If-Match	True	string	你列出區段時回傳的註解值 @microsoft.graph.sectionsVersion ，或 @odata.etag 是先前檢索過的任何區段的值。這是實現樂觀並發控制所必需的。
顯示名稱	displayName		string	該區段的顯示名稱
圖示類型	iconType		string	圖示類型。表情符號 Unicode 字元。
是擴展的	isExpanded		boolean	該區是否被擴展
排序類型	sortType		string	該區段的排序類型

傳回

團隊合作部門

身體: SectionResponse

更新球隊標籤

作業識別碼：: UpdateTag

更新團隊中標籤的顯示名稱

參數

名稱	機碼	必要	類型	Description
球隊	groupId	True	string	選擇團隊
標記	tagId	True	string	選取標籤
顯示名稱	displayName	True	string	標籤的新名稱在 Microsoft Teams 中顯示給使用者時的樣貌。

傳回

為團隊建立的標籤

標記: CreateTagResponseSchema

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

作業識別碼：: UpdateCardInConversation

更新現有的最適化卡片

參數

名稱	機碼	必要	類型	Description
發佈為	poster	True	string	選取選項
貼入	location	True	string	選取選項
更新調適型卡片要求	body	True	dynamic	更新最適化卡片要求

會議逐字稿列表

作業識別碼：: ListMeetingTranscripts

列出線上會議的所有逐字稿

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼

傳回

身體: CallTranscriptCollectionResponse

會議錄音列表

作業識別碼：: ListMeetingRecordings

列出線上會議的所有錄音

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼

傳回

身體: CallRecordingCollectionResponse

清單章節項目

作業識別碼：: ListSectionItems

列出團隊合作區塊中的項目（聊天室、頻道、會議、社群）。每個物品一次只屬於一個區塊。

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼

傳回

身體: ListSectionItemsResponse

獲取 AI 洞察

作業識別碼：: GetAiInsight

為線上會議獲得特定的 AI 生成洞察。需要 Microsoft 365 Copilot 授權。

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼
AI 洞察識別碼	aiInsightId	True	string	AI 洞察識別碼

傳回

為線上會議提供 AI 生成的洞察

身體: AiInsightResponse

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

作業識別碼：: 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	接受請求時，管理員向寄件者/收件者發送的訊息。

發送 Microsoft Graph HTTP 請求

作業識別碼：: HttpRequest

請建構一個 Microsoft Graph REST API 請求，針對 Microsoft Teams 端點呼叫。這些區塊支援：第一區段：/teams、/me、/users 第二區段：頻道、聊天室、安裝應用程式、訊息、置頂訊息、線上會議。深入了解：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

移動一個區段項目

作業識別碼：: MoveSectionItem

原子方式將項目從一個用戶定義的團隊工作區塊移動到另一個用戶定義區塊。每個物品一次只能屬於一個區塊。此動作會將該項目從當前區塊移除，並加入目標區塊。

參數

名稱	機碼	必要	類型	Description
區段 ID	sectionId	True	string	分區識別碼
章節項目編號	sectionItemId	True	string	章節項目 ID（底層聊天、頻道、會議或社群的對話 ID）
Etag	If-Match	True	string	你列出區段時回傳的註解值 @microsoft.graph.sectionsVersion ，或 @odata.etag 是先前檢索過的任何區段的值。這是實現樂觀並發控制所必需的。
目標區段識別碼	targetSectionId	True	string	要移動該項目的區段 ID

傳回

團隊合作區塊中的一個項目（聊天室、頻道、會議或社群）

身體: SectionItemResponse

組建團隊

作業識別碼：: GetTeam

在 Microsoft Teams 中取得團隊的詳細資料。

參數

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

傳回

取得小組回應

身體: GetTeamResponse

給自己留言

作業識別碼：: PostMessageToSelf

會向已登入使用者在 Microsoft Teams 的備忘錄聊天室發送訊息。

參數

名稱	機碼	必要	類型	Description
內容類型	contentType		string	訊息內容的類型
Content	content	True	string	訊息的文字或 HTML 內容

傳回

頻道中的訊息、一對一聊天或群組聊天

Message: ChatMessage

聊天或頻道中的明信片

作業識別碼：: PostCardToConversation

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

參數

名稱	機碼	必要	類型	Description
發佈為	poster	True	string	選取選項
貼入	location	True	string	選取選項
明信片請求	body	True	dynamic	請求明信片

傳回

身體: PostToConversationResponse

通話記錄

作業識別碼：: ListCallTranscripts

列出臨時通話的所有逐字稿

參數

名稱	機碼	必要	類型	Description
通話識別碼	callId	True	string	呼號

傳回

身體: CallTranscriptCollectionResponse

錄音會議

作業識別碼：: GetMeetingRecording

會拿到一段特定的線上會議錄音

參數

名稱	機碼	必要	類型	Description
會議編號	meetingId	True	string	線上會議識別碼
錄音識別碼	recordingId	True	string	錄音識別碼

傳回

通話錄音

身體: CallRecordingResponse

預約線上會議

作業識別碼：: GetOnlineMeeting

取得線上會議的屬性與關係。你可以用會議編號、加入網頁網址或加入會議 ID 查詢會議。

參數

名稱	機碼	必要	類型	Description
查詢來源	lookupType	True	string	選擇如何識別會議
查詢值	lookupValue	True	string	對應所選查詢類型的值（會議 ID、join web URL 或 join meeting ID）

傳回

身體: GetOnlineMeeting_Response

觸發程序

在頻道留言中被提及的時候	當將目前使用者新增至小組中的頻道的新 @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

傳回

頻道中的訊息、一對一聊天或群組聊天

Message: ChatMessage

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

作業識別碼：: WebhookNewMessageTrigger

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

參數

名稱	機碼	必要	類型	Description
訊息類型	threadType	True	string	選擇訊息類型
requestBody	requestBody		dynamic	這是 Webhook 的要求內文

傳回

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

從撰寫框（V2）

作業識別碼：: OnComposeMessageV2

這個觸發器讓你能從 Microsoft Teams 的撰寫訊息框開始流程。（僅支援 Power Automate。）

參數

名稱	機碼	必要	類型
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

傳回

頻道中的訊息、一對一聊天或群組聊天

Message: ChatMessage

當我@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

當逐字稿可用時

作業識別碼：: TranscriptTrigger

當逐字稿可供會議或臨時通話時觸發。

參數

名稱	機碼	必要	類型	Description
Scope	scopeType	True	string	可監控的逐字稿範圍
body	body	True	dynamic

傳回

逐字稿詳情

身體: TranscriptWebhookResponseSchema

移除新團隊成員時

作業識別碼：: OnGroupMembershipRemoval

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

參數

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

傳回

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

針對選取的訊息（V2）

作業識別碼：: OnMessageSelectedV2

此觸發器允許你在 Microsoft Teams 中為所選訊息啟動流程。（僅支援 Power Automate。）

參數

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

傳回

名稱	路徑	類型	Description
body	body	object

錄音何時可用

作業識別碼：: RecordingTrigger

當錄音可用於會議或臨時通話時觸發。

參數

名稱	機碼	必要	類型	Description
Scope	scopeType	True	string	監控錄音範圍
body	body	True	dynamic

傳回

錄音細節

身體: RecordingWebhookResponseSchema

定義

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	會員的電子郵件地址
會員編號	value.id	string	使用者在對話中的成員身份識別
角色	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	使用的訊息反應

TeamsIdentitySet

身份集：通常會填充應用程式、裝置或使用者的身份集。每個恆等式透過 @odata.type是多態的。

名稱	路徑	類型
OData 類型	application.@odata.type	string
應用程式識別碼	application.id	string
應用程式顯示名稱	application.displayName	string
應用程式身份類型	application.applicationIdentityType	string
OData 類型	device.@odata.type	string
裝置標識碼	device.id	string
裝置顯示名稱	device.displayName	string
OData 類型	user.@odata.type	string
使用者識別碼	user.id	string
使用者身分類型	user.userIdentityType	string
使用者主體名稱	user.userPrincipalName	string

逐字稿Webhook回應架構

逐字稿詳情

名稱	路徑	類型	Description
成績單 ID	id	string	逐字稿識別碼
OData ID	@odata.id	string	OData 識別碼
會議編號	meetingId	string	線上會議識別碼（臨時通話記錄為空）
通話識別碼	callId	string	通話識別碼（針對臨時通話逐字稿設定）
內容相關識別碼	contentCorrelationId	string	內容相關識別碼
會議組織者	meetingOrganizer	TeamsIdentitySet	身份集：通常會填充應用程式、裝置或使用者的身份集。每個恆等式透過 @odata.type是多態的。
逐字稿內容網址	transcriptContentUrl	string	下載逐字稿內容的網址
建立日期時間	createdDateTime	date-time	逐字稿製作時間（UTC）
結束日期時間	endDateTime	date-time	逐字稿結束的時間（UTC）

RecordingWebhookResponseSchema

錄音細節

名稱	路徑	類型	Description
錄音識別碼	id	string	記錄識別碼
OData ID	@odata.id	string	OData 識別碼
會議編號	meetingId	string	線上會議識別碼（臨時通話錄音用空）
通話識別碼	callId	string	通話識別碼（用於臨時通話錄音設定）
內容相關識別碼	contentCorrelationId	string	內容相關識別碼
會議組織者	meetingOrganizer	TeamsIdentitySet	身份集：通常會填充應用程式、裝置或使用者的身份集。每個恆等式透過 @odata.type是多態的。
錄音內容網址	recordingContentUrl	string	下載錄音內容的網址
建立日期時間	createdDateTime	date-time	錄製時間（UTC）
結束日期時間	endDateTime	date-time	錄音結束的時間（UTC）

ChatMessageWebhook回應架構

訊息詳細資料

名稱	路徑	類型	Description
Message	value	array of object	訊息詳細資料回應
交談識別碼	value.conversationId	string	聊天的唯一識別碼
ID	value.messageId	string	訊息 ID
Link	value.linkToMessage	string	留言連結

訊息標識符

名稱	路徑	類型	Description
訊息 ID	id	string	唯一訊息識別碼

GetMessagesFromConversation_Response

名稱	路徑	類型	Description
@odata.上下文	@odata.context	string	@odata.context
@odata.計數	@odata.count	integer	@odata.count
@odata.next連結	@odata.nextLink	string	@odata.nextLink
訊息清單	value	ChatMessageList	團隊中特定對話的一則或多則訊息列表

聊天訊息

頻道中的訊息、一對一聊天或群組聊天

名稱	路徑	類型	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	可用於推播通知和摘要檢視或後援檢視的訊息摘要文字

聊天訊息列表

團隊中特定對話的一則或多則訊息列表

名稱	路徑	類型	Description
Message		ChatMessage	頻道中的訊息、一對一聊天或群組聊天

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 租戶的 ID

GetChannel回應

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

名稱	路徑	類型	Description
頻道 ID	id	string	通道的唯一識別碼
顯示名稱	displayName	string	頻道的名稱
頻道說明	description	string	通道的說明，選用
頻道的電子郵件地址	email	string	用於將訊息傳送至頻道的電子郵件地址
小組租用戶識別碼	tenantId	string	Microsoft Entra 租戶的 ID。
Microsoft Teams 中該頻道的超連結	webUrl	string	Microsoft Teams 中該頻道的超連結
頻道的 SharePoint 資料夾網址	filesFolderWebUrl	string	頻道的 SharePoint 資料夾網址
頻道建立時間	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 開啟活動的網址。
線上會議網址	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 用戶端的搜尋和建議來顯示

物件無類型

GetOnlineMeeting_Response

名稱	路徑	類型	Description
會議編號	id	string	線上會議的唯一識別碼
主旨	subject	string	線上會議主題
開始時間	startDateTime	date-time	會議開始時間（UTC）
結束時間	endDateTime	date-time	會議結束時間（UTC）
建立時間	creationDateTime	date-time	會議創建時間（UTC）
加入網頁網址	joinWebUrl	string	線上會議加入的網址
加入會議識別碼	joinMeetingIdSettings.joinMeetingId	string	加入會議時使用的數字編號
是否需要密碼	joinMeetingIdSettings.isPasscodeRequired	boolean	指示是否需要密碼才能參加會議
密碼	joinMeetingIdSettings.passcode	string	加入會議的密碼
UPN	participants.organizer.upn	string	組織者的使用者主名稱
ID	participants.organizer.identity.user.id	string	組織者的唯一識別碼
顯示名稱	participants.organizer.identity.user.displayName	string	主辦單位的顯示名稱
會議 ID	audioConferencing.conferenceId	string	會議的會議編號
收費號碼	audioConferencing.tollNumber	string	撥號電話
免付費電話	audioConferencing.tollFreeNumber	string	免費撥號電話
撥入網址	audioConferencing.dialinUrl	string	帶有撥號資訊的網頁網址
進出公告	isEntryExitAnnounced	boolean	是否開啟了來電者加入或離開會議的通知
允許主持人	allowedPresenters	string	規定誰可以擔任會議的發表者
Scope	lobbyBypassSettings.scope	string	指定自動被允許進入會議的參與者類型
撥號繞過	lobbyBypassSettings.isDialInBypassEnabled	boolean	規定撥入來電者是否繞過大廳
自動錄製	recordAutomatically	boolean	指示是否自動錄製會議
允許會議聊天	allowMeetingChat	string	規定會議聊天模式
會議選項網頁網址	meetingOptionsWebUrl	string	一個讓主辦人更改會議設定的網址

通話錄音回應

通話錄音

名稱	路徑	類型	Description
錄音識別碼	id	string	錄音識別碼
建立日期時間	createdDateTime	date-time	錄音製作的日期與時間
錄音內容網址	recordingContentUrl	string	存取錄音內容的網址
會議編號	meetingId	string	會議 ID
會議組織者識別碼	meetingOrganizerId	string	會議主辦人的使用者識別碼
通話識別碼	callId	string	呼號

通話錄音收集回應

名稱	路徑	類型	Description
記錄	value	array of CallRecordingResponse	錄音列表

來電逐字稿回應

通話記錄

名稱	路徑	類型	Description
成績單 ID	id	string	逐字稿識別碼
建立日期時間	createdDateTime	date-time	逐字稿製作的日期和時間
逐字稿內容網址	transcriptContentUrl	string	存取逐字稿內容的網址
會議編號	meetingId	string	會議 ID
會議組織者識別碼	meetingOrganizerId	string	會議主辦人的使用者識別碼
通話識別碼	callId	string	呼號

通話逐字稿收集回應

名稱	路徑	類型	Description
Transcripts	value	array of CallTranscriptResponse	逐字稿列表

區段回應

團隊合作部門

名稱	路徑	類型	Description
Etag	@odata.etag	string	關於該章節收藏的ETag。在建立、更新和刪除時，請 If-Match 通過。
區段 ID	id	string	分區識別碼
顯示名稱	displayName	string	該區段的顯示名稱
圖示類型	displayIcon.iconType	string	圖示類型。支援的數值：表情符號 Unicode 字元或自訂圖示的「自訂」。
圖示顯示名稱	displayIcon.displayName	string	圖示的顯示名稱
膚色	displayIcon.skinTone	string	支援膚色修飾器的表情符號圖示的膚色
是擴展的	isExpanded	boolean	該區是否被擴展
排序類型	sortType	string	該區段的排序類型
路段類型	sectionType	string	剖面類型
建立日期時間	createdDateTime	date-time	該部門成立的日期與時間
上次修改日期時間	lastModifiedDateTime	date-time	該段最後修改的日期與時間

清單區段回應

名稱	路徑	類型	Description
章節版本	@microsoft.graph.sectionsVersion	string	章節階層的版本識別碼。在建立、更新、刪除、新增項目、移除項目和移動項目操作時，請以 If-Match 方式傳遞。
Sections	value	array of SectionResponse	區段列表

SectionItemResponse（項目回應）

團隊合作區塊中的一個項目（聊天室、頻道、會議或社群）

名稱	路徑	類型	Description
Etag	@odata.etag	string	ETag 用於區域物品收集。在新增、移除和移動時，假裝成 If-Match。
項目 ID	id	string	物品的唯一識別碼。對應底層聊天室、頻道、會議或社群的對話 ID。
項目類型	itemType	string	物品類型
建立日期時間	createdDateTime	date-time	項目加入該區塊的日期與時間
上次修改日期時間	lastModifiedDateTime	date-time	商品最後修改的日期和時間

清單、區段、項目、回應

名稱	路徑	類型	Description
章節項目	value	array of SectionItemResponse	章節項目列表

AiInsightResponse

為線上會議提供 AI 生成的洞察

名稱	路徑	類型	Description
AI 洞察識別碼	id	string	AI 洞察識別碼
通話識別碼	callId	string	呼號
內容相關識別碼	contentCorrelationId	string	內容相關ID
建立日期時間	createdDateTime	date-time	AI 洞察被創建的日期和時間
結束日期時間	endDateTime	date-time	AI 洞察結束的日期和時間

AiInsightCollectionResponse

名稱	路徑	類型	Description
AI 見解	value	array of AiInsightResponse	人工智慧洞察列表

檔案

這是基本資料類型「檔案」。

字串

這是基本資料類型「string」。