すべてのプロダクト
Search
ドキュメントセンター

Short Message Service:配送レシートの設定

最終更新日:Dec 06, 2024

メッセージキューまたはHTTP URLを設定することで、メッセージの送信後に配信レシートを受け取ることができます。 これにより、メッセージの配信ステータスを監視し、それに応じてサービスをデプロイし、最適なパフォーマンスとユーザーエクスペリエンスを確保できます。

重要
  • ネットワークエラーが発生した場合、またはメッセージ配信中に応答がタイムアウトした場合、配信レシートが繰り返しプッシュされるか、受信できない場合があります。

  • メッセージ配信設定が有効になるまでに時間がかかる場合があります。 3分間待ってから、配送レシートがプッシュされているかどうかを確認することをお勧めします。

  • 配達領収書のべき等性は保証できません。 配送領収書を受け取った後、データの正確性と一貫性を確保するために適切な対策を講じることを推奨します。

配送レシートエンドポイント

MNSキューまたはHTTP URLを設定して、必要に応じてレシートメッセージまたはMOメッセージを受信できます。

  • メッセージキュー

    特定のリージョンからの配送レシートを受信するようにメッセージキューを設定できます。 MNSキューは、Alibaba Cloud Short message Service (SMS) のすべてのメッセージタイプをサポートしています。 SMSコンソールでMNSが指定したメッセージタイプをサブスクライブできるようにすると、MNSは自動的にキューを生成します。 SMS SDKを呼び出して、メッセージタイプとキュー名で配信レシートを取得できます。

  • HTTP URL

    SMSの配信レシートまたはMOメッセージを受信するようにHTTP URLを設定できます。 これを実現するために、SMSはHTTP POSTメソッドを利用して、配信レシートまたはMOメッセージを指定されたHTTP URLにプッシュします。 SMSコンソールでHTTPコールバックURLを設定できます。 サービスメッセージが生成されると、システムは、指定されたコールバックURLへの配信レシートを含むHTTP POST要求を送信します。 これにより、メッセージを直接受信できます。

配送レシートの種類

受け取りたい配送レシートの種類を選択する必要があります。 さまざまなシナリオでは、さまざまなタイプの配送レシートが使用されます。 配送レシートの種類を次の表に示します。

説明

MNSキュー

HTTP URL

MT配信レポート (SmsReport)

モバイル着信 (MT) 配信レポートは、SMSキャリアから顧客に送信されるメッセージ (通知またはビジネスメッセージなど) です。 MT配信レポートは、各メッセージの配信ステータスと詳細を示します。

SMS webhook

SmsReport

配送レシートの設定

SMSメッセージの配信レシートを受信するには、SMSコンソールで配信レシートの設定を構成する必要があります。 次の操作を実行して設定を構成します。

  1. SMS コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、[システム設定] > [一般設定] を選択します。

  3. [一般設定] ページで、[API] タブをクリックします。

  4. [SMS配信レポートの設定] セクションで、配信レシートの1つ以上のエンドポイントを設定します。

    • MNSキュー

      [メッセージキュー] オプションを有効にします。MNS配置

    • HTTP URL

      1. HTTP URLオプションを有効にします。

      2. HTTP URLを入力します。 例: http://push.example.com/contextpath/receive.do.

      3. [保存] をクリックします。HTTP配置

MNSキューのリクエストパラメータ

パラメーター

必須 / 任意

説明

MessageType

String

SmsReport

メッセージのタイプ。 値をSmsReportに設定します。

キュー名

String

アリコム-キュー-*****-SmsReport

キューの名前。 キューの名前を表示するには、SMSコンソールにログインし、左側のナビゲーションウィンドウで [システム設定] > [一般設定] > [API] を選択します。