Office 365 での操作可能なメッセージの概要

重要

アクション可能メッセージでは、Microsoft Entra ID ベースのトークン認証が使用されます。 レガシ (EAT) 認証からの移行は、2026 年 6 月 8 日に完了しました。 レガシ認証はサポートされなくなりました。

Microsoft Entra IDトークンを使用するように更新されていない統合は機能しなくなりました。 パートナーは、すべてのアクション可能メッセージ統合Entra ID ベースのトークン認証を使用する必要があります。 詳細については、「アクション可能メッセージのMicrosoft Entra ID トークンを有効にする」を参照してください。

重要

アクション可能メッセージ プロバイダー ポータルが新しい場所に移動しました。 新しいポータルにアクセスします。

サポートされるシナリオ

次のシナリオでは、アクション可能なメッセージを電子メールで送信できます。

  • 受信者は、グループではなく個人でなければなりません。
  • 受信者は、メッセージ上で表示されていなければなりません。 受信者を BCC フィールドに配置しないでください。
  • 受信者には、Outlook.com または Office 365 の Exchange Online にメールボックスがなければなりません。

注:

Office 365管理者は、Set-OrganizationConfig コマンドレットを使用して、アクション可能なメッセージを無効にすることができます。 アクション可能なメッセージがレンダリングされない場合は、管理者にチェックして、organizationで機能が有効になっていることを確認します。

操作可能なメッセージ カードを作成する

Action.Http アクションとAction.OpenUrl アクションを使用した基本的なカードという単純な操作から始めましょう。 アクション可能メッセージ Designerを使用して、カードを設計します。

重要

このトピックのサンプル カード マークアップは、originatorプロパティが省略されています。 この省略は、受信者が送信者と同じテスト シナリオで機能します。 アクション可能なメッセージを他のユーザーに送信する場合は、originator プロパティを、Actionable Email Developer Dashboard によって生成された有効なプロバイダー ID に設定します。 他のユーザーに送信するときにこのプロパティを空のままにすると、カードは削除されます。

[アクション可能メッセージ] Designerに移動し、次の JSON を貼り付けます。

{
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

Designerでこの簡単な例を自由に試してください。 使用可能なフィールドの詳細については、アダプティブ カード リファレンスを参照してください。 満足しているカードがある場合は、送信に進むことができます。

電子メール経由でアクション可能なメッセージを送信する

重要

アクション可能なメッセージを設計してテストするには、アクション可能メッセージ Designerを使用します。 アクション可能なメッセージが送信されます。 また、Office 365 SMTP サーバーを使用して、アクション可能なメッセージを自分に送信することもできます。 アクション可能なメッセージ開発者ダッシュボードを使用して登録するまで、 アクション可能なメッセージを他のユーザーに送信することはできません。

アクション可能なメッセージ カードを電子メール メッセージに埋め込むには、<script> タグにカードをラップします。 <script> タグを電子メールの HTML 本文の<head>に挿入します。

注:

カード JSON を <script> タグにラップする必要があるため、アクション可能なメッセージ電子メールの本文は HTML である必要があります。 プレーンテキスト メッセージはサポートされていません。

  1. 電子メールの本文の処理を制御する hideOriginalBody 属性を追加します。 本文が表示されないように、属性を true に設定します。

    {
  "type": "AdaptiveCard",
  "version": "1.0",
  "hideOriginalBody": true,
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}

  2. 結果の JSON を type application/adaptivecard+json の <script> タグでラップします。

    注:

    アダプティブ カード形式ではなくレガシ メッセージカード形式を使用している場合は、<script> タグの種類をapplication/ld+jsonする必要があります。

    <script type="application/adaptivecard+json">{
  "type": "AdaptiveCard",
  "version": "1.0",
  "hideOriginalBody": true,
  "body": [
    {
      "type": "TextBlock",
      "text": "Visit the Outlook Dev Portal",
      "size": "large"
    },
    {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
    },
    {
      "type": "Input.Text",
      "id": "feedbackText",
      "placeholder": "Let us know what you think about Actionable Messages"
    }
  ],
  "actions": [
    {
      "type": "Action.Http",
      "title": "Send Feedback",
      "method": "POST",
      "url": "https://...",
      "body": "{{feedbackText.value}}"
    },
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://learn.microsoft.com/outlook/actionable-messages"
    }
  ]
}
</script>

  3. メール本文を表す HTML ドキュメントを生成し、<script> タグを <head> に含めます。

    <html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <script type="application/adaptivecard+json">{
    "type": "AdaptiveCard",
    "version": "1.0",
    "hideOriginalBody": true,
    "body": [
      {
        "type": "TextBlock",
        "text": "Visit the Outlook Dev Portal",
        "size": "large"
      },
      {
        "type": "TextBlock",
        "text": "Click **Learn More** to learn more about Actionable Messages!"
      },
      {
        "type": "Input.Text",
        "id": "feedbackText",
        "placeholder": "Let us know what you think about Actionable Messages"
      }
    ],
    "actions": [
      {
        "type": "Action.Http",
        "title": "Send Feedback",
        "method": "POST",
        "url": "https://...",
        "body": "{{feedbackText.value}}"
      },
      {
        "type": "Action.OpenUrl",
        "title": "Learn More",
        "url": "https://learn.microsoft.com/outlook/actionable-messages"
      }
    ]
  }
  </script>
</head>
<body>
Visit the <a href="https://learn.microsoft.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

  4. 本文として HTML を使用して SMTP 経由でメッセージを送信します。

メッセージを送信する

メッセージの送信例については、次のリソースを参照してください。

操作を実行する

アクションの実行例については、次のリソースを参照してください。

  • Hello アクション可能なメッセージ: ワンクリックで展開Azureサンプル プロジェクト。 このサンプルは、10 分以内に設定して使用を開始できる、シンプルなエンドツーエンドのアクション可能なメッセージ ソリューションです。 これは、運用アクション エンドポイントを構築するための参照として機能します。

トラブルシューティング ツール

  • Last updated on