RCS-Gesprächsabläufe

Dieser Leitfaden führt Sie durch den Entwurf und die Implementierung von RCS-Konversationsabläufen unter Verwendung der Messages API, mit praktischen Beispielen und Best Practices für den Aufbau von Konversationsreisen.

Was ist ein RCS-Gesprächsablauf?

Ein RCS-Konversationsablauf ist eine strukturierte Abfolge von Nachrichten und Benutzerinteraktionen. Er führt die Nutzer durch einen Prozess, wie z. B. einen Kauf, Support oder Updates, indem er Rich Media, Antwortvorschläge und automatische Logik verwendet.

A sequence flow of a message from an agent and a response from a user.

Entwerfen Sie Ihren RCS-Fluss

  1. Definieren Sie den Anwendungsfall: Geben Sie das Ziel an (z. B. Unterstützung, Verkauf, Benachrichtigung).
  2. Karte der Reise: Skizzieren Sie jeden Schritt, die Auswahl des Benutzers und das erwartete Ergebnis.
  3. Inhalt vorbereiten: Nachrichtenentwürfe, Medien und Antwortoptionen.
  4. Logik automatisieren: Verwenden Sie Webhooks und Backend-Logik, um Benutzereingaben zu verarbeiten und Antworten auszulösen.

Führen Sie die folgenden Schritte aus, um einen präzisen Gesprächsfluss im RBM-Stil mit Vonage-Endpunkten und -Nutzlasten zu implementieren.

Agent sendet eine Anfrage zur Überprüfung der Fähigkeiten

Überprüfen Sie vor dem Senden von RCS, ob das Gerät des Benutzers RBM-fähig ist.

Der Agent sendet:

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

Agent erhält Antwort auf Fähigkeitsprüfung

Die Plattform zeigt an, dass das Gerät RBM-Nachrichten empfangen kann.

Der Agent erhält:

{
   "rcs_supported": true,
   "features": [
      "RICHCARD_STANDALONE",
      "ACTION_CREATE_CALENDAR_EVENT",
      "ACTION_DIAL",
      "ACTION_OPEN_URL",
      "ACTION_SHARE_LOCATION",
      "ACTION_VIEW_LOCATION",
      "RICHCARD_CAROUSEL"
   ]
}

Agent sendet "Hallo, Welt!"

Senden Sie eine RCS-Textnachricht über die Messages API.

Der Agent sendet:

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"
}

Plattform sendet Ereignis DELIVERED

Die Nachricht wird dem Benutzer zugestellt und ein Zustellungsereignis wird an Ihren Status-Webhook gesendet.

Der Agent erhält:

{
  "messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
  "to": "+12223334444",
  "from": "welcome-bot",
  "timestamp": "2026-02-02T12:00:04Z",
  "status": "delivered",
  "channel": "rcs"
}

Plattform sendet READ-Ereignis

Der Benutzer öffnet die Nachricht. Ein Leseereignis wird an Ihren Status-Webhook gesendet.

Der Agent erhält:

{
  "messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
  "to": "+12223334444",
  "from": "welcome-bot",
  "timestamp": "2026-02-02T12:01:10Z",
  "status": "read",
  "channel": "rcs"
}

Benutzer sendet eine Antwort

Der Benutzer sendet eine Nachricht. Vonage übergibt sie an Ihren eingehenden Webhook.

Der Agent erhält:

{
  "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!"
}

Plattform bestätigt die Anlieferung

Eingehende Nachrichten werden an Ihren Webhook übermittelt (und implizit über den Webhook-Empfang bestätigt). Verwenden Sie die Webhook-Nutzlast, um die Konversation weiterzuleiten und das Ereignis zu protokollieren.

Agent sendet READ-Bestätigung

Bestätigen Sie die Nachricht des Benutzers, indem Sie sie als gelesen markieren.

Der Agent sendet:

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"
}

Weitere Informationen