Ersten Agent erstellen

Agent Eine programmatische Einheit, die im Namen einer Marke Nachrichten an Nutzer sendet. Der Agent umfasst jede Schnittstelle, mit der Nutzer interagieren, sowie jeden Code oder jede Infrastruktur, die für die Interaktion erforderlich ist. Agents können eine einfache Einwegkommunikation ermöglichen, z. B. durch das Senden einer Benachrichtigung. Sie können aber auch dialogorientiert sein und in einem Hin-und-her-Austausch auf Nutzerantworten reagieren.

Nutzer interagieren über eine RCS-fähige Messaging-App wie Google Messages auf ihren Geräten mit Agents. In dieser Kurzanleitung erstellen Sie einen einfachen RCS for Business-Agent, der eine einfache Nachricht an ein Testgerät senden und eine Antwort empfangen kann.

Vorbereitung

Bevor Sie mit Ihrem Agent loslegen können, benötigen Sie Folgendes:

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

Testgerät einrichten

Um mit einem noch nicht eingeführten RCS for Business-Agent zu kommunizieren, 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 bei Bedarf 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. Tippe in der App „Nachrichten“ auf das -Symbol und dann auf Einstellungen.

2. Tippen Sie auf Chatfunktionen und suchen Sie nach dem Wert für Status.

   Wenn der 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 Agenten einrichten. Wenn RCS auf Ihrem Gerät inaktiv ist, müssen Sie RCS auf Ihrem Gerät aktivieren, bevor Sie Ihren RCS for Business-Agent testen können.

Agent einrichten

RCS for Business-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

RCS for Business-Kundenservicemitarbeiter können in einer von drei Regionen vorhanden 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 des Agents 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 vorgesehenen Nutzer nicht in diesen Regionen ansässig sind, wählen Sie die Region aus, die Ihnen am nächsten ist, 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 die Region „Asien-Pazifik“ aus.

Die Region des Agents darf nicht auf Grundlage Ihrer Ziel-Mobilfunkanbieter festgelegt werden. Alle Regionen haben den gleichen Zugriff auf Mobilfunkanbieter weltweit.

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

Abrechnungskategorie des Agenten ermitteln

Wenn Sie einen RCS for Business-Agent erstellen, müssen Sie die Abrechnungskategorie basierend darauf angeben, wie der Agent mit Nutzern interagiert. Wählen Sie die Kategorie aus, die dem beabsichtigten Verhalten Ihres Agenten am ehesten entspricht:

• Konversation: Für Agents, die mit Nutzern in Multi-Turn Conversations interagieren.
• Basic Message oder Single Message: Für Kundenservicemitarbeiter, die Nachrichten senden, ohne häufige Antworten zu erwarten.

Hinweis :Die beiden Abrechnungskategorien ohne Konversation, „Basic Message“ und „Single Message“, funktionieren genau gleich. Das ist ein historischer Sonderfall, den wir vereinfachen möchten. Sie können vorerst beide Kategorien für Ihre nicht konversationellen Nachrichten verwenden, unabhängig davon, ob es sich um Nur-Text-Nachrichten oder Rich Cards handelt. Ihnen wird der Standardtarif für nicht konversationelle Anfragen in Rechnung gestellt. Weitere Informationen finden Sie unter Abrechnungskategorien für Agents.

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

Weitere Informationen zum Standard-RCS- oder Business-Abrechnungsmodell finden Sie in den FAQs zur Abrechnung.

Anwendungsfall des Agenten ermitteln

