Simple Message Queue (SMQ) キューまたは HTTP URL を設定することで、メッセージ送信後に配信レポートを受信できます。これにより、メッセージの配信ステータスをモニターし、それに応じてサービスをデプロイできるため、最適なパフォーマンスとユーザーエクスペリエンスを確保できます。
メッセージ配信中にネットワークエラーが発生した場合や応答がタイムアウトした場合、配信レポートが繰り返しプッシュされたり、受信に失敗したりすることがあります。
メッセージ配信設定が有効になるまで時間がかかる場合があります。3 分ほど待ってから、配信レポートがプッシュされるか確認することを推奨します。
配信レポートのべき等性は保証されません。配信レポート受信後、データの正確性と一貫性を確保するために、適切な措置を講じることを推奨します。
配信レポートのエンドポイント
Short Message Service (SMS) は、配信レポートを受信するために、Simple Message Queue (旧称：MNS) 消費モードと HTTP バッチプッシュモードの 2 つのモードを提供しています。ニーズに最も適したモードを選択してください。
SMQ キュー
SMQ キューを設定して、指定したリージョンから配信レポートを受信できます。SMQ キューは、Alibaba Cloud SMS のすべてのメッセージタイプをサポートしています。SMS コンソールで SMQ を有効にして指定したメッセージタイプをサブスクライブすると、SMQ は自動的にキューを生成します。メッセージタイプとキュー名で SMS SDK を呼び出して、配信レポートをプルできます。
HTTP URL
HTTP URL を設定して、SMS の配信レポートまたは MO メッセージを受信できます。これを実現するために、SMS は HTTP POST メソッドを利用して、配信レポートまたは MO メッセージを指定の HTTP URL にプッシュします。SMS コンソールで HTTP コールバック URL を設定できます。サービスメッセージが生成されると、システムは配信レポートを含む HTTP POST リクエストを指定のコールバック URL に送信します。これにより、メッセージを直接受信できます。
配信レシートの種類
受信したい配信レポートのタイプを選択する必要があります。配信レポートのタイプによって、利用シーンが異なります。次の表に、配信レポートのタイプを示します。
タイプ | 説明 | SMQ キュー | HTTP URL |
MT 配信レポート (SmsReport) | モバイルターミネーテッド (MT) 配信レポートは、SMS キャリアから顧客に送信されるメッセージ (通知メッセージやビジネスメッセージなど) です。MT 配信レポートは、各メッセージの配信ステータスと詳細を示します。 |
配信レシートの設定
SMS メッセージの配信レポートを受信するには、SMS コンソールで配信レポートの設定を行う必要があります。次の操作を実行して設定します。
SMS コンソールにログインします。
左側のナビゲーションウィンドウで、 を選択します。
インターフェイス API タブをクリックします。
クラウドコミュニケーションメッセージ受信 セクションで、配信レポートのエンドポイントを 1 つ以上設定します。
メッセージキュー
SMQ キューオプションを有効化します。
HTTP URL
HTTP URL オプションを有効化します。
HTTP URL を入力します。例：http://push.example.com/contextpath/receive.do
保存 をクリックします。
SMQ キューのリクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
MessageType | String | はい | SmsReport | メッセージのタイプ。値を SmsReport に設定します。 |
QueueName | String | はい | Alicom-Queue-*****-SmsReport | キューの名前。SMS コンソールにログインし、 を選択して、キューの名前を表示します。 |