共用方式為

Office 365 群組郵件

Office 365 群組郵件連接器可讓使用者使用位於 Office 365 群組信箱中的資料。 此連接器中的功能獨立於單一使用者的個人信箱運作，並允許使用者使用他們可以在其組織內存取的任何群組。 連接器可使用 Microsoft Graph API，並使用 Graph API 內 Office 365 群組檔中指定的術語。 如需詳細資訊，請參閱連接器檔。

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

服務 Class Regions
副駕駛工作室 標準 所有 Power Automate 區域
邏輯應用程式 標準 所有 Logic Apps 區域
Power Apps 標準 所有 Power Apps 區域
Power Automate（自動化服務） 標準 所有 Power Automate 區域
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft
網站 https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
類別 生產力

先決條件

若要使用此連接器，您需要一個可以存取組織內 Office 365 群組的使用者帳戶。

我們也建議您檢閱適用於 Microsoft 365 群組的 Microsoft 圖形 API 檔 ，以瞭解 API 內資料的結構化方式。 使用此連接器之前，應該先檢閱一些關鍵術語，例如「交談」、「線程」和「張貼」。

已知問題和限制

若要疑難排解「在存放區中找不到指定的物件」錯誤，您可以執行下列動作：

  • 驗證帳戶的許可。
  • 嘗試刪除目前的 Office 365 群組郵件連線，然後建立新的連線。

無需成員資格即可存取「公共」群組

經過驗證的使用者能夠從他們所屬的群組及其組織內的任何「公用」群組存取群組資料。 在連接器體驗中，選取群組時，連接器會提供動態的群組下拉式清單供您選取。 為了獲得更乾淨的體驗，此下拉式清單只會自動填入經過驗證的使用者所屬的群組。

若要存取組織內未填入下拉式清單中的「公用」群組，您必須捲動至最底部，然後選取 [ 輸入自訂值]，在連接器下拉式清單中提供群組識別碼。

若要在組織內尋找群組 ID，請遵循下列步驟：

  1. 流覽至 Microsoft Graph 總管 ，並在左上方向您的使用者進行驗證。

  2. 在 [範例查詢] 區段中，選取 [群組]，然後選取 [取得組織中的所有群組]。

  3. 在 [回應預覽] 中，尋找您要搜尋的組織內的群組。 提供屬性中的 id 值作為連接器下拉式清單體驗中的自訂值。

  4. 請確定群組可見度設定為 公用，否則使用者將無法存取群組內的資料。

  5. 如果您找不到群組，您可能需要查看結果的下一頁，您可以透過複製連結 @odata.nextLink 並在頁面頂端將其作為查詢執行來存取。

郵件觸發程序

如果同時發送大量電子郵件，觸發器可能會錯過某些電子郵件。 這是因為電子郵件處理延遲的基礎系統限制，導致電子郵件延遲變得「可見」（在聯結器處理包含延遲電子郵件的批次之後）。

淘汰資訊

「轉寄貼文」作業已暫時取代，因為此連接器缺乏 電子郵件外洩控制 支援。 我們正在努力提供支持，並將在完成後更新操作。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒
觸發輪詢的頻率 1 60 秒

動作

傳送 HTTP 要求

建構要叫用的 Microsoft Graph REST API 要求。 深入了解：https://docs.microsoft.com/en-us/graph/use-the-api
列出交談的交談討論串

取得群組交談中的所有討論串。
列出對話串的貼文

獲取指定對話線程的所有帖子。
列出群組的執行緒

取得群組的所有執行緒。
列出群組的對話

取得此群組中的所有對話。
列出貼文的附件

擷取屬於貼文的附件清單。
刪除對話串

刪除指定的交談執行緒。
取得對話串

取得屬於群組的特定討論串。
取得群組對話

擷取特定交談的屬性。
取得討論串貼文

擷取指定執行緒中的貼文。
回覆交談討論串

回覆群組對話中的討論串，並在其中新增貼文。
回覆貼文

回覆貼文，並將新貼文新增至群組對話中的指定討論串。
在群組中建立新對話

在此群組中建立新對話。
建立對話串

在指定的交談中建立新執行緒。
建立討論串來開始新的群組交談

首先建立討論串來開始新的群組對話。
轉寄貼文 [已棄用]

此動作已被取代。 請改用 轉發帖子 。

將貼文轉寄給收件者。
轉寄貼文 （預覽版）

將貼文轉寄給收件者。

傳送 HTTP 要求

作業識別碼：
HttpRequest

建構要叫用的 Microsoft Graph REST API 要求。 深入了解：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

列出交談的交談討論串

作業識別碼：
ListConversationThreads

取得群組交談中的所有討論串。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
交談識別碼
 conversationId True string

輸入交談 ID。

傳回

