メッセージング接続

Introduction

Azure Communication Services を使用してショート メッセージ サービス (SMS) をグローバルに配信する新しい方法である Messaging Connect へようこそ。 信頼できるパートナーが統合されているため、番号をリースし、ローカルの規制要件を満たしながら、使い慣れた Azure Communication Services (単一 API エンドポイント、強力な可観測性、Microsoft サービス全体の深い統合) を引き続き使用できます。 Messaging Connect は、予定のリマインダー、予約確認、インテリジェントな Copilot プロンプトを送信する場合でも、複雑さを軽減してユーザーにグローバルにアクセスするのに役立ちます。

複数のプロバイダーとの個別の統合を構築して維持する代わりに、Azure Communication Services 経由で 1 回接続し、トラフィックをグローバル パートナーにルーティングします。 パートナーは、番号リースとコンプライアンスを処理します。 メッセージング、可観測性、AI ワークフローは、既に構築、監視、およびスケーリングを行っている Azure 環境内に残ります。

値の概要:

• 世界190カ国以上でグローバルに展開

• パートナーを通じたローカル コンプライアンスと迅速なプロビジョニング

• Azure Communication Services API/SDK、診断、Event Grid の可観測性を簡単に使用できます

• 職務分掌: Microsoft は開発者プラットフォームを提供し、パートナーが番号を割り当ててプロビジョニングします。

概念の概要

グローバル SMS は本質的に複雑です。規制は国によって異なり、送信者の種類は異なり、配信ルートは断片化されています。 Messaging Connect は、事前に承認されたパートナーを統合しているため、Azure Communication Services 開発者エクスペリエンスを離れることなく、準拠している送信者 ID を取得し、トラフィックをルーティングできます。

プロビジョニング フロー (上位レベル):

1. Azure portal で、[メッセージング接続] ブレードに移動します。

2. Messaging Connect パートナーを選択します。

3. パートナーのポータルにリダイレクトされ、SMS 対応の電話番号を購入/構成し、必要な登録を完了し、承認を待ちます。

4. パートナーは、承認された番号を Azure Communication Services リソースに同期します。

5. この番号は Azure portal に表示され、Azure Communication Services SMS API で使用できる状態になります。

標準の Azure Communication Services SMS API を使用して SMS を送受信できます。 メッセージを送信するときは、通常どおり Azure で認証を行い、実行時に Messaging Connect パートナーからのキーを含めます。そのため、トラフィックを適切にルーティングできます。 パートナーはメッセージ配信を処理しますが、配信のレシート、診断、ログなどの可観測性は、他のサービスと共に Azure に残ります。

このモデルは、実際のシナリオで適切に機能します。 Messaging Connect を使用すると、Copilot Studio で AI を利用したアシスタントを構築する場合でも、ブラジルとインドでローカルの送信者 ID を必要とする物流を管理する場合でも、数十か国にわたるキャンペーンを調整する場合でも、世界中のユーザーにリーチできます。 Azure Communication Services では、Messaging Connect を使用して、信頼されたパートナーを通じて適切な送信者 ID を取得し、Azure で完全な制御と可観測性を維持しながら、優先する Azure Communication Services SMS SDK でそれらを使用できます。

Capabilities

次の表は、パブリック プレビュー中にメッセージング接続を使用するときに使用できる機能をまとめたものです。 一部の機能は Azure によって直接提供され、他の機能は Messaging Connect パートナーによって提供されます。

🌐 利用可能な国

Messaging Connect は、グローバル パートナー ネットワークを通じて 190 か国を超える国をサポートし、Azure Communication Services で利用できる国の数を大幅に拡大します。 パブリック プレビュー中は、メッセージング接続パートナーから次の 2 種類の送信者 ID を取得して使用できます。

• 長いコード – 双方向 SMS をサポートする標準のローカル電話番号または携帯電話番号。 多くの場合、Virtual Long コードと呼ばれます。
• 動的な英数字送信者 ID - 許可されている場合は、一方向のブランド送信者 (例: "CONTOSO")。 DASID は、Azure Communication Services でサポートされていない国でのみ有効にすることができます。

