Kapitel 01 von 07

Was die RCS-Box ist

Die RCS-Box ist die Schnittstelle, über die Ihr Unternehmen Nachrichten per RCS for Business verschickt und Antworten Ihrer Kundinnen und Kunden empfängt. Sie bündelt alles, was dafür nötig ist, in einer einzigen, zugangsgeschützten Anbindung: Nachrichten über die Agents Ihrer Marke senden, Agents verwalten, Testerinnen und Tester einladen und eingehende Antworten an Ihr eigenes System weiterleiten.

Dieser Guide richtet sich an Produktmanagement, Marketing und Compliance. Er erklärt, wie der Weg von der Marke bis zur ersten Nachricht aussieht, welche Regeln beim Versand gelten und wo Sie selbst gefragt sind. Die technische Referenz in englischer Sprache finden Ihre Entwicklerinnen und Entwickler unter /docs.

Die Rolle der Box zwischen Ihnen und Google

RCS for Business ist der Nachrichtenkanal, den Google in der Nachrichten-App von Android-Geräten bereitstellt. Die technische Infrastruktur dafür betreibt Google; Vertragspartner auf Google-Seite ist Google Ireland Ltd. mit Sitz in Dublin, Verarbeitung und Vertragsbeziehung bleiben damit innerhalb der EU. Die Zustellung auf das Endgerät übernehmen die deutschen Netzbetreiber, mit denen der Betreiber der RCS-Box Verträge hält.

Die RCS-Box sitzt dazwischen. Ihr System spricht ausschließlich mit der Box; die Box spricht mit Google; Google reicht die Nachricht an den Netzbetreiber des Empfängers weiter. In der Gegenrichtung läuft es genauso: Eine Antwort der Kundin geht an Google, Google ruft die Box, die Box leitet die Antwort an Ihr System weiter.

Für Sie bedeutet das:

• Sie brauchen keinen eigenen Zugang zur Plattform von Google und keine eigenen Verträge mit Netzbetreibern.
• Die Box kümmert sich um die Schritte, die Google und die Netzbetreiber vor dem Versand verlangen: Verifizierung der Marke und Freigabe (Launch) jedes Agents, siehe Kapitel 2.
• Pflichten, die aus den Verträgen mit den Netzbetreibern folgen, geben wir an Sie weiter. Sie stehen in Kapitel 4.

Hinweis: Google unterzieht Nachrichten einer automatisierten, flüchtigen Sicherheitsprüfung als Phishing-Schutz. Inhalte werden dabei nicht dauerhaft gespeichert und sind strikt vom Werbegeschäft von Google getrennt; die Daten dienen allein dem Transport und dem Schutz vor Missbrauch.

Mandant, Marke, Agent

Drei Begriffe ziehen sich durch den gesamten Guide:

• Mandant ist Ihr Unternehmen als Kunde der RCS-Box. Jeder Mandant ist von allen anderen getrennt und erhält einen eigenen Zugangsschlüssel (API-Key).
• Marke (Brand) ist die juristische Person, in deren Namen Nachrichten verschickt werden, zum Beispiel „Acme GmbH". Jeder Mandant startet mit einer Marke bei Google. Wer mehrere Endkunden betreut (Reseller, Plattformen), kann weitere Marken anlegen.
• Agent ist das Absenderprofil, das Empfänger in ihrer Nachrichten-App sehen: Name, Logo, Titelbild, Farbe, Kontaktdaten und rechtliche Links. Agents gehören immer zu genau einer Marke.

Was ein Mandant sieht, ist auf seine eigenen Marken und Agents begrenzt. Agents anderer Mandanten sind nicht sichtbar, auch nicht versehentlich: Ein Zugriff auf fremde Daten wird so beantwortet, als gäbe es sie nicht.

Zugang und Schlüssel

Jeder Mandant erhält vom Betreiber einen eindeutigen Zugangsschlüssel. Mit ihm weist sich Ihr System bei jeder Anfrage aus. Ohne gültigen Schlüssel beantwortet die Box keine Anfrage; ist ein Mandant deaktiviert, wird der Zugang ebenfalls verweigert.

Achtung: Behandeln Sie den Zugangsschlüssel wie ein Passwort. Er gehört nicht in Webseiten, Apps auf Endgeräten oder öffentliche Code-Ablagen. Sollte er bekannt geworden sein, lassen Sie ihn über den Betreiber neu erzeugen; der alte Schlüssel ist danach ungültig.

Ihre Entwicklerinnen und Entwickler können jederzeit prüfen, ob die Box erreichbar ist und ob der Schlüssel noch gilt. Dieselbe Abfrage zeigt auch die aktuell laufende Version der Schnittstelle und, falls Ihr Mandant vom Betreiber gesperrt wurde, den Grund dafür (siehe Kapitel 4).

Was die Box zusätzlich erledigt

Einige Aufgaben übernimmt die Box automatisch, ohne dass Ihr System etwas tun muss:

• Länderfreigabe. Jeder Mandant hat eine Liste erlaubter Länder; Standard ist Deutschland. Nummern außerhalb dieser Liste werden gar nicht erst an Google weitergegeben. Österreich und die Schweiz kann der Betreiber auf Wunsch freischalten.
• Abmeldungen. Antwortet ein Empfänger mit STOP oder einem gleichwertigen Wort, trägt die Box die Nummer sofort in die Sperrliste des Agents ein. Weitere Nachrichten an diese Nummer werden abgewiesen, bis der Empfänger sich mit START wieder anmeldet. Die Einzelheiten stehen in Kapitel 4.
• Rückkanal. Antworten, Zustell- und Lesebestätigungen leitet die Box an eine von Ihnen benannte Adresse in Ihrem System weiter, signiert und bei Störungen mit Wiederholung (Kapitel 5).

Wo was zu finden ist

Technisch nachlesen

• Health: Erreichbarkeit und Gültigkeit des Schlüssels prüfen
• Brands: Marken anlegen und einsehen
• Agents: Agents und ihre Status