共用方式為


傳送主動式 Microsoft Teams 訊息

在您發佈代理程式使代理程式可供 Microsoft Teams 中的使用者使用後,您可以透過主動式訊息通知 Microsoft Teams 中的使用者 (「收件者」)。 主動式訊息使用 Power Automate 流程來傳送其內容,這在許多情況下很實用,包括:

  • 讓收件者知道其先前的要求已完成。 例如,使用者的休假要求已獲核准。
  • 提供提醒或新訊息更新。 例如,代理程式可以發送提醒訊息以完成線上訓練。

重要

可以為在 Copilot Studio 中建立和自訂的代理程式和傳統聊天機器人設定主動式訊息。

如果收件者出現以下情況,代理程式將無法傳遞訊息:

  • Microsoft Teams 中未安裝代理程式。
  • 已解除安裝代理程式。
  • 已封鎖代理程式。
  • 沒有與代理程式聊天的權限,在這種情況下,您需要與其他使用者共用代理程式

必要條件

已知限制

  • 如果代理程式中斷連線並重新連線到 Microsoft Teams,則使用者在重新安裝代理程式之前不會收到主動式訊息。
  • 所有 Copilot Studio 的主動式訊息均受 Power Automate 的限制Microsoft Teams 連接器節流限制的規範。
  • 主動式訊息將不會紀錄於交談文字記錄或分析工作階段中。
  • 主動式訊息必須與 Power Automate 流程位於同一個環境中。
  • 主動式訊息只能發佈到與代理程式的個人聊天中。

傳送主動式訊息

  1. 在 Power Automate 中,打開您要傳送主動式訊息的流程。

  2. 新增 Microsoft Teams 連接器動作在聊天或管道中張貼訊息

  3. 針對 [張貼為],選擇 [Microsoft Copilot Studio (預覽版)]

  4. 張貼至中,選擇使用機器人聊天

  5. 對於機器人,選擇您想要發送訊息的代理程式。

  6. 收件者中,輸入收件者名稱或電子郵件地址。 如果收件者資訊來自流程中的先前步驟,您還可以使用動態內容。

  7. 訊息中,輸入您要傳送的訊息。

    在 Power Automate 中張貼訊息動作。

當流程執行時,收件者將收到來自 Microsoft Teams 中代理程式的主動式訊息。

傳送主動式調適性卡片

重要

本節詳細說明如何使用 Power Automate 流程傳送主動式調適型卡片。 主動調適型卡使使用者能夠從與代理程式的非使用中交談中接收訊息。

除了傳送主動式訊息之外,您也可以傳送主動式調適型卡片。

調適型卡片的螢幕擷取畫面。

調適型卡片是一種開放卡片交換格式,可讓開發人員以通用且一致的方式交換 UI 內容。 您可以在 JSON 手動製作調適型卡片,或者如果您喜歡拖放式介面,可以使用調適型卡片設計工具

Note

Power Automate 不支援使用範本化功能的調適型卡片。

在此範例中,您將傳送訂單摘要卡片供使用者檢閱。

  1. 在 Power Automate 中,在您想於流程中傳送卡片的步驟中新增 Microsoft Teams 連接器動作在聊天或管道中張貼調適性卡片

  2. 針對 [張貼為],選擇 [Microsoft Copilot Studio (預覽版)]

  3. 張貼至中,選擇使用機器人聊天

  4. 對於機器人,選擇您想要發送訊息的代理程式。

  5. 收件者中,輸入收件者名稱或電子郵件地址。 如果收件者資訊來自流程中的先前步驟,您還可以使用動態內容。

  6. 調適型卡片中,請輸入下列範本 JSON:

    {
        "type": "AdaptiveCard",
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.5",
        "body": [
            {
                "type": "TextBlock",
                "text": "Order summary",
                "wrap": true,
                "style": "heading"
            },
            {
                "type": "FactSet",
                "facts": [
                    {
                        "title": "Name",
                        "value": "John Doe"
                    },
                    {
                        "title": "Phone number",
                        "value": "(000) 000-0000"
                    }
                ]
            },
            {
                "type": "Container",
                "items": [
                    {
                        "type": "FactSet",
                        "facts": [
                            {
                                "title": "1x",
                                "value": "Steak"
                            },
                            {
                                "title": "2x",
                                "value": "Side Rice"
                            },
                            {
                                "title": "1x",
                                "value": "Soft Drink"
                            }
                        ],
                        "spacing": "Small"
                    }
                ],
                "spacing": "Small"
            }
        ]
    }
    

    在 Power Automate 中張貼調適性卡片動作。

