API v1.11.0

Kapitel 07 von 07

Glossar und FAQ

Glossar

Abmeldung (Opt-out) Antwort eines Empfängers mit STOP oder einem gleichwertigen Wort. Die Nummer kommt sofort auf die Sperrliste des Agents; Ihr System wird informiert und muss bestätigen (Kapitel 4).

Abrechnungskategorie Wird beim Anlegen eines Agents festgelegt und entscheidet zusammen mit der beim Anlegen gewählten Spur, ob er als „Konversation", „Newsletter" oder „Flex" (Abrechnung pro Nachricht) geführt wird (Kapitel 5).

Agent Das Absenderprofil, das Empfänger in ihrer Nachrichten-App sehen: Name, Logo, Titelbild, Farbe, Kontaktdaten, rechtliche Links. Gehört dauerhaft zu einer Marke.

Anmeldung (Opt-in) Einwilligung eines Empfängers, Nachrichten zu erhalten. Per Antwort START kann sie auch über RCS selbst erteilt oder erneuert werden. Der Nachweis der Einwilligung liegt bei Ihnen.

Archiviert Zustand eines Agents bei Google, der nicht mehr genutzt wird. Die Box übernimmt ihn beim Abgleich und zeigt solche Agents gesondert (Kapitel 2).

Autopilot Automatik der Box, die einen vorbereiteten Agent durch Verifizierung und Launch führt und ihn danach beobachtet (Kapitel 6).

Brand Authorization Letter Schreiben, mit dem Ihr Unternehmen bestätigt, dass der Betreiber in Ihrem Namen RCS-Nachrichten verschicken darf. Wird als Nachweisdokument der Marke bei Google eingereicht.

Erreichbarkeitsprüfung (Capability-Check) Abfrage, ob eine Nummer RCS empfangen kann und welche Funktionen das Gerät unterstützt. Ergebnis nicht aufheben (Kapitel 5).

Flex Tarif für Non-Conversational-Agents, bei dem jede versendete Nachricht gezählt wird. Keine MAU-Freigabe, keine tägliche Versandgrenze. Die Spur flex wählen Sie beim Anlegen des Agents oder, solange er ein Entwurf ist, nachträglich (Kapitel 5).

Fragebogen (Launch Questionnaire) Die Angaben zu Einsatzzweck, Einwilligung, Abmeldung, Auslösern und Prüferzugang, die mit dem Launch an die Netzbetreiber gehen (Kapitel 3).

Gespräch (Session) Zähleinheit für die Abrechnung: die erste Nachricht an eine Nummer plus alle weiteren Nachrichten, zwischen denen nicht mehr als 24 Stunden liegen (Kapitel 5).

Launch Freigabe eines Agents durch die einzelnen Netzbetreiber. Nach Zustimmung mindestens eines Netzbetreibers ist der Agent LAUNCHED (Kapitel 2).

Mandant (Tenant) Ihr Unternehmen als Kunde der RCS-Box, mit eigenem Zugangsschlüssel und eigener Länderliste, getrennt von allen anderen Kunden.

Marke (Brand) Die juristische Person, in deren Namen gesendet wird. Jeder Mandant hat mindestens eine; Agents liegen immer unter einer Marke.

MAU (monatlich aktive Nutzer) Abrechnungseinheit für Newsletter-Agents (Community-Tarif): Jede Nummer zählt pro Monat einmal, egal wie oft sie angeschrieben wird. Die dafür nötige MAU-Freigabe der deutschen Netzbetreiber wird nach dem Einreichen des Launchs per E-Mail angefragt, automatisch oder durch den Betreiber (Kapitel 2). Flex-Agents brauchen sie nicht.

Netzbetreiber (Carrier) Die Mobilfunkanbieter, die Nachrichten auf die Geräte ihrer Kundinnen und Kunden zustellen und jeden Agent vor dem Launch prüfen. Im Guide stets „die deutschen Netzbetreiber"; in der Referenz als Regionen mit eigener Kennung geführt.

RCS for Business Der Nachrichtenkanal von Google für Unternehmen in der Nachrichten-App von Android-Geräten; Nachfolger der SMS mit Bildern, Karten und Schaltflächen. Vertragspartner auf Google-Seite ist Google Ireland Ltd.

Rückkanal (Webhook) Die Adresse in Ihrem System, an die die Box Antworten, Bestätigungen und Statusmeldungen weiterleitet, signiert und mit Wiederholung (Kapitel 5).

Rückzug (Unlaunch) Zurückziehen eines eingereichten oder freigegebenen Agents; danach steht er wieder auf DRAFT (Kapitel 2).

Sperre Maßnahme des Betreibers, die einen Agent oder Mandanten in der Box anhält, ohne Google zu berühren (Kapitel 4).

Sperrliste (Blacklist) Liste der Nummern je Agent, die keine Nachrichten mehr erhalten: Abmeldungen durch Empfänger und Einträge des Betreibers.

Tester Eine Telefonnummer, die vor dem Launch Nachrichten eines Agents empfangen darf, nachdem die Person die Einladung von Google angenommen hat (ACCEPTED).

Verifizierung Prüfung durch Google, ob ein Agent rechtmäßig zu seiner Marke gehört. Erfolgt je Agent und ist Voraussetzung für den Launch (Kapitel 2).

Zeitplan Drei feste Schritte je Agent mit Terminen: Tester einladen, Verifizierung einreichen, Launch einreichen (Kapitel 6).

Zugangsschlüssel (API-Key) Das Geheimnis, mit dem sich Ihr System bei der Box ausweist. Wie ein Passwort behandeln (Kapitel 1).

