將 Bot 連線至 Outlook 通道以進行可採取動作的郵件 （預覽）

  • 發行項

適用于： SDK v4

可採取動作的郵件可讓使用者從 Outlook 內快速採取動作。 當您將 Bot 連線到 Outlook 可採取動作的郵件通道時，Bot 可以使用調適型卡片來建立可採取動作的郵件，增強使用者參與度。

注意

可採取動作郵件的 Outlook 通道處於公開預覽狀態。 預覽中包含的功能可能不完整，而且可能會在公開版本中提供之前進行變更。 它們僅供評估和探索之用。

警告

違反 Bot Framework 行為規範 來建立「spambots」，包括傳送垃圾或未經請求大量電子郵件的 Bot。

必要條件

注意

  • 請勿針對 Bot 使用您自己的個人電子郵件帳戶，因為傳送至該電子郵件帳戶的每個訊息都會轉寄給 Bot。 這可能會導致 Bot 不適當地將回應傳送給寄件者。 基於這個理由，Bot 應該只使用專用的 O365 電子郵件帳戶。
  • 如果您使用 Microsoft Exchange Server，請在設定電子郵件通道之前啟用 自動探索 。

設計訊息

可採取動作的郵件的 Outlook 通道會透過電子郵件傳送和接收調適型卡片。

您可以使用可採取動作的郵件 設計 工具來設計和測試可採取動作的消息卡。

重要

通用 Bot 動作模型是在調適型卡片架構 1.4 版中引進。 若要使用這些新功能，調適型卡片的版本屬性應設定為 1.4 或更新版本。 請參閱 調適型卡片架構總管中的 Action.Execute 。

實作和部署 Bot

一般流程是讓 Bot 將可採取動作的訊息傳送給使用者，然後處理使用者的動作。

  1. 當使用者在電子郵件中回應卡片時，Outlook 會將叫用活動傳送給 Bot。 活動的 value 屬性包含具有 type 、 verb 和 data 屬性的動作物件。 例如，活動會包含下列資訊，其中 動詞 和 資料 會對應至一開始傳送 Bot 之卡片上的資訊。

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    如需完整的物件架構，請參閱 調適型卡片架構總管中的 Action.Execute 。

  2. Bot 會處理傳入叫用活動，並傳回結果，其中包含將取代原始調適型卡片的新調適型卡片。 叫用回應可能如下所示：

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

要求存取

  1. 在Azure 入口網站 中 開啟 Bot 資源。
  2. 開啟 [ 通道] 窗格。
  3. 選取 Outlook 頻道。
  4. 在 [ 設定 Outlook] 頁面上，選取 [請在這裡 註冊]。
  5. 填寫註冊表單以要求存取權。 如需詳細資訊，請參閱 使用可採取動作的電子郵件開發人員儀表板 註冊您的服務。

下一步