RCSメッセージの失効

Vonage Messages API経由でRCSメッセージを送信する場合、そのメッセージの取り消し(ダウンストリームネットワークから受信者のデバイスに配信されない)をリクエストすることができます。

RCSメッセージの失効は、以下によって開始される。 PATCH リクエストをMessages APIエンドポイントに送る。 POST リクエストでメッセージを送信する。メッセージ・オブジェクトはUUIDで識別されます(これは POST メッセージ・オブジェクトを作成するリクエスト)。

について PATCH リクエストには JSON の値を設定する status を「取り消された。

Messages APIの詳細はこちらをご覧ください。 PATCH の Messages API 仕様 のコード例をご覧ください。 PATCH にリクエストする。 Messages API コード・スニペット

正しいエンドポイントの選択

RCSメッセージ失効リクエストを Messages API PATCH エンドポイントを使用する必要があります。 ジオロケーションサーバー をリクエストします。これは、RCSエージェントが起動された国によって異なります。どのサーバーを使用するかは、以下の表を参考にしてください。

地域 サーバー 国の例
EMEA(欧州中東アフリカ地域) api-eu.nexmo.com フランス、スペイン、ポルトガル、南アフリカ、ナイジェリア、ノルウェー、スウェーデン、オランダ、オーストリア、ドイツ、イギリス、イタリア
NA + LATAM(北米および南米) api-us.nexmo.com メキシコ、ブラジル、カナダ
APAC(アジア太平洋地域) api-ap.nexmo.com

注意事項

  • 失効要求を行うことは、メッセージが失効される(つまり配送されない)ことを 保証するものではない。例えば、メッセージはすでに配送されているかもしれないし、そうで なければ取り消すことができないかもしれない。
  • 失効要求は、元のメッセージ・オブジェクトが作成されてから24時間以内にのみ発生する。

さらに読む