Ersten Agent erstellen

Agent Eine programmatische Entität, die im Namen einer Marke Nachrichten an Nutzer sendet. Der Agent umfasst jede Benutzeroberfläche, mit der Nutzer interagieren, sowie den Code oder die Infrastruktur, die für die Interaktion erforderlich ist. Bots können eine einfache Einweg-Kommunikation bieten, z. B. das Senden einer Benachrichtigung, oder sie können konversationell sein und in einem Dialog auf die Antworten der Nutzer reagieren.

Nutzer interagieren mit Kundenservicemitarbeitern über eine RCS-kompatible Messaging-App wie Google Messages auf ihren Geräten. In dieser Kurzanleitung erstellen Sie einen einfachen RBM-Agenten, der eine einfache Nachricht an ein Testgerät senden und eine Antwort empfangen kann.

Vorbereitung

Bevor Sie mit dem Agenten beginnen, benötigen Sie Folgendes:

• Der Name der Marke, die Ihr Agent vertreten wird
• Deinem Kundenservicemitarbeiter
  • Name
  • Region, in der der Kundenservicemitarbeiter tätig sein wird
  • Abrechnungskategorie
  • Anwendungsbeispiel
• Ein Android-Gerät mit einer aktiven Telefonnummer
• Einen Entwicklungscomputer, auf dem Beispielcode ausgeführt werden kann

Testgerät einrichten

Damit eine Kommunikation mit einem noch nicht gestarteten RBM-Agenten möglich ist, muss ein Testgerät RCS-fähig sein. Nicht alle Android-Geräte können standardmäßig RCS-Nachrichten empfangen. Sie können den RCS-Status Ihres Geräts prüfen und ggf. RCS aktivieren, indem Sie Ihr Gerät mit Vorabversionen der Messages App und der Carrier Services App konfigurieren.

RCS-Status Ihres Geräts prüfen

1. Tippen Sie in der Messages App auf die Schaltfläche  und dann auf Einstellungen.

2. Tippen Sie auf Chatfunktionen und suchen Sie den Wert Status.

   Wenn Status Verbunden lautet, ist RCS auf Ihrem Gerät aktiv.

Nächste Schritte

Wenn RCS auf Ihrem Gerät aktiv ist, können Sie Ihren Kundenservicemitarbeiter einrichten. Wenn RCS auf Ihrem Gerät inaktiv ist, müssen Sie RCS auf Ihrem Gerät aktivieren, bevor Sie Ihren RBM-Agenten testen können.

Agent einrichten

RBM-Agents verwenden die RBM API, um Nachrichten, Ereignisse und andere Anfragen an Nutzer zu senden. Wenn Sie einen Agent erstellen, aktivieren Sie den Zugriff auf die RBM API und definieren die allgemeinen Informationen des Agents.

Region des Kundenservicemitarbeiters ermitteln

Die RBM API unterstützt drei regionale Endpunkte, damit Unternehmen regionale und geschäftliche Anforderungen erfüllen können. RBM-Kundenservicemitarbeiter können sich in einer von drei Regionen befinden:

• Nordamerika
• Europa
• Asiatisch-pazifischer Raum

Wählen Sie beim Erstellen des Kundenservicemitarbeiters die Region anhand der anwendbaren Verordnungen, Anforderungen und der Nähe der Endnutzer aus. Die Region ist nicht länderspezifisch. Sie gibt den Bereich an, in dem Ihr Kundenservicemitarbeiter tätig ist. Google verwendet diese Informationen, um zu bestimmen, wo Nachrichtendaten gespeichert und wie Nachrichtenverkehr entsprechend weitergeleitet werden soll.

Hinweis: Nachdem Sie den Kundenservicemitarbeiter erstellt haben, können Sie die Region nicht mehr ändern.

Abrechnungskategorie des Kundenservicemitarbeiters ermitteln

Mobilfunkanbieter, die RBM-Inhalte in ihren Netzwerken genehmigen, berechnen die Zustellung von RBM-Mitteilungen an ihre Abonnenten auch mit diesem Abrechnungssystem:

