RCS-Nachrichten verstehen

RCS, oder Reichhaltige Kommunikationsdiensteist ein Kommunikationsprotokoll zum Senden von Nachrichten an und zwischen Geräten, die mit einem Mobilfunknetz verbunden sind. RCS-Nachrichten können Text, Fotos, Videos und Dateien sowie interaktive Elemente wie Antwortvorschläge und Aktionsvorschläge enthalten.

Es gibt einige Ähnlichkeiten zu MMS-Nachrichten, aber auch einige wichtige Unterschiede:

• Zustellung der Nachricht:
  • Der Inhalt von MMS-Nachrichten wird über das Mobilfunknetz übermittelt.
  • RCS-Messaging erfordert eine Internetverbindung (entweder über eine mobile Datenverbindung oder Wi-Fi)
• Größe der Datei:
  • RCS-Nachrichten erlauben auch größere Dateigrößen für Bilder, Videos und Dateien als MMS
• Interaktivität und reichhaltige Inhalte:
  • RCS-Nachrichten bieten die Möglichkeit einer größeren Interaktivität mit vorgeschlagenen Aktionen und Antworten
  • RCS-Nachrichten bieten umfangreiche Inhalte in Form von Karten- und Karussell-Layouts

In Bezug auf die Funktionalität ist RCS Messaging näher an OTT-Kanälen (Over-the-Top) wie WhatsApp, Facebook Messenger, oder Viber. Ein wichtiges Unterscheidungsmerkmal zu diesen anderen Kanälen ist, dass RCS nativ unterstützt werden kann, ohne dass Anwendungen von Drittanbietern installiert werden müssen. Es gibt derzeit einige Einschränkungen in Bezug auf die Geräteunterstützung (siehe die RCS-Geräteunterstützung Abschnitt weiter unten in diesem Dokument).

Messages API RCS-Kanal

Der RCS-Kanal der Vonage Messages API nutzt Googles RBM (RCS Business Messaging) Server und unterstützt einen Großteil der von Google RBM bereitgestellten Funktionen.

Da es sich um einen Dienst eines Drittanbieters handelt, ist eine gewisse Einrichtung und Einarbeitung erforderlich, bevor Sie RCS-Nachrichten über die Messages API senden können. Siehe die Einrichten eines RBM-Agenten für RCS Messaging später in diesem Dokument.

RCS Messaging-Funktionen

Der RCS-Kanal Messages API unterstützt sowohl ausgehende Nachrichten (vom Unternehmen an den Kunden gesendete Nachrichten) als auch eingehende Nachrichten (vom Kunden an das Unternehmen gesendete Nachrichten als Antwort auf eine ausgehende Nachricht). Innerhalb dieser beiden Kategorien gibt es viele verschiedene Arten von Nachrichten.

Ausgehende Nachrichtentypen

Es gibt fünf Arten ausgehender Nachrichten:

• text
• image
• video
• file
• cards
• carousel

Die text, image, video und file Nachrichtentypen können verwendet werden, um verschiedene Arten von RCS-Nachrichten zu senden; siehe RCS-Text- und Mediennachrichtenarten für weitere Informationen. Die card und carousel Nachrichtentypen können verwendet werden, um komplexere RCS-Nachrichten zu senden, wie z. B. Rich Cards und Karussells. Um mehr über die Verwendung dieser Nachrichtentypen zu erfahren, siehe RCS Rich Cards Nachrichtentypen und RCS-Vorschläge Chips.

Eingehende Nachrichtentypen

Es gibt neun Arten von eingehenden Nachrichten:

• text
• image
• video
• audio
• file
• vcard
• location
• reply
• button

Die reply und button Inbound-Typen werden als Reaktion auf Kundeninteraktionen mit Antwortvorschlägen und Aktionsvorschlägen für ausgehende Nachrichten ausgelöst.

Status Webhook

Zusätzlich zu den ausgehenden und eingehenden Nachrichten bietet der RCS-Kanal Statusmeldungen über einen Webhook. Diese Nachrichten werden durch Änderungen des Zustellungsstatus einer ausgehenden Nachricht ausgelöst. Die verfügbaren Status für ausgehende Nachrichten sind:

• submitted
• delivered
• read
• rejected
• undeliverable

Weitere Einzelheiten zu ausgehenden und eingehenden Nachrichten sowie zum Status-Webhook finden Sie in der Messages API-Spezifikation.

RCS-Geräteunterstützung

RCS-Messaging wird auf Android, iOS und einigen anderen Gerätetypen unterstützt.

Wenn Sie RCS-Nachrichten senden, sollten Sie eine Überprüfung der Gerätefähigkeiten als Teil Ihres Nachrichten-Workflows einbeziehen. Siehe die Leitfaden zur Überprüfung der Gerätefunktionalität für weitere Informationen.

Technische Spezifikation

Einzelheiten zu Authentifizierung, JSON-Nutzdateneigenschaften, Antworten und Fehlern für die verschiedenen ausgehenden und eingehenden RCS-Nachrichtentypen sowie Statusmeldungen finden Sie in Messages API-Spezifikation.

Es gibt noch einige andere technische Details, die zu beachten sind.

Unterstützte Medientypen

Für die Nachrichtentypen, die Medien wie Bilder, Videos und Dateien enthalten können, werden die folgenden Medientypen unterstützt.

Nachrichten- und Mediengrößen

