Viva Engage
Viva Engage 是領先的社交網絡，可讓企業更智能、更快地完成工作。 連線到 Viva Engage 以存取企業網路中的交談。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL | https://microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://products.office.com/yammer/yammer-overview |
| 隱私策略 | https://privacy.microsoft.com |
| 類別 | Communication |
這很重要
Yammer （Viva Engage） 的 OAuth2 驗證即將被取代。
- 從 9 月 1 日開始，新連線必須使用 Entra ID 驗證。
- 現有的 OAuth2 連線將繼續運作至 2025 年 11 月 15 日。
請在 2025 年 11 月 15 日之前將您的連線切換到 Entra ID 身份驗證，以避免中斷。
已知問題與限制
下列動作和觸發程式不保證傳回所有訊息，因為 Viva Engage REST API 限制：
- 取得所有訊息
- 在群組中取得訊息
- 在討論串中取得訊息
- 從我的關注提要中獲取消息
- 群組中有新訊息時
- 當我追蹤的動態消息中有新訊息時
由於Viva Engage REST API 限制，下列動作可能會傳回最多 100 個群組：
- 取得群組
備註
Viva Engage API 可能會限制傳回的訊息數目。 如果發生這種情況，若要解決此限制，請參閱如何使用 Microsoft Flow 取得 Yammer 群組中的所有訊息。 如需 Viva Engage API 限制的詳細資訊，請流覽 Yammer API 速率限制。
此外，由於Viva Engage REST API 限制，下列動作和觸發程式可能不適用於 所有公司 群組：
- 在群組中取得訊息
- 在群組中取得訊息 （V2）
- 群組中有新訊息時
必須在 Yammer 設定中啟用第三方應用程式功能。 動作回應 （例如「回應不是 JSON 格式」） 通常表示該功能已停用。
下列動作可讓您在設定對應的進階參數之後，建立具有「標題」的「公告」文章，不過，此文章將無法在Viva Engage UI中編輯。 Viva Engage 已知此問題，並將在未來的更新中解決此問題。
- 貼文
- 貼文V2
正在建立連線
連接器支援下列驗證類型：
| 使用 Microsoft Entra ID 登入 | 使用 Microsoft Entra ID 登入 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
使用 Microsoft Entra ID 登入
驗證識別碼：entraIDUserLogin
適用：所有地區
使用 Microsoft Entra ID 登入
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
預設值 [已棄用]
適用：所有地區
此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 15 秒 |
動作
| 取得使用者詳細資料 |
此作業會傳回使用者設定檔詳細資料。 |
| 取得執行緒中的訊息 （V2） [已淘汰] |
此動作已被取代。 請改用 [取得執行緒中的訊息 （V3） ]。
|
| 取得我的網路 |
取得使用者所屬的所有網路。 |
| 取得所有訊息 [已棄用] |
此動作已被取代。 請改用 [取得所有訊息 （V3）]。
|
| 取得所有訊息 （V2） [已淘汰] |
此動作已被取代。 請改用 [取得所有訊息 （V3）]。
|
| 取得所有訊息 （V3） |
此作業會傳回登入使用者 Viva Engage 網路中的所有公用訊息。 對應至 Viva Engage Web 介面中的「所有」交談。 |
| 取得群組 |
取得所有群組。 如果我的 = 1，則僅獲取用戶所屬的組 |
| 取得群組中的訊息 （V2） [已淘汰] |
此動作已被取代。 請改用 [取得群組中的訊息 （V3） ]。
|
| 在執行串中取得訊息 [已淘汰] |
此動作已被取代。 請改用 [取得執行緒中的訊息 （V3） ]。
|
| 在執行緒中取得訊息 （V3） |
此作業會傳回張貼在執行緒中的訊息。 |
| 在群組中取得訊息 [已淘汰] |
此動作已被取代。 請改用 [取得群組中的訊息 （V3） ]。
|
| 在群組中取得訊息 （V3） |
此作業會傳回群組中張貼的訊息。 |
| 張貼訊息 [已棄用] |
此作業可用來將訊息張貼至群組或所有公司摘要。 如果提供群組 ID，訊息將張貼至指定的群組，否則將張貼在「所有公司摘要」中。 |
| 從我的 [已棄用] |
此動作已被取代。 請改用從 我的關注提要 （V3） 獲取消息 。
|
| 從我的 [追蹤] 摘要 （V2） 取得訊息 [已棄用] |
此動作已被取代。 請改用從 我的關注提要 （V3） 獲取消息 。
|
| 從我的關注提要中獲取消息 （V3） |
此作業會從 [追蹤] 摘要傳回訊息，這是涉及使用者所追蹤的人員、群組和主題的交談。 |
| 讚好留言 |
此作業用於按讚指定的訊息。 |
| 貼文訊息 （V2） |
此作業可用來將訊息張貼至群組或所有公司摘要。 如果提供群組 ID，訊息將張貼至指定的群組，否則將張貼在「所有公司摘要」中。 |
取得使用者詳細資料
此作業會傳回使用者設定檔詳細資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
user_id | True | integer |
使用者的唯一識別碼。 |
傳回
Viva Engage 使用者的屬性。
- User
- User
取得執行緒中的訊息 （V2） [已淘汰]
此動作已被取代。 請改用 [取得執行緒中的訊息 （V3） ]。
此作業會傳回張貼在執行緒中的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
執行緒識別碼
|
thread_id | True | integer |
執行緒的唯一識別碼。 |
傳回
一或多則訊息的清單。
- 訊息清單
- PageableMessageList
取得我的網路
取得所有訊息 [已棄用]
此動作已被取代。 請改用 [取得所有訊息 （V3）]。
此作業會傳回登入使用者 Viva Engage 網路中的所有公用訊息。 對應至 Yammer Web 介面中的「所有」交談。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路的唯一識別碼
|
network_id | string |
網路ID |
|
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
|
|
頁面
|
page | integer |
取得指定的頁面。 如果傳回的資料大於限制，您可以使用此欄位存取後續頁面 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
取得所有訊息 （V2） [已淘汰]
此動作已被取代。 請改用 [取得所有訊息 （V3）]。
此作業會傳回登入使用者 Viva Engage 網路中的所有公用訊息。 對應至 Viva Engage Web 介面中的「所有」交談。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路的唯一識別碼
|
network_id | string |
網路ID |
|
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
訊息的執行緒類型
|
threaded | string |
Threaded=true 只會傳回每個執行緒的執行緒啟動器 （第一則訊息）。 此參數適用於需要顯示收合的訊息執行緒的應用程式。 threaded=extended 會傳回線程啟動器訊息，以及依活動排序的兩個最新訊息，因為它們會在 Viva Engage Web 介面的預設檢視中檢視。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
傳回
一或多則訊息的清單。
- 訊息清單
- PageableMessageList
取得所有訊息 （V3）
此作業會傳回登入使用者 Viva Engage 網路中的所有公用訊息。 對應至 Viva Engage Web 介面中的「所有」交談。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路的唯一識別碼
|
network_id | string |
網路ID |
|
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
訊息的執行緒類型
|
threaded | string |
Threaded=true 只會傳回每個執行緒的執行緒啟動器 （第一則訊息）。 此參數適用於需要顯示收合的訊息執行緒的應用程式。 threaded=extended 會傳回線程啟動器訊息，以及依活動排序的兩個最新訊息，因為它們會在 Viva Engage Web 介面的預設檢視中檢視。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
傳回
一或多則訊息的清單。
取得群組
取得所有群組。 如果我的 = 1，則僅獲取用戶所屬的組
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路ID |
|
|
礦
|
mine | integer |
用於取得使用者所屬的群組 |
|
|
顯示所有公司組
|
showAllCompanyGroup | integer |
用於顯示所有公司群組 |
傳回
- response
- array of YammmerEntity
取得群組中的訊息 （V2） [已淘汰]
此動作已被取代。 請改用 [取得群組中的訊息 （V3） ]。
此作業會傳回群組中張貼的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一識別碼。 |
|
|
群組識別碼
|
group_id | True | integer |
群組的唯一識別碼。 |
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
訊息的執行緒類型
|
threaded | string |
Threaded=true 只會傳回每個執行緒的執行緒啟動器 （第一則訊息）。 此參數適用於需要顯示收合的訊息執行緒的應用程式。 threaded=extended 會傳回線程啟動器訊息，以及依活動排序的兩個最新訊息，因為它們會在 Viva Engage Web 介面的預設檢視中檢視。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
傳回
一或多則訊息的清單。
- 訊息清單
- PageableMessageList
在執行串中取得訊息 [已淘汰]
此動作已被取代。 請改用 [取得執行緒中的訊息 （V3） ]。
此作業會傳回張貼在執行緒中的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
執行緒識別碼
|
thread_id | True | integer |
執行緒的唯一識別碼。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
在執行緒中取得訊息 （V3）
此作業會傳回張貼在執行緒中的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
執行緒識別碼
|
thread_id | True | integer |
執行緒的唯一識別碼。 |
傳回
一或多則訊息的清單。
在群組中取得訊息 [已淘汰]
此動作已被取代。 請改用 [取得群組中的訊息 （V3） ]。
此作業會傳回群組中張貼的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一識別碼。 |
|
|
群組識別碼
|
group_id | True | integer |
群組的唯一識別碼。 |
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
|
|
頁面
|
page | integer |
取得指定的頁面。 如果傳回的資料大於限制，您可以使用此欄位存取後續頁面 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
在群組中取得訊息 （V3）
此作業會傳回群組中張貼的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一識別碼。 |
|
|
群組識別碼
|
group_id | True | integer |
群組的唯一識別碼。 |
|
早於
|
older_than | integer |
在執行緒的最新訊息早於指定訊息識別碼的執行緒中傳回訊息。 任何具有最新訊息識別碼的執行緒，其最新訊息識別碼更新或等於指定的識別碼，此查詢將不會傳回任何訊息。 |
|
|
更新於
|
newer_than | integer |
在執行緒的最新訊息比指定訊息識別碼更新的執行緒中傳回訊息。 任何最新訊息識別碼早於或等於指定識別碼的執行緒，此查詢將不會傳回任何訊息。 |
|
|
訊息的執行緒類型
|
threaded | string |
Threaded=true 只會傳回每個執行緒的執行緒啟動器 （第一則訊息）。 此參數適用於需要顯示收合的訊息執行緒的應用程式。 threaded=extended 會傳回線程啟動器訊息，以及依活動排序的兩個最新訊息，因為它們會在 Viva Engage Web 介面的預設檢視中檢視。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
傳回
一或多則訊息的清單。
張貼訊息 [已棄用]
此作業可用來將訊息張貼至群組或所有公司摘要。 如果提供群組 ID，訊息將張貼至指定的群組，否則將張貼在「所有公司摘要」中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一 ID。 |
|
|
群組識別碼
|
group_id | True | integer |
要張貼訊息的群組 （0 = 所有公司/網路）。 |
|
訊息文字
|
body | True | string |
您的訊息將發佈到您的網路中。 |
|
回覆 Id
|
replied_to_id | integer |
此訊息要回覆的訊息 ID。 |
|
|
直接到 ID
|
direct_to_id | integer |
如果設定，私人訊息將直接傳送給具有指定 ID 的使用者。 |
|
|
廣播
|
broadcast | boolean |
將訊息作為公告發佈給群組中的所有使用者。 |
|
|
Title
|
title | string |
要張貼的訊息標題。 |
|
|
主題 1
|
topic1 | string |
要套用至訊息的主題。 |
|
|
主題 2
|
topic2 | string |
要套用至訊息的主題 |
|
|
主題 3
|
topic3 | string |
要套用至訊息的主題。 |
|
|
主題 4
|
topic4 | string |
要套用至訊息的主題 |
|
|
主題 5
|
topic5 | string |
要套用至訊息的主題。 |
|
|
主題 6
|
topic6 | string |
要套用至訊息的主題。 |
|
|
主題 7
|
topic7 | string |
要套用至訊息的主題 |
|
|
主題 8
|
topic8 | string |
要套用至訊息的主題。 |
|
|
主題 9
|
topic9 | string |
要套用至訊息的主題。 |
|
|
主題 10
|
topic10 | string |
要套用至訊息的主題。 |
|
|
主題 11
|
topic11 | string |
要套用至訊息的主題。 |
|
|
主題 12
|
topic12 | string |
要套用至訊息的主題。 |
|
|
主題 13
|
topic13 | string |
要套用至訊息的主題。 |
|
|
主題 14
|
topic14 | string |
要套用至訊息的主題。 |
|
|
主題 15
|
topic15 | string |
要套用至訊息的主題。 |
|
|
主題 16
|
topic16 | string |
要套用至訊息的主題。 |
|
|
主題 17
|
topic17 | string |
要套用至訊息的主題。 |
|
|
主題 18
|
topic18 | string |
要套用至訊息的主題。 |
|
|
主題 19
|
topic19 | string |
要套用至訊息的主題。 |
|
|
主題 20
|
topic20 | string |
要套用至訊息的主題。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
從我的 [已棄用]
此動作已被取代。 請改用從 我的關注提要 （V3） 獲取消息 。
此作業會從 [追蹤] 摘要傳回訊息，這是涉及使用者所追蹤的人員、群組和主題的交談。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一識別碼。 |
|
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
|
|
頁面
|
page | integer |
取得指定的頁面。 如果傳回的資料大於限制，您可以使用此欄位存取後續頁面 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
從我的 [追蹤] 摘要 （V2） 取得訊息 [已棄用]
此動作已被取代。 請改用從 我的關注提要 （V3） 獲取消息 。
此作業會從 [追蹤] 摘要傳回訊息，這是涉及使用者所追蹤的人員、群組和主題的交談。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一識別碼。 |
|
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
訊息的執行緒類型
|
threaded | string |
Threaded=true 只會傳回每個執行緒的執行緒啟動器 （第一則訊息）。 此參數適用於需要顯示收合的訊息執行緒的應用程式。 threaded=extended 會傳回線程啟動器訊息，以及依活動排序的兩個最新訊息，因為它們會在 Viva Engage Web 介面的預設檢視中檢視。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
傳回
一或多則訊息的清單。
- 訊息清單
- PageableMessageList
從我的關注提要中獲取消息 （V3）
此作業會從 [追蹤] 摘要傳回訊息，這是涉及使用者所追蹤的人員、群組和主題的交談。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一識別碼。 |
|
|
早於
|
older_than | integer |
傳回早於指定為數值字串的訊息 ID 的訊息。 這對於分頁訊息很有用。 例如，如果您目前正在檢視 20 則訊息，而最舊的訊息是編號 2912，您可以在請求中附加「？older_than=2912」，以便在您看到的訊息之前取得 20 則訊息。 |
|
|
更新於
|
newer_than | integer |
傳回比指定為數值字串的訊息 ID 更新的訊息。 輪詢新訊息時應該使用這。 如果您正在查看訊息，且傳回的最新訊息是 3516，您可以使用參數 “？newer_than=3516” 提出要求，以確保您不會取得頁面上已有訊息的重複副本。 |
|
|
訊息的執行緒類型
|
threaded | string |
Threaded=true 只會傳回每個執行緒的執行緒啟動器 （第一則訊息）。 此參數適用於需要顯示收合的訊息執行緒的應用程式。 threaded=extended 會傳回線程啟動器訊息，以及依活動排序的兩個最新訊息，因為它們會在 Viva Engage Web 介面的預設檢視中檢視。 |
|
|
限制
|
limit | integer |
只傳回指定數目的訊息。 |
傳回
一或多則訊息的清單。
讚好留言
此作業用於按讚指定的訊息。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訊息 ID
|
message_id | True | string |
訊息的唯一識別碼。 |
貼文訊息 （V2）
此作業可用來將訊息張貼至群組或所有公司摘要。 如果提供群組 ID，訊息將張貼至指定的群組，否則將張貼在「所有公司摘要」中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
網路的唯一 ID。 |
|
|
群組識別碼
|
group_id | True | integer |
要張貼訊息的群組 （0 = 所有公司/網路）。 |
|
訊息文字
|
body | True | string |
您的訊息將發佈到您的網路中。 |
|
回覆 Id
|
replied_to_id | integer |
此訊息要回覆的訊息 ID。 |
|
|
直接到 ID
|
direct_to_id | integer |
如果設定，私人訊息將直接傳送給具有指定 ID 的使用者。 |
|
|
廣播
|
broadcast | boolean |
將訊息作為公告發佈給群組中的所有使用者。 |
|
|
Title
|
title | string |
要張貼的訊息標題。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageListV2
觸發程序
| 當我關注的提要中有新消息時 [已棄用] |
此動作已被取代。 請改用 當我關注的提要 （V2） 中有新消息時 。
|
| 當我關注的提要中有新消息時 （V2） |
當您後續的網路中有新訊息時，會觸發此作業。 |
| 群組中有新訊息時 [已棄用] |
此動作已被取代。 請改用群組中有新訊息時 （V2）。
|
| 群組中有新訊息時 （V2） |
當在群組中張貼新訊息時，會觸發此作業。 |
當我關注的提要中有新消息時 [已棄用]
此動作已被取代。 請改用 當我關注的提要 （V2） 中有新消息時 。
當您後續的網路中有新訊息時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
選擇一個網絡。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
當我關注的提要中有新消息時 （V2）
當您後續的網路中有新訊息時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路ID
|
network_id | string |
選擇一個網絡。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageListV2
群組中有新訊息時 [已棄用]
此動作已被取代。 請改用群組中有新訊息時 （V2）。
當在群組中張貼新訊息時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路識別碼
|
network_id | string |
網路的唯一識別碼。 |
|
|
群組識別碼
|
group_id | True | integer |
群組的唯一識別碼。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageList
群組中有新訊息時 （V2）
當在群組中張貼新訊息時，會觸發此作業。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
網路識別碼
|
network_id | string |
網路的唯一識別碼。 |
|
|
群組識別碼
|
group_id | True | integer |
群組的唯一識別碼。 |
傳回
一或多則訊息的清單。
- 訊息清單
- MessageListV2
定義
User
Viva Engage 使用者的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
用戶名稱
|
name | string |
使用者名稱。 |
|
職稱
|
job_title | string |
使用者職稱。 |
|
地點
|
location | string |
使用者位置。 |
|
完整名稱
|
full_name | string |
使用者全名。 |
|
名字
|
first_name | string |
使用者名字。 |
|
姓氏
|
last_name | string |
使用者姓氏。 |
|
設定檔網址
|
web_url | string |
使用者設定檔 URL。 |
|
Email
|
string |
使用者電子郵件。 |
|
|
出生日期
|
birth_date | string |
使用者出生日期。 |
|
照片網址
|
mugshot_url | string |
使用者相片網址。 |
Message
單一Viva Engage訊息的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | integer |
與貼文相關聯的 ID。 |
|
文字
|
content_excerpt | string |
帖子的文字內容。 |
|
寄件者
|
sender_id | integer |
張貼訊息的使用者的唯一 ID。 |
|
回覆
|
replied_to_id | integer |
此訊息作為回覆的訊息 ID。 |
|
創建於
|
created_at | string |
建立訊息的時間。 |
|
網路
|
network_id | integer |
與網路訊息相關聯的 ID。 |
|
類型
|
message_type | string |
訊息類型的描述。 |
|
寄件者類型
|
sender_type | string |
寄件者類型的描述。 |
|
網址
|
url | uri |
貼文的 API 網址。 |
|
網址
|
web_url | uri |
貼文的網頁網址。 |
|
群組識別碼
|
group_id | integer |
張貼訊息之群組的唯一 ID。 |
|
訊息內文
|
body | MessageBody |
與單一訊息相關聯的內容。 |
|
執行緒識別碼
|
thread_id | integer |
執行緒的唯一 ID。 |
|
私訊
|
direct_message | boolean |
旗標以指定貼文是否為直接訊息。 |
|
用戶端識別碼
|
client_type | string |
用戶端的類型。 |
|
用戶端 URL
|
client_url | uri |
用戶端的 Web 連結。 |
|
語言
|
language | string |
訊息中使用的語言。 |
|
已標記的用戶
|
notified_user_ids | array of integer |
已通知的使用者詳細資料。 |
|
隱私權
|
privacy | string |
與訊息相關聯的隱私權詳細資料。 |
|
liked_by
|
liked_by | LikedBy |
喜歡者 |
|
是系統訊息
|
system_message | boolean |
旗標，以指定貼文是否為系統產生的訊息。 |
|
主題
|
topics | array of Topic |
主題清單。 |
訊息V2
單一Viva Engage訊息的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | integer |
與貼文相關聯的 ID。 |
|
文字
|
content_excerpt | string |
帖子的文字內容。 |
|
寄件者
|
sender_id | integer |
張貼訊息的使用者的唯一 ID。 |
|
回覆
|
replied_to_id | integer |
此訊息作為回覆的訊息 ID。 |
|
創建於
|
created_at | string |
建立訊息的時間。 |
|
網路
|
network_id | integer |
與網路訊息相關聯的 ID。 |
|
類型
|
message_type | string |
訊息類型的描述。 |
|
寄件者類型
|
sender_type | string |
寄件者類型的描述。 |
|
網址
|
url | uri |
貼文的 API 網址。 |
|
網址
|
web_url | uri |
貼文的網頁網址。 |
|
群組識別碼
|
group_id | integer |
張貼訊息之群組的唯一 ID。 |
|
訊息內文
|
body | MessageBody |
與單一訊息相關聯的內容。 |
|
執行緒識別碼
|
thread_id | integer |
執行緒的唯一 ID。 |
|
私訊
|
direct_message | boolean |
旗標以指定貼文是否為直接訊息。 |
|
用戶端識別碼
|
client_type | string |
用戶端的類型。 |
|
用戶端 URL
|
client_url | uri |
用戶端的 Web 連結。 |
|
語言
|
language | string |
訊息中使用的語言。 |
|
已標記的用戶
|
notified_user_ids | array of integer |
已通知的使用者詳細資料。 |
|
隱私權
|
privacy | string |
與訊息相關聯的隱私權詳細資料。 |
|
liked_by
|
liked_by | LikedBy |
喜歡者 |
|
是系統訊息
|
system_message | boolean |
旗標，以指定貼文是否為系統產生的訊息。 |
主題
單一主題的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | integer |
主題的唯一識別碼。 |
|
名稱
|
name | string |
主題的名稱。 |
可分頁訊息清單
一或多則訊息的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Messages
|
value | array of Message |
可分頁訊息清單V2
一或多則訊息的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Messages
|
value | array of MessageV2 |
訊息清單
一或多則訊息的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Messages
|
messages | array of Message |
messages |
訊息清單V2
一或多則訊息的清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Messages
|
messages | array of MessageV2 |
messages |
訊息內文
與單一訊息相關聯的內容。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
文字
|
parsed | string |
剖析的文字格式。 |
|
純文字
|
plain | string |
純文字格式。 |
|
富
|
rich | string |
RTF格式。 |
讚者
喜歡者
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Count
|
count | integer |
不同的點贊數量。 |
|
Names
|
names | array of object |
喜歡該帖子的人列表。 |
|
全名
|
names.full_name | string |
按讚貼文的人的全名。 |
網路
單一網路的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
網路的唯一識別碼。 |
|
名稱
|
name | string |
網絡摘要。 |
|
Link
|
permalink | string |
網路頁面的 Web 連結。 |
Yammmer實體
單一 Viva Engage 實體的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Description
|
type | string |
Viva Engage 實體的詳細數據。 |
|
群組識別碼
|
id | integer |
群組的唯一識別碼。 |
|
全名
|
full_name | string |
Viva Engage 實體的名稱。 |