Für jeden RCS for Business-Agent ist ein vordefinierter Anwendungsfall erforderlich. So kann Ihr Agent kategorisiert und die richtigen Geschäftsregeln angewendet werden, um eine gute Nutzererfahrung zu bieten. RCS for Business 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 sich direkt auf die bestehenden Dienste oder Produkte eines Kunden beziehen, z. B. Warnungen zu verdächtigen Kontoaktivitäten, Kaufbestätigungen und Versandbenachrichtigungen.
• Werbung: Verkaufs-, Marketing- und Werbebotschaften an neue oder bestehende Kunden mit dem Ziel, Bekanntheit, Interaktionen und Verkäufe zu steigern.
• Mehrzweck: Unterhaltungen, in denen Transaktions- und Werbenachrichten kombiniert werden, z. B. wenn eine Kontobenachrichtigung gefolgt von einem Rabattangebot oder einem Upgrade auf ein neues Produkt oder eine neue Dienstleistung gesendet wird.

Für jeden Anwendungsfall gelten unterschiedliche Regeln für das, was Sie senden können. Weitere Informationen zu den einzelnen Anwendungsfällen und zur Auswahl des besten Anwendungsfalls für Ihren Agent finden Sie unter Den richtigen Anwendungsfall für Ihren Agent auswählen.

Nachdem Sie Ihren Agent zur Veröffentlichung eingereicht haben, können Sie den Anwendungsfall nicht mehr ändern. Prüfen Sie vor dem Einreichen Ihres Agents die Anwendungsfälle und Geschäftsregeln Ihres Landes.

Agent erstellen

Folgen Sie dieser Anleitung, um Ihren Agent in der Business Communications Developer Console zu erstellen.

Hinweis :Informationen zum Erstellen eines Agents mit der RBM Management API finden Sie in der Dokumentation Agents verwalten.

So erstellen Sie einen Agent:

1. Rufen Sie die Business Communications Developer Console auf und melden Sie sich mit Ihrem Google-Konto als RCS for Business-Partner an.
2. Klicken Sie auf der Startseite auf + Agent erstellen.
3. Geben Sie im Fenster New RCS Business Messaging (Neues RCS Business Messaging) 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 zu Ihrem Unternehmen und Branding hinzufügen. Weitere Informationen finden Sie unter Agent erstellen.

Testgerät einladen

Nachdem Sie einen Agent haben und Ihr Testgerät RCS-fähig ist, können Sie Ihr Gerät einladen, Ihren Agent 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 Agent.

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 Sie noch keinen Dienstkontoschlüssel für Ihr Partnerkonto erstellt haben, sollten Sie das jetzt tun.

Führen Sie auf Ihrem Entwicklungscomputer in einem Terminal 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!"
  },
  "messageTrafficType": "PROMOTION"
}'

• Ersetzen Sie REGION durch asia, europe oder us, je nach Region Ihres Agents.
• Ersetzen Sie PHONE_NUMBER durch die Telefonnummer Ihres Testgeräts. Geben Sie die Landesvorwahl, die Ortsvorwahl und eine führende + an, aber keine Trennzeichen. Beispiel: [phone]
• Ersetzen Sie AGENT ID durch Ihre Agent-ID, die Sie in der Business Communications Developer Console auf der Seite Agent-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 eine Nachricht mit dem Text „Hello, world!“ von Ihrem Agent erhalten. Wenn Sie auf Ihrem Testgerät keine Nachricht erhalten, prüfen Sie, ob Sie die Telefonnummer und den Pfad zu Ihrem Dienstkontoschlüssel im Befehl richtig eingegeben und formatiert haben.

Informationen zum Senden verschiedener Nachrichtentypen wie Vorschläge für Antworten und interaktive Chat-Nachrichten finden Sie unter Nachrichten senden.

Nächste Schritte

Nachdem Ihr Agent Nachrichten an ein Testgerät senden kann, ist es an der Zeit, etwas zu entwickeln, das Ihren geschäftlichen Anforderungen entspricht. Beispiel-Agent in Ihrer bevorzugten Sprache abrufen und der Anleitung in der README-Datei des Beispiels folgen.

Nachdem Sie den Beispiel-Agent konfiguriert haben, lesen Sie die Best Practices für RCS for Business und erfahren Sie, wie Agents Nachrichten senden und empfangen.