名稱 路徑 類型 Description
value
 value array of ConversationThread

列出對話串的貼文

作業識別碼：
ListThreadPosts

獲取指定對話線程的所有帖子。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。

傳回

名稱 路徑 類型 Description
value
 value array of Post

包含指定執行緒中貼文的陣列。

列出群組的執行緒

作業識別碼：
ListGroupThreads

取得群組的所有執行緒。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。

傳回

名稱 路徑 類型 Description
value
 value array of ConversationThread

列出群組的對話

作業識別碼：
ListConversations

取得此群組中的所有對話。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。

傳回

名稱 路徑 類型 Description
value
 value array of Conversation

列出貼文的附件

作業識別碼：
GetAttachments

擷取屬於貼文的附件清單。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。
貼文編號
 postId True string

輸入貼文 ID。

傳回

名稱 路徑 類型 Description
value
 value array of Attachment

包含貼文附件的陣列。

刪除對話串

作業識別碼：
DeleteConversationThread

刪除指定的交談執行緒。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。

取得對話串

作業識別碼：
GetConversationThread

取得屬於群組的特定討論串。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。

傳回

交談執行緒物件。

身體
ConversationThread

取得群組對話

作業識別碼：
GetGroupConversation

擷取特定交談的屬性。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
交談識別碼
 conversationId True string

輸入交談 ID。

傳回

交談物件。

身體
Conversation

取得討論串貼文

作業識別碼：
GetThreadPost

擷取指定執行緒中的貼文。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。
貼文編號
 postId True string

輸入貼文 ID。

傳回

代表 conversationThread 實體內的個別 Post 專案。

身體
Post

回覆交談討論串

作業識別碼：
ReplyToAThread

回覆群組對話中的討論串，並在其中新增貼文。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。
Content
 content True html

新對話的內容。
類別
 categories array of string

與貼文相關聯的類別。
Address
 Address email

電子郵件地址。
附件名稱
 Name True string

附件的名稱。
附件內容
 ContentBytes True byte

附件的內容。

回覆貼文

作業識別碼：
ReplyPost

回覆貼文，並將新貼文新增至群組對話中的指定討論串。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。
貼文編號
 postId True string

輸入貼文 ID。
Content
 content True html

新對話的內容。
類別
 categories array of string

與貼文相關聯的類別。
Address
 Address email

電子郵件地址。
附件名稱
 Name True string

附件的名稱。
附件內容
 ContentBytes True byte

附件的內容。

在群組中建立新對話

作業識別碼：
CreateConversation

在此群組中建立新對話。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
新主題
 topic True string

新對話的主題。
Content
 content True html

新對話的內容。
類別
 categories array of string

與貼文相關聯的類別。
Address
 Address email

電子郵件地址。
附件名稱
 Name True string

附件的名稱。
附件內容
 ContentBytes True byte

附件的內容。

傳回

的回應與已建立的交談詳細資料。

已建立的交談物件
CreateConversationResponse

建立對話串

作業識別碼：
CreateConversationThread

在指定的交談中建立新執行緒。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
交談識別碼
 conversationId True string

輸入交談 ID。
新主題
 topic True string

新對話的主題。
Content
 content True html

新對話的內容。
類別
 categories array of string

與貼文相關聯的類別。
Address
 Address email

電子郵件地址。
附件名稱
 Name True string

附件的名稱。
附件內容
 ContentBytes True byte

附件的內容。

傳回

身體
NewConversationThreadResponse

建立討論串來開始新的群組交談

作業識別碼：
CreateGroupThread

首先建立討論串來開始新的群組對話。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
新主題
 topic True string

新對話的主題。
Content
 content True html

新對話的內容。
類別
 categories array of string

與貼文相關聯的類別。
Address
 Address email

電子郵件地址。
附件名稱
 Name True string

附件的名稱。
附件內容
 ContentBytes True byte

附件的內容。

傳回

身體
NewConversationThreadResponse

轉寄貼文 [已棄用]

作業識別碼：
ForwardPost

此動作已被取代。 請改用 轉發帖子 。

將貼文轉寄給收件者。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。
貼文編號
 postId True string

輸入貼文 ID。
評論
 comment string

評論以轉發帖子。
Address
 Address email

電子郵件地址。

轉寄貼文 （預覽版）

作業識別碼：
ForwardPost_V2

將貼文轉寄給收件者。

參數

名稱 機碼 必要 類型 Description
群組郵件
 groupMail True string

從下拉式選單中選擇一個群組或輸入群組郵件地址。
交談識別碼
 conversationId True string

輸入交談 ID。
執行緒識別碼
 threadId True string

輸入交談線程識別碼。
貼文編號
 postId True string

輸入貼文 ID。
評論
 Comment html