• Unterhaltung: Eine Gebühr für eine Unterhaltung, die aus mehreren A2P- und P2A-Nachrichten innerhalb eines bestimmten Zeitraums besteht.
• Einzelne Nachricht: Eine Gebühr für eine einzelne Nachricht mit Rich-Text-Inhalten (z. B. eine Nachricht mit einer Rich Card oder einem Karussell).
• SMS: Eine SMS mit bis zu 160 Zeichen.

Wählen Sie beim Erstellen des Kundenservicemitarbeiters die Abrechnungskategorie aus, die dem Verhalten Ihrer Kundenservicemitarbeiter-Logik am ehesten entspricht:

• Konversationell: Dieser Agent führt komplexe Nutzerinteraktionen aus, bei denen Nachrichten in beide Richtungen ausgetauscht werden.

Für die folgenden beiden Kategorien werden nie Abrechnungsereignisse für Unterhaltungen erstellt. Je nach Inhalt der gesendeten Nachricht berechnen Mobilfunkanbieter für jede Nachricht den Preis für eine einfache Nachricht oder eine Basisnachricht.

• Einzelne Nachricht: Dieser Bot sendet in der Regel umfangreiche Nachrichten und erwartet selten Antworten.
• Einfache Nachricht: Dieser Agent implementiert die Umstellung von SMS auf RBM und erwartet nur selten Antworten. Im Allgemeinen werden vom Kundenservicemitarbeiter nur SMS mit bis zu 160 Zeichen gesendet. Der Bot ist jedoch nicht eingeschränkt. Er kann umfangreichere Inhalte senden, wenn er entsprechend programmiert ist, und wird entsprechend abgerechnet.

Sie können die Abrechnungskategorie Ihres Kundenservicemitarbeiters ändern, bevor Sie ihn starten. Wenden Sie sich an uns, um eine andere Abrechnungskategorie zu wählen.

Anwendungsfall des Kundenservicemitarbeiters ermitteln

Jeder RBM-Kundenservicemitarbeiter muss einen vordefinierten Anwendungsfall haben, der die Art der Unterhaltungen widerspiegelt, die mit Endnutzern geführt werden sollen, und Unternehmen dabei helfen soll, Geschäftsregeln einzuhalten. RBM unterstützt vier Anwendungsfälle:

• OTP Einmalpasswörter, die zur sicheren Authentifizierung eines Kontos oder zur Bestätigung einer Transaktion erforderlich sind
• Transaktionsbezogen: Benachrichtigungen, Updates oder Warnungen, die Informationen enthalten, die direkt für die bestehenden Dienstleistungen oder Produkte eines Kunden relevant sind, z. B. Warnungen zu verdächtigen Kontoaktivitäten, Kaufbestätigungen und Versandbenachrichtigungen.
• Werbebotschaften: Angebote, Marketing- und Werbebotschaften an neue oder bestehende Kunden, mit dem Ziel, die Bekanntheit, Interaktionen und den Umsatz zu steigern.
• Mehrfachnutzung: Konversationsabläufe, die Transaktions- und Werbeanwendungsfälle kombinieren, z. B. das Senden einer Kontobenachrichtigung und dann ein Rabatt- oder Upgradeangebot für ein neues Produkt und einen neuen Dienst.

Eine ausführlichere Beschreibung dazu, wann Sie welchen Anwendungsfall verwenden sollten, finden Sie unter Den richtigen Anwendungsfall auswählen.

Sie können den Anwendungsfall nicht mehr ändern, nachdem Ihr Agent zur Einführung eingereicht wurde. Lesen Sie sich die Anwendungsfälle und Geschäftsregeln für Ihr Land durch, bevor Sie Ihren Bot einreichen.

Agent erstellen

Folgen Sie dieser Anleitung, um einen Kundenservicemitarbeiter in der Entwicklerkonsole für Business Communications zu erstellen.

Hinweis: Informationen zum Erstellen eines Kundenservicemitarbeiters mit der RBM Management API finden Sie in der Dokumentation zum Verwalten von Kundenservicemitarbeitern.

