重要
アクション可能メッセージでは、Microsoft Entra ID ベースのトークン認証が使用されます。 レガシ (EAT) 認証からの移行は、2026 年 6 月 8 日に完了しました。 レガシ認証はサポートされなくなりました。
Microsoft Entra IDトークンを使用するように更新されていない統合は機能しなくなりました。 パートナーは、すべてのアクション可能メッセージ統合Entra ID ベースのトークン認証を使用する必要があります。 詳細については、「アクション可能メッセージのMicrosoft Entra ID トークンを有効にする」を参照してください。
サービスからアクション可能なメッセージをテストして公開するには、特定の情報を Microsoft に提供して、サービスからの電子メールに対してこの機能を有効にします。 開発者ダッシュボードは、Web ポータルを介して申請の状態を送信して追跡するのに役立ちます。
注:
Microsoft の介入なしに、必要なマークアップを使用して電子メールを自分に送信することで、電子メールを介して実用的なメッセージを簡単に試すことができます。 通常、この手順は、この機能に足の踏み込む際に試す最初の手順です。 これらのサンプルを確認して、メールボックスにアクション可能なメッセージを送信するか、アクション可能なメッセージ Designerを使用して操作可能なメッセージを自分に送信します。
電子メールでアクション可能なメッセージを操作する開発者の場合は、次の場合にポータルを使用します。
- サービスから独自のメールボックスに対するアクション可能なメッセージをテストするには
- Microsoft 365 を使用してorganization内のすべてのメール ユーザーがこれらの特別な形式のメッセージを受信できるように、サービスからアクション可能なメッセージを発行します。 通常、このオプションを使用すると、基幹業務アプリなど、organizationに固有のサービスからのアクション可能なメッセージが有効になります。
- サービスを使用する Microsoft 365 のメール ユーザーが、これらの特別な形式のメッセージを受信できるように、サービスから実用的なメッセージを発行するには
このような場合は、Microsoft に詳細を送信してください。 確認と承認後、Microsoft はサービスに対してアクション可能なメッセージを有効にします。
ダッシュボード セクション
開発者ダッシュボードは、サービスからアクション可能なメッセージを有効にするために Microsoft に要求するスコープに基づいて入力する必要があるいくつかの論理セクションに分かれています。
プロバイダーの詳細
このセクションでは、Microsoft 365 がサービスからのマークアップを含むメールと、それらのメールのアクション ボタンが呼び出すことができる URL を受け入れることを許可するキーの詳細を指定します。
キー フィールドは次のとおりです。
送信者の電子メール アドレス: アクション マークアップを含む電子メールを送信するサービスに対応する 1 つ以上の静的メール アドレスを入力します。 たとえば、「
myservice@contoso.com」のように入力します。ターゲット URL: アクションを処理する URL に対応する 1 つ以上のドメインを入力します。 ターゲット URL は、TLD の最上位ドメインまたはサブドメインに対応できます。 HTTPS 対応 URL である必要があります。 たとえば、「
https://api.myservice.com」のように入力します。公開キー: アクション可能なメッセージを署名済みカードとして送信する場合は、カードの署名に使用する秘密キーに対応する公開キーを指定します。 このフィールドの形式は、RSAKeyValue 要素です。
<RSAKeyValue> <Modulus>xA7SEU+e0yQ...</Modulus> <Exponent>AQAB</Exponent> </RSAKeyValue>
PowerShell (7.3 以降) を使用して、正しい形式で RSA キー ペアを生成およびエクスポートできます。
# Generate a key pair:
$rsa = [System.Security.Cryptography.RSA]::Create();
# Private Key, ensure this is saved securely and kept secret:
$rsa.ToXmlString($true)
## Public Key, copy output to dashboard:
$rsa.ToXmlString($false)
.cert ファイルから公開キー XML を取得する方法の例については、「 PublicKey クラス」を参照してください。
注:
申請が承認された後、変更が有効になるには時間がかかる場合があります。 署名済みカードを送信するときに次のエラーが発生し、ペイロードが正しいことを確認した場合は、数時間後にもう一度やり直してください。
Adaptive card signature validation failed - Failed to validate signature
申請の範囲
サービスに対してアクション可能なメッセージを有効にするスコープを指定します。 適用可能な範囲は次のとおりです。
- ユーザーのテスト: このスコープを使用すると、サービスから、organization内の一部の Microsoft 365 メール ユーザーへのアクション可能な電子メールが有効になります。 このスコープを使用して、指定したいくつかのテスト ユーザーとのアクション可能なメッセージ統合をテストします。
- 組織: このスコープにより、サービスから、organization内の任意の Microsoft 365 メール ユーザーに対するアクション可能なメッセージが有効になります。 このスコープを使用して、基幹業務アプリケーションなど、organizationに固有のサービスからのアクション可能なメッセージを有効にします。
- グローバル: このスコープを使用すると、Microsoft 365 のすべてのメール ユーザーに対してサービスからのアクション可能なメッセージが有効になります。
各スコープは独立しています。 要求ごとに 1 つのスコープのみを送信でき、Microsoft の承認を取得する必要があります。
注:
Microsoft の介入なしに、必要なマークアップを使用して電子メールを自分に送信することで、実用的なメッセージを簡単に試すことができます。 コードを記述せずに自分に送信するには、アクション可能なメッセージ Designerを使用します。 通常、この手順は、アクション可能なメッセージを試す最初の手順です。
セルフサービス登録
セルフサービス登録は、次のスコープで使用できます。
- テスト ユーザー: 登録要求は、指定したテスト ユーザーに対して自動承認します。 この登録により、テスト ユーザーに送信されたサービスからのアクション可能な電子メールが有効になります。
- 組織: この登録要求は、確認と承認のためにorganizationの Exchange またはグローバル管理者にルーティングされます。
申請が承認されると、自動承認か管理者かに関係なく、登録が有効になるまでに最大 24 時間かかることがあります。
24 時間後に、サービスからアクション可能なメッセージをメールボックスまたは指定されたテスト ユーザー (テスト ユーザー スコープの場合) またはorganization内の任意のユーザー (組織のスコープ用) に送信して、登録がアクティブであることを確認します。 24 時間が経過しても登録がまだアクティブでない場合は、登録ダッシュボードの上部にある [ 登録が機能しません]というラベルの付いたフィードバック リンクを使用して、お問い合わせください。
テスト ユーザーのメール アドレス
このセクションは、操作可能なメッセージの有効化に関する申請の範囲がテスト ユーザーの場合にのみ適用されます。
organization内の Microsoft 365 メール ユーザーの一覧をセミコロン (;) で区切って指定します。 この一覧は、 組織 または グローバル スコープの申請を作成する前に、アクション可能なメッセージと少数のユーザーとの統合をテストするのに役立ちます。
連絡先情報
このセクションは、操作可能なメッセージの有効化に関する申請の範囲がグローバルの場合にのみ適用されます。
このセクションでは、連絡先の詳細を入力し、お客様の申請について Microsoft から質問がある場合に連絡がとれるようにする必要があります。 すべて有効で正確な情報を入力してください。
発行元の情報
このセクションは、操作可能なメッセージの有効化に関する申請の範囲がグローバルの場合にのみ適用されます。
このセクションでは、操作可能なメッセージを送信するサービスに関する詳細と、関連するサポート情報を入力し、Microsoft がお客様、またはダイレクト カスタマーがお客様のサポート サイトに連絡がとれるようにする必要があります。 この情報は、プロバイダーに対する Microsoft による承認プロセスの一環でも使用されます。
シナリオの詳細
このセクションは、操作可能なメッセージの有効化に関する申請の範囲がグローバルの場合にのみ適用されます。
このセクションでは、ユーザーがサービスからアクション可能なメッセージを使用するシナリオの詳細を提供する必要があります。 これは、Microsoft がソリューションの有効性と有用性を判断するのに役立ちます。
検証の詳細
このセクションは、操作可能なメッセージの有効化に関する申請の範囲がグローバルの場合にのみ適用されます。
このセクションでは、操作可能なメッセージ、およびプロバイダー/サービスから送信されたメールによって呼び出される対応するアクションを Microsoft が検証するための詳細を提供する必要があります。
さらに、実際の運用サーバー (または DKIM/SPF/From:/Return-Path: ヘッダーが似たサーバー) から送信される有効な電子メールを送信します。これには、マークアップが含 onboardoam@microsoft.com。 この手順により、Microsoft は、ソリューションが登録基準に記載されているすべてのガイドラインと要件に準拠していることを判断できます。
- メールを送信する前に、マークアップが正しいことを確認します。
- Microsoft 365 では、メールの転送時にすべてのマークアップが削除されます。 メールは転送せず、直接送信してください。
登録の条件
Microsoft 365 のユーザーに広範な影響を与える可能性があるため、 グローバル スコープの承認のためにソリューションを提出するときは、これらの条件に留意してください。
メール送信者の品質ガイドライン
- DKIM または SPF を使用して電子メールを認証します。
- SPF チェックや DKIM 署名のトップレベル ドメイン (TLD) は、お客様の
From:メール アドレスの TLD と一致する必要があります。 たとえば、From: myservice@contoso.comを使用する場合、DKIM または SPF は、contoso.comまたは-.contoso.comのものである必要があります。 -
myservice@contoso.comなどの静的メール アドレスから電子メールを送信します。 - メール送信者のガイドラインに従ってください。
- Microsoft 365 については、「 外部メール送信者向けの Microsoft 365 サービス」を参照してください。
- Outlook.com については、「 ポリシー、プラクティス、およびガイドライン」を参照してください。
- 業界のガイドラインについては、「 M3AAWG 送信者のベスト プラクティス」 と 「ReturnPath 送信のベスト プラクティス」を参照してください。
- ドメインから大量のメール (少なくとも 1 日 100 件のメールを Microsoft 365 に送信する) の一貫した履歴を少なくとも数週間保持します。
- ユーザーからのスパム苦情の割合を非常に低く維持します。
- サービスに対して、忠実性、ルーチン性、シンプルなアクションを使用します。 より複雑な操作を行う場合は、
Action.OpenUrlアクションを使用します。 - 高い対話率が予想されるトランザクション メールに対してアクションを使用します。 プロモーション用の一括メールでは使用しないでください。
アクションのガイドライン
- ボタンのラベルには、実行するアクションが明確に反映されている必要があります。
-
Action.OpenUrlaction は、アクション可能なメッセージに表示されるエンティティまたは情報に関連付けられている特定のページにディープ リンクする必要があります。 - アクション要求を処理するサービスに対して、低い失敗率と高速応答を維持します。
- アクション可能なメッセージの設計に関するその他のガイドラインについては、「 アダプティブ カード形式を使用した Outlook のアクション可能なメッセージ カードの設計」を参照してください。
申請の承認
提出時に指定したメール アドレスに通知が届きますので、適切な連絡先情報を入力してください。