執行流程時,收件者將收到來自 Microsoft Teams 的代理程式調適型卡。

等待使用者回覆

重要

本節詳細說明如何使用 Power Automate 流程傳送主動式調適型卡片。 主動調適型卡使使用者能夠從與代理程式的非使用中交談中接收訊息。

調適型卡片支援收集使用者輸入。 在這些案例中,您將需要等待使用者的回覆,才能繼續執行流程。

包含使用者動作的調適型卡片的螢幕擷取畫面。

Note

Power Automate 不支援使用範本化功能的調適型卡片。

在此範例中,您將傳送訂單確認卡片,讓使用者可在提交訂單之前進行變更。

  1. 在 Power Automate 中,在您想於流程中傳送卡片的步驟中新增 Microsoft Teams 連接器動作張貼調適型卡片並等候回覆

  2. 針對 [張貼為],選擇 [Microsoft Copilot Studio (預覽版)]

  3. 張貼至中,選擇使用機器人聊天

  4. 訊息中,請輸入下列範本 JSON:

    actions 區段中的屬性會決定要向使用者顯示的選項。

    {
        "type": "AdaptiveCard",
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.0",
        "body": [
            {
                "type": "TextBlock",
                "text": "Order confirmation",
                "wrap": true,
                "style": "heading"
            },
            {
                "type": "FactSet",
                "facts": [
                    {
                        "title": "Name",
                        "value": "John Doe"
                    },
                    {
                        "title": "Phone number",
                        "value": "(000) 000-0000"
                    }
                ]
            },
            {
                "type": "Container",
                "items": [
                    {
                        "type": "FactSet",
                        "facts": [
                            {
                                "title": "1x",
                                "value": "Steak"
                            },
                            {
                                "title": "2x",
                                "value": "Side Rice"
                            },
                            {
                                "title": "1x",
                                "value": "Soft Drink"
                            }
                        ],
                        "spacing": "Small"
                    }
                ],
                "spacing": "Small"
            }
        ],
        "actions": [
            {
                "type": "Action.Submit",
                "title": "Submit Order"
            },
            {
                "type": "Action.Submit",
                "title": "Edit Order"
            }
        ]
    }
    
  5. 更新訊息中,輸入收件者在提供回覆後會看到的更新訊息。

  6. 收件者中,輸入收件者名稱或電子郵件地址。 如果收件者資訊來自流程中的先前步驟,您還可以使用動態內容。

  7. 對於機器人,選擇您想要發送卡片的代理程式。

    在 Power Automate 中張貼調適型卡片並等候回覆動作

執行流程時,收件者會從 Microsoft Teams 中的代理程式收到調適型卡片,然後他們就能向其提供回覆。

若要使用收件者的回覆,請從動態內容彈出式功能表中選取 submitActionId。 此變數的值將是使用者選擇動作的 title

將主動式訊息傳送給多個收件者

在某些情境中,您可能會想將相同的主動式訊息一次傳送給多個收件者。

本節包含將訊息傳送給多個收件者的範例。

重要

本主題中詳述的先決條件適用於每個收件者。

例如,您可以透過一個動作將相同訊息傳送給 10 位收件者。 如果 10 位收件者中有 3 位沒有安裝代理程式,則這 3 位收件者將不會收到該訊息。

傳送給隊友

在此範例中,代理程式將向團隊成員發送提醒以完成線上訓練。

  1. 新增 Microsoft Teams 連接器,並在 Power Automate 流程中選取取得團隊動作。

  2. 團隊中,選擇要傳送訊息的成員所在的團隊。

  3. 新增 Office 365 群組連接器,並選取列出群組成員動作。

  4. 群組識別碼中,選取自訂值

  5. 取得團隊動作的動態內容中選取團隊識別碼

  6. 新增 Microsoft Teams 連接器,並選取在聊天或館動中張貼訊息動作。

  7. 針對 [張貼為],選擇 [Microsoft Copilot Studio (預覽版)]

  8. 張貼至中,選擇使用機器人聊天

  9. 對於機器人,選擇您想要發送訊息的代理程式。

  10. 收件者中,從列出群組成員動作中選取動態內容使用者主要名稱

    傳送給隊友的範例。

  11. 訊息中,輸入您要傳送的訊息。

