Office 365 での操作可能なメッセージの概要
重要
グローバル スコープを持つ新しいアクション可能メッセージ プロバイダーのオンボードは、サービスのアップグレードにより、2024 年 6 月 30 日まで一時的に一時停止されます。 既存 のグローバル スコープ プロバイダーと 組織 および テスト スコープ プロバイダーのオンボードは影響を受けません。 詳細については、「 アクション可能なメッセージについてよく寄せられる質問」を参照してください。
サポートされるシナリオ
電子メール経由の操作可能なメッセージの送信は、次のシナリオでサポートされています。
- 受信者は、グループではなく個人でなければなりません。
- 受信者は、メッセージ上で表示されていなければなりません。 受信者を BCC フィールドに入れないようにしてください。
- 受信者には、Outlook.com または Office 365 の Exchange Online にメールボックスがなければなりません。
注:
Office 365 管理者は、Set-OrganizationConfig コマンドレット を使用して、操作可能なメッセージを無効にすることができます。 操作可能なメッセージが表示されない場合は、組織内で機能が有効になっていることを管理者に確認してください。
操作可能なメッセージ カードを作成する
まず、アクション可能なメッセージ カードを作成します。 最初に、Action.Http
アクションとAction.OpenUrl
アクションを使用したシンプルで基本的なカードから始めます。
アクション可能メッセージ 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://learn.microsoft.com/outlook/actionable-messages"
}
]
}
Designerでこの簡単な例を自由に試してください。 使用可能なフィールドの詳細については、アダプティブ カード リファレンスを参照してください。 気に入ったカードが作成できたら、次にカードの送信に取りかかります。
操作可能なメッセージを電子メール経由で送信する
重要
アクション可能メッセージ Designerを使用して、アクション可能なメッセージを設計およびテストできます。これにより、アクション可能なメッセージを自分に送信できます。 Office 365 SMTP サーバーを使用して操作可能なメッセージを自分自身に送信することもできます。 操作可能なメッセージの開発者ダッシュボードを使用して登録するまでは、他のユーザーが操作可能なメッセージを送信することはできません。
電子メール メッセージに操作可能なメッセージ カードを埋め込むには、カードを <script>
タグでラップする必要があります。 次いで、<script>
タグは、電子メールの HTML 本文の <head>
に挿入されます。
注:
カード JSON を <script>
タグ内にラップする必要があるため、操作可能な電子メール メッセージの本文は HTML でなければなりません。 テキスト形式のメッセージはサポートされていません。
電子メールの本文の処理を制御する
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" } ] }
結果の 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>
メール本文を表す 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>
本文に HTML が含まれるメッセージを SMTP を使用して送信します。
メッセージを送信する
メッセージ送信の例については、以下をご覧ください。
- Microsoft Graph を使用して実行可能なメッセージを送信する: Microsoft Graph を使用して実行可能なメッセージを送信する、C# で作成されているサンプル コンソール アプリです。
- 操作可能なメッセージを SMTP で送信する:Office 365 SMTP サーバーを使用して、操作可能なメッセージを送信する Python サンプル スクリプトです。 これには、操作可能なメッセージのメール本文のサンプル HTML ペイロードも含まれています。
操作を実行する
操作の実行の例は、以下を参照してください。
- Hellow Actionable Messages: ワンクリック ボタンで Azure へデプロイを行うサンプル プロジェクト。 このサンプルは、10 分以内に稼働させられるシンプルな操作可能なメッセージに関するエンドツーエンド ソリューションで、運用のためのアクション エンドポイントを作成する際に参照できます。
トラブルシューティング ツール
- 操作可能なメッセージのデバッガー: 開発者が操作可能なメッセージ内のカードのペイロードを検査し、カードが表示されない理由を識別できる Outlook アドイン。