Azure portal で国と番号の種類を検索すると、Azure Communication Services がその構成を直接サポートしていない場合は、Messaging Connect がオプションとして提供されます。 その後、パートナーのポータルを使用してプロビジョニング プロセスを完了します。

Messaging Connect パートナーは、国の可用性を決定します。 Messaging Connect パートナー (Infobip など) は、番号の種類、コンプライアンス要件、オンボード手順を処理します。これは国によって異なります。

認証: Azure ID を使用したアクセスのセキュリティ保護

Messaging Connect を介してメッセージを送信するには、サポートされている ID モデルのいずれかを使用して、アプリケーションが Azure Communication Services で認証を行う必要があります。 この手順では、アプリが Azure Communication Services リソースを介してメッセージを送信するアクセス許可を持っていることを確認し、メッセージが正しい Azure サブスクリプションに関連付けられていることを確認します。

Azure Communication Services では、次の認証方法がサポートされています。

• アクセス キー認証 (接続文字列)
• Microsoft Entra ID 認証

Azure Communication Services で認証する方法は、他の SMS 要求の場合と同じです。 Messaging Connect は、プラットフォーム レベルでの認証の動作方法を変更しません。メッセージの検証後にパートナーベースのルーティング手順を追加するだけです。

詳細情報: Azure Communication Services に対する認証

認証されると、アプリケーションには、メッセージを正しい Messaging Connect パートナー経由でルーティングするためのパートナー API キーも実行時に含まれます。 このパートナー API キーはメッセージ ペイロードの一部であり、次のセクションで詳しく説明します。

Messaging Connect が要求を検証する方法

メッセージング接続を使用してメッセージを送信する前に、Azure は要求に必要なルーティング情報が含まれており、正しく認証されていることを確認します。 この手順を実行するには、ペイロードに、Messaging Connect パートナーを識別し、Azure Communication Services がインフラストラクチャを介してメッセージをルーティングできるようにする特定のメタデータを含める必要があります。

必要なペイロード形式

Messaging Connect 番号を使用してメッセージを送信する場合、要求には messagingConnect オブジェクトを含める必要があります。 このオブジェクトには、Messaging Connect パートナーによって提供される API キー (Infobip など) とパートナーの名前が含まれます。 Azure では、この情報を使用して要求を承認し、メッセージのルーティング方法を決定します。

{
  "from": "+447700900123",
  "to": ["+447700900456"],
  "message": "Hello from Messaging Connect!",
  "options": {
    "messagingConnect": {
      "apiKey": "your-partner-api-key",
      "partner": "[PARTNER NAME]"
    }
  }
}

メッセージング接続を使用してプロビジョニングされた番号を使用する場合は常に、 messagingConnect オブジェクトが必要です。 見つからないか正しく構成されていない場合、Azure Communication Services はメッセージを拒否します。 このメタデータが含まれると、Azure Communication Services は 2 つの段階で検証チェックを実行します。最初に、Azure Communication Services は要求を受信するとすぐに検証し、次にパートナーに送信した後でもう一度検証します。

同期検証

この検証の最初のレイヤーは、Azure Communication Services がメッセージ要求を受信するとすぐに発生します。 パートナー名、API キー、番号と Azure Communication Services リソースの関連付けなど、何かが見つからないか無効な場合は、すぐにエラー応答が返されます。 このチェックにより、メッセージが誤って送信されたり、間違ったパートナーにルーティングされたりするのを防ぐことができます。

一般的な検証結果:

これらのエラーは API 応答で同期的に返され、Azure の診断とログにも表示されます。

非同期配信エラー

要求が同期検証に合格した場合でも、Azure Communication Services はメッセージング接続パートナーに引き続き渡さない可能性があります。 場合によっては、受け渡し前に Azure Communication Services によってメッセージが停止されます。たとえば、受信者が以前にオプトアウトした場合や、パートナーからの既知の配信ブロックがある場合などです。 このような状況では引き続き配信レポートが生成されるため、メッセージの結果は常に通知されます。 メッセージがパートナーに渡されると、ダウンストリーム配信エラー (到達不能数、有効期限切れ、キャリア レベルの拒否など) も、配信レポートを介して非同期的に返されます。 Azure Event Grid イベント (構成されている場合) から配信レポートの配信状態を表示できます。