評論以轉發帖子。
Address
 Address email

電子郵件地址。

觸發程序

當新電子郵件送達群組時

當新電子郵件到達群組時。

當新電子郵件送達群組時

作業識別碼：
OnNewEmailInGroup

當新電子郵件到達群組時。

參數

名稱 機碼 必要 類型 Description
群組識別碼
 groupId True string

從下拉式清單中挑選群組或輸入群組 ID。

傳回

名稱 路徑 類型 Description
value
 value array of ConversationTriggerResponse

觸發器的回應。

定義

交談

交談物件。

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

交談的唯一識別碼。
對話主題
 topic string

對話的主題。
有附件嗎？
 hasAttachments boolean

指出此對話中的任何貼文是否至少有一個附件。
上次傳送的時間戳記
 lastDeliveredDateTime date-time

時間戳記類型使用 ISO 8601 格式代表日期和時間資訊，且一律採用 UTC 時間。
唯一寄件者陣列
 uniqueSenders array of string

傳送訊息至此交談的所有使用者。
Preview
 preview string

本次對話中最新帖子正文的簡短摘要。

對話線程

交談執行緒物件。

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

交談執行緒的唯一識別碼。
對話主題
 topic string

對話的主題。
有附件嗎？
 hasAttachments boolean

指出此對話中的任何貼文是否至少有一個附件。
上次傳送的時間戳記
 lastDeliveredDateTime date-time

時間戳記類型使用 ISO 8601 格式代表日期和時間資訊，且一律採用 UTC 時間。
唯一寄件者陣列
 uniqueSenders array of string

傳送訊息至此交談的所有使用者。
Preview
 preview string

本次對話中最新帖子正文的簡短摘要。
被鎖定了嗎？
 isLocked boolean

指出執行緒是否已鎖定。
收件人
 toRecipients array of EmailAddress

收件者：執行緒的收件者。
cc收件者
 ccRecipients array of EmailAddress

Cc：線程的收件者。

貼文

代表 conversationThread 實體內的個別 Post 專案。

名稱 路徑 類型 Description
貼文編號
 id string

貼文的唯一識別碼。
創建帖子的時間戳
 createdDateTime date-time
貼文的上次修改時間戳記
 lastModifiedDateTime date-time
變更金鑰
 changeKey string

識別貼文的版本。
交談識別碼
 conversationId string

貼文所屬交談的唯一識別碼。
交談執行緒識別碼
 conversationThreadId string

貼文所屬交談討論串的唯一識別碼。
類別
 categories array of string

與貼文相關聯的類別。
已接收時間戳記
 receivedDateTime date-time

收到時間戳記的貼文。
有附件嗎？
 hasAttachments boolean

指出貼文是否至少有一個附件。
新參與者
 newParticipants array of EmailAddress

作為本文的一部分添加到線程中的對話參與者。
body
 body ItemBody

代表項目內文的屬性，例如訊息、事件或群組貼文。
從
 from EmailAddress
傳送者
 sender EmailAddress
attachments
 attachments array of Attachment

附件

名稱 路徑 類型 Description
附件 ID
 id string

附件的 ID。
附件名稱
 name string

附件名稱。
附件內容類型
 contentType string

附件的內容類型。
附件大小
 size integer

附件的大小。
附件內容位元組
 contentBytes byte

附件內容。

電子郵件地址

名稱 路徑 類型 Description
用戶的名稱
 emailAddress.name string
使用者的電子郵件地址
 emailAddress.address email

項目內體

代表項目內文的屬性，例如訊息、事件或群組貼文。

名稱 路徑 類型 Description
正文內容類型
 contentType string

正文的內容類型。
正文內容
 content string

身體的內容。

CreateConversation回應

的回應與已建立的交談詳細資料。

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

新的交談 ID。
交談執行緒
 threads array of object

已建立對話線程。
執行緒識別碼
 threads.id string

新的執行程識別碼。

NewConversationThread回應

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

新的交談線程識別碼。

對話觸發回應

當新電子郵件到達時，觸發回應。

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

交談唯一識別碼。
上次傳送的時間戳記
 lastDeliveredDateTime date-time

時間戳記類型使用 ISO 8601 格式代表日期和時間資訊，且一律採用 UTC 時間。
threads
 threads array of ConversationThreadTriggerResponse

ConversationThreadTrigger回應

交談執行緒物件。

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

交談執行緒的唯一識別碼。
帖子
 posts array of PostTriggerResponse

PostTrigger回應

代表 conversationThread 實體內的個別 Post 專案。

名稱 路徑 類型 Description
貼文編號
 id string

貼文的唯一識別碼。
貼文的上次修改時間戳記
 lastModifiedDateTime date-time
變更金鑰
 changeKey string

識別貼文的版本。

物件無類型