Es gibt einige Größenbeschränkungen und Richtlinien, die für Nachrichten und Medien zu beachten sind.

• Begrenzung der Textzeichen: 3000 utf-8 Zeichen
• Die maximale URL-Zeichenbegrenzung für den Medien-Upload beträgt 2000 Zeichen
• Die maximale Größe der gesamten stringifizierten RCS-Nachricht beträgt 250 KB. Dies schließt den Text ein, aus dem die JSON-Nutzlast beim Senden strukturierter Nachrichten besteht.
• Die maximale Größe einer Mediendatei, die über eine RCS-Nachricht gesendet werden kann, beträgt 100 MB.

Andere technische Details

• Verschlüsselung: Derzeit wird die Ende-zu-Ende-Verschlüsselung in RBM (die Vonage Messages API verwendet Google RBM für RCS Messaging) für geschäftliche Nachrichten nicht unterstützt. Persönliche Unterhaltungen in der Google Messages-App verfügen über eine Ende-zu-Ende-Verschlüsselung, aber RBM-Nachrichten werden aus Gründen der Einhaltung von Vorschriften und der Sicherheit über Google-Server geleitet. Google setzt jedoch Sicherheitsmaßnahmen wie TLS-Verschlüsselung, Datenverschlüsselung im Ruhezustand und Zugriffskontrollen ein, um RBM-Nachrichten zu schützen. Siehe Google RCS Sicherheitsmaßnahmen für weitere Informationen.
• Satzgrenze: Das standardmäßig für den RCS-Kanal aktivierte Ratenlimit beträgt 75 Anfragen pro Sekunde (pro API-Schlüssel). Dies kann auf Anfrage erhöht werden.
• Opt-in/Opt-out: Kontaktieren Sie Ihren Account Manager oder Unterstützung um die Opt-in- und Opt-out-Funktion zu aktivieren.

Einrichten eines RBM-Agenten für RCS Messaging

Um mit dem RCS-Messaging unter Verwendung des RBM-Agenten zu beginnen, führen Sie die folgenden zwei Schritte aus:

1. Registrieren Sie Ihren Agenten im Entwicklermodus:

• Wenden Sie sich an Ihren Account Manager, um die Aktivierung des Entwicklermodus für Ihren RBM-Agenten zu beantragen (RCS-Messaging ist derzeit nur für verwaltete Accounts verfügbar).
• Im Entwicklermodus können Sie die RCS-Nachrichtenfunktionalität gründlich testen und eine nahtlose Integration in Ihre Systeme sicherstellen.
• Nutzen Sie diesen Modus, um Ihre Implementierung zu entwickeln und zu verfeinern, bevor Sie live gehen.

2. Initiieren Sie die Agentenüberprüfung und den Start:

• Nachdem Sie Ihre API im Entwicklermodus erfolgreich getestet haben, können Sie nun RCS-Datenverkehr live senden.
• Wenden Sie sich bitte an Ihren Account Manager, um den Prozess der Agentenüberprüfung und -einführung einzuleiten (RCS-Messaging ist derzeit nur für verwaltete Accounts verfügbar).
• Sie führen Sie durch die notwendigen Schritte, um Ihren Agenten zu verifizieren und RCS-Live-Messaging für Ihr Unternehmen zu aktivieren.

Logo-Richtlinien

Sobald Sie Ihren Agenten erstellt haben, können Sie sein Branding aktualisieren, einschließlich des Anzeigenamens, der Beschreibung, der Farben und der Bilder, z. B. Ihres Firmenlogos:

Um die bestmögliche Benutzerfreundlichkeit zu gewährleisten, empfehlen wir Ihnen, diese Richtlinien für Ihr Logo und Ihre Banner zu befolgen:

• Logo: Ihr Logo wird angezeigt, wenn Ihr Agent eine Nachricht an einen Nutzer sendet, sowie auf dem Bildschirm "Info & Optionen" (wie oben gezeigt). Alle Logos werden auf einen Kreis zugeschnitten, auch wenn das Originalbild rechteckig war. Stellen Sie also sicher, dass das von Ihnen hochgeladene Bild nach dem Zuschneiden wie gewünscht erscheint. Wir empfehlen Ihnen, um das Logo herum genügend Platz zum Zuschneiden zu lassen und das Bild sowohl im hellen als auch im dunklen Modus zu testen, um die visuelle Klarheit zu gewährleisten.
• Banner-Bilder: Dies sind die rechteckigen Bilder, die auf dem Bildschirm "Info & Optionen" hinter Ihrem Logo angezeigt werden. Sie sollten ein Seitenverhältnis von 45:14 haben, um ein optimales Ergebnis zu erzielen, und bedenken Sie, dass das Logo dieses Bild teilweise überlappt.

Sie können die unten verlinkten Vorlagen als Richtlinien für Ihr Logo und Banner verwenden:

• Logo
  • PNG
  • SVG
• Banner
  • PNG
  • SVG

Weitere Informationen

• Erste Schritte mit RCS Messaging
• Messages API-Spezifikation
• RCS-Text- und Mediennachrichtenarten
• RCS-Vorschläge Chips
• RCS Rich Cards Nachrichtentypen
• Leitfaden: RCS-Agent-Fähigkeiten
• Leitfaden: RCS-Gerätefähigkeitsüberprüfung
• Leitfaden: Widerruf von RCS-Nachrichten
• Leitfaden: RCS-Best-Practices
• Leitfaden: RCS Agent Builder