このドキュメントでは、RCS for Business プラットフォームがメッセージ送信やその他の API 連携をどのように処理するかを明確にし、同期オペレーションと非同期オペレーションを区別します。
RBM API のインタラクションは通常、HTTP レベルで同期リクエスト / レスポンス パターンに従います。ただし、多くの API 呼び出しの結果（特にメッセージ配信）は、Webhook を介して非同期で処理されます。詳細については、以下のセクションをご覧ください。
メッセージ送信: 同期リクエスト、非同期配信
phones.agentMessages.create API リクエストは、API の観点から同期的に処理されます。RCS for Business プラットフォームに HTTP リクエストを送信すると、サーバーはリクエストが受信され有効であるかどうかを示す標準の HTTP ステータス コード（200 OK やエラーなど）をほぼ即座に返します。
ただし、エンドユーザーへのメッセージの実際の配信は非同期で処理されます。このプロセスに影響する要因は次のとおりです。
- 受信者のステータス: ユーザーがオフラインである、バッテリーが切れている、RCS が有効になっていない可能性があります。
- ネットワークの状況: 携帯通信会社のネットワークの問題により、メッセージの配信が遅れたり、配信できなくなったりすることがあります。
RCS for Business プラットフォームは、ウェブフックを介して、メッセージの配信ステータスの更新（配信確認や既読確認など）を非同期で提供します。したがって、最初の API リクエストは同期ですが、メッセージ配信を追跡するには、非同期 Webhook イベントを使用する必要があります。phones.agentMessages.create レスポンスから配信ステータスの確認がすぐに返されるとは限りません。
その他の RBM API の操作
他のほとんどの HTTP ベースの RBM API も、同期リクエスト / レスポンス モデルで動作します。これらの API は、リクエストのステータス（成功またはエラー）を示す HTTP レスポンスをすぐに返します。ただし、リクエストは同期ですが、リクエストの結果として発生するアクションには非同期プロセスが含まれる場合があります。たとえば、エージェント情報を更新する API 呼び出しに対する正常なレスポンスは、更新がすぐにすべての場所に反映されることを意味するものではありません。伝播に短い遅延が発生する可能性があります。
Webhook エンドポイント: 非同期イベント
次のイベントは、Webhook エンドポイントに非同期で配信されます。
- ユーザーからのメッセージ: RCS for Business プラットフォームは、ユーザーからのメッセージを Webhook エンドポイントにプッシュします。受信メールを確認してください。
- 配信確認と既読確認: メッセージの配信ステータスと既読ステータスの通知は、Webhook を介して送信されます。
- 会話イベント: 入力インジケーターなど、会話に関連する一部のイベントは Webhook を介して送信されます。
- メッセージの有効期限切れと取り消しイベント: RCS for Business プラットフォームは、有効期限切れのメッセージが正常に取り消されたかどうかを確認するイベントを送信します。