操作可能なメッセージを電子メールによって Office 365 で送信する

  • [アーティクル]

重要

グローバル スコープを持つ新しいアクション可能メッセージ プロバイダーのオンボードは、サービスのアップグレードにより、2024 年 6 月 30 日まで一時的に一時停止されます。 既存 のグローバル スコープ プロバイダーと 組織 および テスト スコープ プロバイダーのオンボードは影響を受けません。 詳細については、「 アクション可能なメッセージについてよく寄せられる質問」を参照してください。

サポートされるシナリオ

電子メール経由の操作可能なメッセージの送信は、次のシナリオでサポートされています。

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

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

まず、アクション可能なメッセージ カードを作成します。 まず、アクションとAction.OpenUrlアクションを使用したシンプルで基本的なカードAction.Httpから始めます。 アクション可能メッセージ Designerを使用して、カードを設計します。

重要

このトピックのサンプル カード マークアップは、originatorプロパティが省略されています。 これは受信者が送信者と同じテスト シナリオで機能します。 操作可能なメッセージを他の人に送信する場合、originator プロパティは、操作可能な電子メールの開発者ダッシュボードによって生成された有効なプロバイダー 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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.com/outlook/actionable-messages"
      }
    ]
  }
  </script>
</head>
<body>
Visit the <a href="https://video2.skills-academy.com/outlook/actionable-messages">Outlook Dev Portal</a> to learn more about Actionable Messages.
</body>
</html>

  4. 本文に HTML が含まれるメッセージを SMTP を使用して送信します。

メッセージを送信する

メッセージ送信の例については、以下をご覧ください。

操作を実行する

操作の実行の例は、以下を参照してください。

  • Hellow Actionable Messages: ワンクリック ボタンで Azure へデプロイを行うサンプル プロジェクト。 このサンプルは、10 分以内に稼働させられるシンプルな操作可能なメッセージに関するエンドツーエンド ソリューションで、運用のためのアクション エンドポイントを作成する際に参照できます。

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