當流程執行時,團隊中的每個使用者都將在與代理程式的私人聊天中收到主動式訊息。

傳送給安全性群組

在此範例中,代理程式將向安全性群組發送提醒以完成其線上訓練。

  1. 新增 Microsoft Entra ID 連接器,並在 Power Automate 流程中選取取得群組成員動作。

  2. 群組識別碼中,輸入安全性群組的 GUID。

  3. 新增 Microsoft Teams 連接器,並選取在聊天或館動中張貼訊息動作。

  4. 針對 [張貼為],選擇 [Microsoft Copilot Studio (預覽版)]

  5. 張貼至中,選擇使用機器人聊天

  6. 對於機器人,選擇您想要發送訊息的代理程式。

  7. 收件者中,從取得群組成員動作中選取動態內容群組成員使用者主要名稱

  8. 訊息中,輸入您要傳送的訊息。

    傳送到安全性群組選項。

當流程執行時,安全性群組中的每個使用者都將在與代理程式的私人聊天中收到主動式訊息。

將主動式訊息同時傳送給多個收件者

通常,當向多個收件者發送主動式訊息時,您的代理程式會發送一封又一封訊息。 但是,在某些情況下,最好同時將訊息發送給多個收件者。

警告

所有 Copilot Studio 的主動式訊息均受 Power Automate 的限制Microsoft Teams 連接器節流限制的規範。

如果您要將訊息傳送給大型收件者群組,則在您達到節流限制時就會看到錯誤。 您可以減少平行處理原則的程度,也可以減少群組中的收件者數目。

  1. 「套用到每個 動作」中,選擇三個點(...),然後 選擇設定

    選取設定的截圖。

  2. 打開並行控制項並設定平行處理原則程度。

    用於設定等級或並行的滑桿控制項。

設定主動式訊息的進階選項

Copilot Studio 可讓您在 Microsoft Teams 連接器中的顯示進階選項底下,控制代理程式上的詳細行為。

連接器中的擴充選項窗格。

將傳送的訊息標記為通知

標記為通知會控制訊息是否在代理程式名稱前顯示「透過以下通知」文字。 標記代理程式的回應允許接收者識別代理程式對其詢問的回應。

此設定顯示通知維亞代理程式名稱。

當收件者目前正在與代理程式聊天時

有時,當收件者與代理程式進行主動交談時,代理程式可能會發送主動式訊息。

您可能希望在他們完成交談前推遲傳送主動式訊息,以免中斷交談流程。

如果聊天處於使用中機器人可讓您控制行為:

  • 發送:代理程式將照常發送主動式訊息。

  • 不發送並成功:當收件者處於活動交談時,代理程式不會發送主動式訊息。 將傳回的狀態碼 300

  • 不發送並失敗:當收件者處於活動交談中時,代理程式不會發送主動式訊息。 流程執行將會標示為失敗。

當收件者未安裝代理程式時

代理程式只能將訊息傳遞給已在 Microsoft Teams 中安裝該代理程式的收件者。 收件者可能不想安裝代理程式,或已解除安裝代理程式。

對於重要性較低的訊息,您可以將流程執行設定為標記為成功,即使收件者沒有安裝代理程式也是如此。

如果未安裝機器人方塊可讓您控制行為:

  • 失敗:當接收者未在 Microsoft Teams 中安裝代理程式時,流程執行將標記為失敗。

  • 狀態代碼成功:即使收件者因未安裝代理程式而無法接收訊息,流程執行也會標記為成功。 將傳回的狀態碼 100

狀態碼定義

您可以使用傳回的狀態碼來定義流程中不同的後續行為。 例如,您可以指定流程應該在一段時間後重試,或記錄失敗相關記錄。

狀態碼 已成功 (布林值) Description
200 確判為真 訊息已成功傳送。
100 誤判為真 由於收件者未安裝代理程式,因此無法傳遞訊息。
300 誤判為真 由於收件者正在與代理程式交談,因此無法傳遞訊息。