詳細情報: Azure Event Grid イベントに関する配信レポート

セキュリティで保護された準拠メッセージングによるグローバル アクセス

Messaging Connect は、アジア、アフリカ、南アメリカ、欧州連合のどちらからでも、グローバルに使用するために構築されています。 このセクションでは、リージョン間でのデータフローの方法、プライバシーの維持方法、および Azure が所在地の要件に確実に準拠する方法について説明します。

メッセージ ルーティングとデータ フロー

Messaging Connect は、メッセージ配信 (パートナーが処理) と処理と監視 (Azure によって処理) を分離します。 そのしくみを次に示します。

• 送信メッセージ: Azure Communication Services API を使用して SMS を送信し、 messagingConnect オブジェクト経由でパートナー ルーティング情報を含めます。 Azure によってメッセージがログに記録され、検証が実行され、選択した Messaging Connect パートナーにルーティングされます。
• 受信メッセージ: パートナーは SMS を受信し、それを Azure のインフラストラクチャに転送します。 そこから、Azure Communication Services は、Azure Communication Services のネイティブ番号に送信されたメッセージと同様にメッセージを処理し、Event Grid を介してイベントをトリガーします。

パートナーは配信を処理しますが、Azure では次のものが提供されます。

• 配信確認と可観測性
• Standard Azure Communication Services API と SDK
• 一時的なメッセージ処理のみ - メッセージの内容は保存されません

Azure Communication Services では、配信または失敗後も SMS メッセージの内容は保持されません。 メッセージとメタデータは、ルーティングと診断に必要な場合にのみメモリ内で一時的に処理されます。

詳細情報: データの保存場所とユーザーのプライバシー

EU データ境界 (EUDB)

Azure Communication Services では、EUDB 内の SMS データが EUDB リージョンに格納されることが保証されます。 現時点では、オランダ、アイルランド、またはスイスのリージョンでデータを処理および格納し、EEA (欧州経済地域) 外での不正なデータ転送を防止しています。 また、Azure Communication Services では、保存時と転送中の両方で SMS データを保護するために、暗号化を含む高度なセキュリティ対策が採用されています。 お客様は、EUDB 内で優先するデータ所在地を選択し、指定された EU リージョン内にデータが残っていることを確認できます。

詳細情報: 欧州連合データ境界 (EUDB)

どこからでもメッセージング接続を使用する

Messaging Connect は、グローバルに使用するように設計されています。 Messaging Connect パートナーを通じて数値を取得した後は、ホストされている場所に関係なく、Azure Communication Services API を使用してアプリケーションに統合します。 ただし、一部の国では、番号の使用、許可されたコンテンツ タイプ、またはトラフィック配信の要件に関するローカル通信ルールが適用されます。 メッセージング接続パートナーは、番号のプロビジョニング プロセス中にこれらの要件を管理します。 パートナーは、Azure Communication Services ではなく、配信ルートを最適化します。 番号の種類、ローカルルール、パートナーの設定によっては、メッセージがローカルまたはリージョンのインフラストラクチャを経由する場合があります。

オプトアウト管理

オプトアウトとオプトインコンプライアンスは、特に規制対象市場におけるSMSメッセージングの重要な部分です。 Messaging Connect では、この責任はお客様 (顧客)、パートナー (Infobip など)、Microsoft の間で共有され、それぞれが異なる役割を果たします。

主な責任

• パートナー (Infobip など) は、"STOP" や "START" などのオプトアウトキーワードとオプトイン キーワードの検出をサポートしていますが、動作は自動ではありません。

• "登録を解除しています" などの確認メッセージは、既定では送信されません。 必要に応じて、パートナーと明示的に構成するか、独自のアプリケーションに実装する必要があります。
• お客様は、メッセージング エクスペリエンスが、オプトアウト処理、キーワード構成、エンドユーザーの同意管理など、ローカルの規制に準拠していることを確認する責任を負います。
• Azure Communication Services では、オプトアウト キーワードを処理したり、自動応答を送信したりすることはありません。 ただし、Microsoft では、監視のために一連の定義済みのオプトアウト キーワードを保持しています。

