RCS会話の流れ
このガイドでは、Messages APIを使用したRCS会話フローの設計と実装について、会話ジャーニーを構築するための実践的な例とベストプラクティスを紹介します。
RCSの会話フローとは？
RCS会話フローは、メッセージとユーザーインタラクションの構造化されたシーケンスです。リッチメディア、返信候補、自動化されたロジックを使用することで、購入、サポート、アップデートの受信などのプロセスを通じてユーザーをガイドします。
RCSフローの設計
- ユースケースを定義する： 目標を明確にする（サポート、販売、通知など）。
- 旅の地図 各ステップ、ユーザーの選択、期待される結果を概説する。
- コンテンツを準備する： 下書きメッセージ、メディア、返信オプション。
- ロジックを自動化する： ウェブフックとバックエンドロジックを使用して、ユーザーの入力を処理し、レスポンスをトリガーします。
以下の手順に従って、Vonageのエンドポイントとペイロードを使用して、正確なRBMスタイルの会話フローを実装してください。
エージェントが能力チェック要求を送信
RCSを送信する前に、ユーザーのデバイスがRBM対応であることをVerifyする。
エージェントは送信する：
POST /v1/channel-manager/rcs/agents/welcome-bot/devices/capabilities
HTTP/1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
エージェントがケイパビリティ・チェック応答を受信
プラットフォームは、デバイスがRBMメッセージを受信できることを示す。
エージェントは受け取る：
{
"rcs_supported": true,
"features": [
"RICHCARD_STANDALONE",
"ACTION_CREATE_CALENDAR_EVENT",
"ACTION_DIAL",
"ACTION_OPEN_URL",
"ACTION_SHARE_LOCATION",
"ACTION_VIEW_LOCATION",
"RICHCARD_CAROUSEL"
]
}
エージェントが "Hello, World!"を送信
Messages API経由でRCSテキストメッセージを送信する。
エージェントは送信する：
POST /v1/messages
HTTP /1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
{
"message_type": "text",
"text": "Hello, World!",
"to": "12223334444",
"from": "welcome-bot",
"channel": "rcs"
}
プラットフォームがDELIVEREDイベントを送信
メッセージはユーザーに配信され、配信イベントがステータスウェブフックに送信されます。
エージェントは受け取る：
{
"messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
"to": "12223334444",
"from": "welcome-bot",
"timestamp": "2026-02-02T12:00:04Z",
"status": "delivered",
"channel": "rcs"
}
プラットフォームがREADイベントを送信
ユーザーがメッセージを開く。読み取りイベントがステータスウェブフックに送信されます。
エージェントは受け取る：
{
"messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
"to": "12223334444",
"from": "welcome-bot",
"timestamp": "2026-02-02T12:01:10Z",
"status": "read",
"channel": "rcs"
}
ユーザーが返信を送信
ユーザーがメッセージを送信します。Vonageはそれを受信ウェブフックに配信します。
エージェントは受け取る：
{
"to": "welcome-bot",
"from": "12223334444",
"channel": "rcs",
"message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
"timestamp": "2026-02-02T12:02:23Z",
"message_type": "text",
"text": "Hello to you!"
}
プラットフォームが着信を確認
インバウンドメッセージはウェブフックに配信されます（ウェブフック受信によって暗黙的に確認されます）。Webhook ペイロードを使用して会話をルーティングし、イベントをログに記録します。
エージェントがREAD応答を送信
ユーザーのメッセージを既読にする。
エージェントは送信する：
PATCH /v1/messages/aaaaaaaa-bbbb-cccc-dddd-0123456789ab
HTTP/1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
{
"status": "read"
}