アクション可能メッセージのボットを Outlook チャネルに接続する (プレビュー)

  • [アーティクル]

この記事の対象: SDK v4

アクション可能メッセージを使用すると、ユーザーは Outlook 内からすばやくアクションを実行できます。 ボットを Outlook アクション可能メッセージ チャネルに接続すると、ボットはアダプティブ カードを使用してアクション可能メッセージを作成し、ユーザー エンゲージメントを強化できます。

Note

アクション可能メッセージの Outlook チャネルはパブリック プレビュー段階です。 プレビューに含まれる機能は完全ではない場合があり、一般リリースで利用可能になる前に変更される可能性があります。 これらは、評価と調査の目的でのみ提供されています。

警告

望まれていない電子メールや承認されていない電子メールを一括送信するボットなどの "スパムボット" の作成は、Bot Framework の倫理規定違反です。

前提条件

Note

  • 個人の電子メール アカウントをボットで使用しないでください。これを行うと、その電子メール アドレスに送信されたすべてのメッセージがボットに転送されます。 その結果、ボットが不適切な応答を送信元に送信する可能性があります。 このため、ボットでは、専用の O365 メール アカウントを使用する必要があります。
  • Microsoft Exchange Server を使用している場合は、メール チャネルを構成する前に自動検出を有効にしてください。

メッセージを設計する

アクション可能メッセージの Outlook チャネルは、メール経由でアダプティブ カードを送受信します。

アクション可能メッセージ デザイナーを使用して、アクション可能なメッセージ カードを設計およびテストできます。

重要

ユニバーサル ボット アクション モデルは、アダプティブ カード スキーマ バージョン 1.4 で導入されました。 これらの新機能を使用するには、アダプティブ カードのバージョン プロパティを 1.4 以降に設定する必要があります。 アダプティブ カード スキーマ エクスプローラーでの Action.Execute を参照してください。

ボットを実装してデプロイする

一般的なフローは、ボットがアクション可能メッセージをユーザーに送信し、ユーザーのアクションを処理することです。

  1. ユーザーがメールでカードに応答すると、Outlook はボットに呼び出しアクティビティを送信します。 アクティビティの value プロパティには、typeverb および data プロパティを備えたアクション オブジェクトです。 たとえば、アクティビティには次の情報が含まれます。動詞とデータは、ボットが最初に送信したカードに関する情報に対応します。

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

    完全なオブジェクト スキーマについては、「アダプティブ カード スキーマエクスプローラーでの Action.Execute」を参照してください。

  2. ボットは着信呼び出しアクティビティを処理し、元のアダプティブ カードの代わりに使用される新しいアダプティブ カードを含む結果を返します。 呼び出し応答は次のようになります。

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

アクセスの要求

  1. Azure portal でボット リソースを開きます。
  2. [チャネル] ウィンドウを開きます。
  3. Outlook チャネルを選択します。
  4. [Outlook の構成] ページで、[ここで登録してください] を選択します。
  5. アクセス権を要求するには、登録フォームに入力します。 詳細については、「アクション可能なメール開発者ダッシュボードにサービスを登録する」を参照してください。

次のステップ