Azure Communication Services の機能

既定では、Azure Communication Services は標準のオプトイン/アウト キーワードを検出します。START と UNSTOP は Opt-In トリガーとして認識され、STOP、ARRET、QUIT、END、REVOKE、OPT OUT、CANCEL、UNSUBSCRIBE はオプトアウト コマンドとして認識されます。 受信メッセージがこれらのキーワードのいずれかに正確に一致すると、Azure Communication Services は自動的に要求を処理し、それに応じてデータベース内のユーザーのオプトイン状態を更新します。

価格と課金

Messaging Connect では、デュアル料金モデルを使用して、Microsoft のプラットフォーム使用量をパートナーの配送およびリース サービスから分離します。

お客様が Microsoft に支払う内容

メッセージング接続に Azure Communication Services API とインフラストラクチャを使用するには、プラットフォーム料金を支払います。 ここでは、メッセージ処理、診断、配信追跡、API レベルの監視について説明します。

• メッセージが最終的にパートナーによって配信されるかどうかに関係なく、送信される各 SMS 送信要求に対して、Azure は $0.0025 プラットフォーム料金を請求します。 Microsoft は配信に対して料金を請求しません。
• この料金は Azure 前払い (通貨コミット) と MACC 対象 (Microsoft Azure 従量課金コミットメント) であり、通常の Azure 請求書の一部として表示されます。

メッセージ配信は、Microsoft ではなく Messaging Connect パートナーが処理します。

パートナーに支払う金額

あなたは、Messaging Connect パートナーに直接支払います。

• 電話番号のリース (月単位または年単位)
• 国とルートによって異なるメッセージごとの配信料金

パートナーは、商用用語とサポート レベルを定義します。 既定では、メッセージング 接続パートナー (Infobip など) から、配送料と番号リース料金が直接請求されます。 Marketplace の課金を明示的に設定しない限り、これらの料金は Azure 請求書に表示されません。 サブスクリプションの制限はありません。 Messaging Connect は、従量課金制や Enterprise Agreement など、任意の種類の Azure サブスクリプションで使用できます。 Microsoft のダイレクト SMS オファーとは異なり、Messaging Connect は通信サービスではなく、開発者プラットフォーム モデルです。

省略可能: Azure Marketplace 経由の統合請求

料金を Azure 請求書に統合する場合は、パートナーに Azure Marketplace 経由で Messaging Connect を提供するよう要求できます。 Marketplace フローのしくみを次に示します。

1. パートナー (Infobip) に、Azure Marketplace 経由でプライベート オファーを送信するよう依頼します。
2. Azure 管理者が Azure portal でオファーを受け入れます。
3. パートナーは毎月、使用状況データを Microsoft に送信します。
4. Microsoft はパートナーに代わってお客様に請求します (パススルー料金)。

このセットアップにより、調達が簡素化され、Messaging Connect の使用量が Azure MACC コミットメントにカウントされます。

詳細情報: Azure Marketplace

開発者エクスペリエンス

Messaging Connect で電話番号を取得する

Messaging Connect には新しいプロビジョニング モデルが導入されています。Microsoft から直接番号を取得する代わりに、信頼できるパートナー (Infobip 以降) を通じて取得し、Azure Communication Services リソースに接続します。 このプロセスを使用すると、190 か国以上の SMS 番号にアクセスできます。パートナーは、現地のコンプライアンス、ドキュメント、承認フローを処理します。

次の手順に進みましょう。

1. Messaging Connect パートナーを選択する

   Azure portal の Communication Services リソースで、[ メッセージング接続 ] ブレードに移動し、一覧からパートナーを選択します。 使用条件に同意します。 番号の取得を完了するには、パートナーの Web サイトにリダイレクトされます。

2. パートナーのポータルで番号を取得する

   番号を購入するには、Messaging Connect パートナーから提供されたプロンプトに従います。 国によっては、サポート ドキュメントのアップロードまたは本人確認の完了が必要になる場合があります。 承認されると、パートナー アカウントに番号が割り当てられます。

   

