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 erhalten kann.

Vorbereitung

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

• Der Name der Marke, die Ihr Agent vertreten wird
• Deinem Agenten
  • 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 RCS bei Bedarf 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 grundlegenden Informationen des Agents.

Region des Kundenservicemitarbeiters ermitteln

RBM-Kundenservicemitarbeiter können in einer von drei Regionen tätig sein: Nordamerika, Europa und Asien-Pazifik. Die RBM API unterstützt drei regionale Endpunkte, damit Unternehmen regionale und geschäftliche Anforderungen erfüllen können.

Wählen Sie beim Erstellen des Agents die Region anhand der anwendbaren Verordnungen, Anforderungen und der Nähe der Endnutzer aus. Diese Region bestimmt, von wo aus Ihr Agent arbeitet und wo er seine Daten speichert.

Wenn Sie oder Ihre Zielgruppe nicht zu diesen Regionen gehören, wählen Sie die Region aus, die Ihnen am nächsten liegt, um die Latenz zu minimieren. Beispiel:

• Wenn Sie sich in Lateinamerika befinden, wählen Sie die Region „Nordamerika“ aus.
• Wenn Sie sich in Afrika befinden, wählen Sie die Region „Europa“ aus.
• Wenn Sie sich in Australien befinden, wählen Sie den asiatisch-pazifischen Raum aus.

Legen Sie die Region des Kundenservicemitarbeiters nicht anhand Ihrer Zielanbieter fest. Alle Regionen haben den gleichen Zugang zu Mobilfunkanbietern weltweit.

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

Abrechnungskategorie des Kundenservicemitarbeiters ermitteln

Wenn Sie einen RBM-Agenten erstellen, müssen Sie die Abrechnungskategorie angeben, je nachdem, wie der Agent mit Nutzern interagiert. Wählen Sie die Kategorie aus, die am ehesten dem beabsichtigten Verhalten Ihres Kundenservicemitarbeiters entspricht:

• Konversationsmodus: Für Kundenservicemitarbeiter, die mit Nutzern mehrstufige Unterhaltungen führen.
• Einfache Nachricht oder einzelne Nachricht: Für Kundenservicemitarbeiter, die Nachrichten senden, ohne häufige Antworten zu erwarten.

Hinweis :Die beiden Kategorien für die Abrechnung nicht konversationeller Nachrichten, „Grundlegende Nachricht“ und „Einzelne Nachricht“, funktionieren genau gleich. Das ist eine historische Besonderheit, die wir vereinfachen möchten. Sie können derzeit beide Kategorien für Ihre nicht kontextbezogenen Nachrichten verwenden, unabhängig davon, ob es sich um Nur-Text-Nachrichten oder Rich Cards handelt. Ihnen wird der Standardpreis für nicht konversationelle Nutzung in Rechnung gestellt. Weitere Informationen finden Sie unter Abrechnungskategorien für Kundenservicemitarbeiter.

Sie können die Abrechnungskategorie Ihres Kundenservicemitarbeiters nur vor der Einführung ändern. Wenn Sie die Abrechnungskategorie nach der Einführung ändern möchten, senden Sie eine E-Mail an [e-mail].

Weitere Informationen zum Abrechnungsmodell für die datengetriebene Anzeigenbereitstellung finden Sie in den häufig gestellten Fragen zur Abrechnung für die datengetriebene Anzeigenbereitstellung.

Anwendungsfall des Kundenservicemitarbeiters ermitteln

Jeder RBM-Kundenservicemitarbeiter muss einen vordefinierten Anwendungsfall haben. So können Sie Ihren Kundenservicemitarbeiter kategorisieren und die richtigen Geschäftsregeln anwenden, um die Nutzerfreundlichkeit zu verbessern. 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, Interaktion und den Umsatz zu steigern.
• Mehrfachnutzung: Unterhaltungen, in denen Transaktions- und Werbenachrichten kombiniert werden, z. B. das Senden einer Kontobenachrichtigung gefolgt von einem Rabattangebot oder einem Upgrade auf ein neues Produkt oder eine neue Dienstleistung.

Für jeden Anwendungsfall gelten unterschiedliche Regeln für das, was gesendet werden kann. Weitere Informationen zu den einzelnen Anwendungsfällen und zur Auswahl des am besten geeigneten Anwendungsfalls für Ihren Kundenservicemitarbeiter finden Sie unter Den richtigen Anwendungsfall für Ihren Kundenservicemitarbeiter auswählen.

Nachdem Sie Ihren Bot zur Veröffentlichung eingereicht haben, können Sie den Anwendungsfall nicht mehr ändern. Informieren Sie sich über die Anwendungsfälle und Geschäftsregeln Ihres Landes, 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.

So erstellen Sie einen Agent:

1. Rufen Sie die Business Communications Developer Console auf und melden Sie sich mit dem Google-Konto Ihres RBM-Partners an.
2. Klicken Sie auf der Startseite auf + Kundenservicemitarbeiter erstellen.
3. Geben Sie im Fenster Neuer RCS Business Messaging-Agent die folgenden Informationen an:
   • Marke, die Ihr Agent repräsentiert
   • Agent-Name
   • Hosting-Region
   • Abrechnungskategorie
   • Anwendungsbeispiel
4. Klicken Sie auf Agent erstellen.

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

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.