1. Öffnen Sie die Business Communications Developer Console und melden Sie sich mit dem Google-Konto Ihres RBM-Partners an.
2. Klicken Sie auf Agent erstellen.
3. Wählen Sie als Kundenservicemitarbeitertyp RCS Business Messaging aus.
4. Wählen Sie unter Marke die Marke aus, die Ihr Kundenservicemitarbeiter vertreten soll, oder klicken Sie auf Neue Marke hinzufügen und geben Sie den Namen ein.
5. Geben Sie den Namen des Kundenservicemitarbeiters ein und wählen Sie die Region, die Abrechnungskategorie und den Anwendungsfall aus. Klicken Sie dann auf Kundenservicemitarbeiter erstellen.
6. Wenn Ihr Kundenservicemitarbeiter verfügbar ist, klicken Sie auf seinen Namen.

Sobald Ihr Agent verfügbar ist, können Sie Informationen zum Unternehmen und zum Branding hinzufügen. Weitere Informationen finden Sie unter Kundenservicemitarbeiter.

Testgerät einladen

Sie haben jetzt einen Agenten und Ihr Testgerät unterstützt RCS. Sie können Ihr Gerät einladen, Ihren Agenten zu testen.

1. Klicken Sie in der linken Navigationsleiste auf Geräte.
2. Geben Sie unter Testgeräte hinzufügen die Telefonnummer Ihres Geräts ein und klicken Sie auf Hinzufügen.
3. Akzeptieren Sie auf Ihrem Testgerät die Testeranfrage für Ihren Agenten.

Wenn Sie auf Ihrem Testgerät keine Einladung erhalten, prüfen Sie, ob RCS auf Ihrem Gerät aktiviert ist.

Nachricht senden

Mit einem registrierten Testgerät kann Ihr Agent jetzt Nachrichten senden.

Sie benötigen einen Dienstkontoschlüssel, um API-Aufrufe sicher zu authentifizieren. Wenn du noch keinen Dienstkontoschlüssel für dein Partnerkonto erstellt hast, solltest du das jetzt nachholen.

Führen Sie in einem Terminal auf Ihrem Entwicklungscomputer den folgenden Befehl aus:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

• Ersetzen Sie REGION durch asia, europe oder us, je nachdem, in welcher Region sich Ihr Agent befindet.
• Ersetzen Sie PHONE_NUMBER durch die Telefonnummer Ihres Testgeräts. Geben Sie die Landesvorwahl, die Ortsvorwahl und ein vorangestelltes + an, aber keine Trennzeichen. Beispiel: [phone]
• Ersetzen Sie AGENT ID durch Ihre Kundenservicemitarbeiter-ID, die Sie in der Business Communications Developer Console auf der Seite Kundenservicemitarbeiter-Informationen finden.
• Ersetzen Sie PATH_TO_SERVICE_ACCOUNT_KEY durch den Pfad zum Schlüssel, den Sie zuvor erstellt haben.

Sie sollten auf Ihrem Testgerät die Nachricht „Hello World!“ von Ihrem Agenten erhalten. Wenn Sie auf Ihrem Testgerät keine Nachricht erhalten, prüfen Sie, ob Sie die Telefonnummer und den Pfad zum Schlüssel Ihres Dienstkontos im Befehl korrekt eingegeben und formatiert haben.

Informationen zum Senden verschiedener Nachrichtentypen, z. B. vorgeschlagener Antworten und Rich Cards, finden Sie unter Nachrichten senden.

Nächste Schritte

Jetzt, da Ihr Agent Nachrichten an ein Testgerät senden kann, ist es an der Zeit, etwas zu entwickeln, das Ihren Geschäftsanforderungen entspricht. Lade dir einen Beispiel-Agenten in deiner bevorzugten Sprache herunter und folge der Anleitung im README-Dokument.

Nachdem Sie den Beispiel-Kundenservicemitarbeiter konfiguriert haben, können Sie sich die Best Practices für RBM ansehen und erfahren, wie Kundenservicemitarbeiter Nachrichten senden und empfangen.