3. Azure portal に戻る

   パートナーは、自分の番号がプロビジョニングされていることを確認すると、Azure Communication Services との同期をトリガーします。 同期が完了すると、Azure Communication Services を介して直接プロビジョニングされた任意の数と同様に、ACS SMS API で使用できる ACS リソースに番号が自動的に表示されます。 追加のセットアップは必要ありません。

   

   Note

   Messaging Connect パートナーは、承認とアクティブ化のタイムラインを設定します。これは、国と番号の種類によって異なります。 Messaging Connect は現在、インスタント プロビジョニングをサポートしていません。また、Microsoft は審査または承認プロセスに関与していません。

重要な注意事項:

• Microsoft は、Messaging Connect 番号のコンプライアンスや審査を管理しません。 パートナーはこのプロセスを完全に処理します。
• 各パートナーは、リージョンとローカル通信の規制に応じて、プロビジョニング フローとサービス レベル アグリーメント (SLA) が異なります。
• Messaging Connect を使用して取得した番号は、Azure Portal に "オペレーター名" ラベルと共に表示されるため、Azure Communication Services で管理される番号と区別できます。
• これらの番号でメッセージを送信するには、API 要求に MessagingConnect オブジェクトを含めるのを忘れないでください。

SMS SDK チュートリアル

Messaging Connect は、Azure Communication Services の既存の SMS 機能に基づいています。 同じ SMS API と SDK を使用するため、ACS を使用したメッセージの送信に既に慣れている場合は (特に SMS の送信クイックスタートを完了した場合)、もうすぐそこにいます。 必ず Send SMS with options メソッドを使用し、オプション フィールドに MessagingConnect オブジェクトを含めます。

Azure Communication Services を初めて使用する場合は、まず SMS 送信クイックスタート を完了して認証を設定し、 SmsClientを作成し、送信要求の基本的な構造を理解します。 MessagingConnect オブジェクトを要求に含めるようにしてください。

このオブジェクトには次のものが含まれます。

• パートナー名 (例: "infobip")
• 番号を取得した後に受け取ったパートナー API キー

Azure Communication Services トークンは引き続き Azure に要求を承認し、パートナー キーはメッセージのルーティング方法を Azure Communication Services に指示します。

次の例では、C# と JavaScript を使用して Messaging Connect でメッセージを送信する方法を示します。

C# の例

smsClient.Send(
    from: "<YOUR-ACS-NUMBER>",
    to: ["<RECIPIENT-NUMBER>"],
    message: $"Hello from Azure Communication Services!",
    options: new SmsSendOptions(true)
    {
        MessagingConnect = new MessagingConnectOptions("<YOUR-INFOBIP-API-KEY>", "infobip")
    });

JavaScript の例

await smsClient.send(
    {
      from: "<YOUR-ACS-NUMBER>",
      to: ["<RECIPIENT-NUMBER>"],
      message: "Hello from Azure Communication Services! JS SDK is working!",
    },
    {
        enableDeliveryReport: true, // Optional: Enable delivery reports
        messagingConnect: {
          apiKey: "<YOUR-INFOBIP-API-KEY>",
          partner: "infobip"
      }
  });

SMS エラー コード

メッセージング接続を介して SMS メッセージを送信すると、同期検証 (即時 API 応答) の一部として、または非同期配信レポートでエラー コードが発生する可能性があります。 Azure Communication Services では、Messaging Connect を含むすべての SMS トラフィックで同じエラー モデルが使用されます。

詳細情報: SMS エラー コードの完全な一覧を参照してください

Messaging Connect パートナー ディレクトリ

Messaging Connect は、信頼できるグローバル SMS プロバイダーとの直接統合を通じて機能します。 これらのパートナーは、番号のプロビジョニング、コンプライアンス、配信、およびオプトアウトの適用を処理します。一方、Azure は開発者プラットフォーム、可観測性、メッセージ オーケストレーションを提供します。 次の表に、現在サポートされているパートナーの一覧を示します。 より広範なカバレッジと冗長性を提供するために、時間の経過と伴ってより多くのパートナーが追加されます。

次のステップ