FAQ

Ist RCS for Business Ende-zu-Ende-verschlüsselt?

Nein. Nachrichten zwischen Unternehmen und Empfängern sind auf allen Transportwegen verschlüsselt, zwischen Ihrem System, der Box, Google und den Netzbetreibern nach aktuellem Standard. Eine Ende-zu-Ende-Verschlüsselung, bei der nur Absender und Empfänger den Inhalt lesen könnten, gibt es im Unternehmensversand bei keinem Kanal, weil der Inhalt auf der Plattform verarbeitet werden muss, bei Google unter anderem für die Zustellung und den automatisierten Phishing-Schutz. RCS for Business ist damit so geeignet wie E-Mail oder SMS und deutlich besser geschützt als eine unverschlüsselte SMS.

Wie teste ich den Rückkanal, bevor mein System fertig ist?

Sie brauchen drei Dinge: eine öffentliche Adresse, die eingehende Anfragen anzeigt (etwa ein Dienst wie webhook.site), diese Adresse als Rückkanal Ihres Mandanten, eingetragen durch den Betreiber, und eine Testnummer, deren Einladung angenommen wurde. Senden Sie dann vom Testgerät an den Agent: „hallo" erzeugt eine normale Weiterleitung, STOP eine Weiterleitung mit der Kennzeichnung OPT_OUT, START eine mit OPT_IN, und „bitte stop damit" wieder eine normale Weiterleitung, weil nur das erste Wort zählt.

Beachten Sie, dass ein reiner Anzeigedienst die Ab- und Anmeldungen nicht bestätigt. Die Box versucht die Zustellung dann dreimal und vermerkt die fehlende Bestätigung. Die Sperrliste wird trotzdem korrekt geführt. Für einen vollständigen Test muss die Adresse die Bestätigung zurückgeben.

Warum bekommt eine Nummer nichts?

In dieser Reihenfolge prüfen: Ist der Agent LAUNCHED, oder ist die Nummer ein Tester mit angenommener Einladung? Liegt die Nummer in einem für Ihren Mandanten erlaubten Land? Steht sie auf der Sperrliste des Agents? Kann das Gerät überhaupt RCS empfangen (Erreichbarkeitsprüfung)? Ist der Agent oder Mandant vom Betreiber gesperrt? Die Antwort der Box auf einen Sendeversuch nennt den Grund.

Warum erzeugt eine Antwort keine Weiterleitung?

Vor dem Launch leitet Google nur Antworten von Testnummern mit angenommener Einladung weiter. Nach dem Launch: Prüfen Sie, ob der Mandant gesperrt ist, während einer Sperre werden keine Weiterleitungen zugestellt und auch nicht nachgeliefert.

Was tun bei einer Ablehnung des Launches?

Die Begründung steht je Netzbetreiber in der Launch-Übersicht des Agents und in der Statusmeldung an Ihr System. Häufige Gründe sind fehlende oder nicht erreichbare Bilder, ein unvollständiger Fragebogen oder ein unklarer Opt-in-Weg. Nachbessern und über den Betreiber oder den Autopiloten erneut einreichen.

Kann ich Name, Logo oder Titelbild nach dem Launch ändern?

Nur eingeschränkt. Nach Einreichung der Verifizierung kann Google Änderungen an Name, Logo und Titelbild ablehnen, und Endgeräte zeigen alte Bilder noch lange an. Liefern Sie von Anfang an die endgültige Fassung.

Kann ich einen Agent einer anderen Marke zuordnen?

Nein. Die Marke ist Teil des Namens, den der Agent bei Google trägt. Ein Agent unter der falschen Marke muss neu angelegt werden.

Mein Zugangsschlüssel ist bekannt geworden. Was nun?

Wenden Sie sich sofort an den Betreiber und lassen Sie den Schlüssel neu erzeugen. Der alte Schlüssel ist danach ungültig; Ihr System muss den neuen verwenden.

Was passiert, wenn sich die Schnittstelle ändert?

Die Schnittstelle trägt eine Versionsnummer nach dem Schema Hauptversion.Nebenversion.Korrektur. Neue Felder und neue Funktionen kommen als Nebenversion und sind abwärtskompatibel; Ihr System sollte unbekannte Felder und Meldungstypen ignorieren. Änderungen, die bestehende Felder entfernen oder umdeuten, kommen nur als neue Hauptversion und werden mindestens eine Nebenversion vorher angekündigt. Jede Änderung steht im Changelog. Die laufende Version zeigt die Statusabfrage der Box.

Wer ist auf Google-Seite mein Vertragspartner?

Google Ireland Ltd. mit Sitz in Dublin. Verarbeitung und Vertragsbeziehung bleiben damit innerhalb der EU.

Kann die Box gesperrte Nummern für mich löschen?

Ein Eintrag auf der Sperrliste verschwindet nur auf zwei Wegen: durch ein START des Empfängers oder durch den Betreiber. Das gilt für Abmeldungen durch Empfänger und für Einträge, die der Betreiber gesetzt hat. Ihr System kann Einträge nicht löschen. Das ist Absicht: Eine Abmeldung darf nie verloren gehen.

Technisch nachlesen

  • Testers: Testnummern und die Schritt-für-Schritt-Anleitung „How to test as a tenant"
  • Webhooks: Weiterleitungen, Signatur, Bestätigung
  • Health: Version der Schnittstelle und Sperrstatus
  • Agents: Status-Tabelle und Profilregeln
  • Messages: Fehlermeldungen beim Senden