Updates: In den Versionshinweisen finden Sie Informationen zu neuen Funktionen und Produktupdates.

Diese Seite wurde von der Cloud Translation API übersetzt.

Testgerät einrichten

Bis Sie Ihren Agent einführen, kann er nur mit festgelegten Testgeräten kommunizieren. So können Sie Ihren Agenten intern testen, um einen versehentlichen frühen Zugriff durch Endnutzer zu verhindern.

Damit ein Testgerät mit einem RBM-Agent kommunizieren kann, muss es RCS-fähig sein. Hinweis: Auf einigen Android-Geräten ist RCS nicht standardmäßig aktiviert. Hier erfahren Sie, wie Sie den RCS-Status Ihres Geräts prüfen.

Kundenservicemitarbeiter können maximal 20 Einladungen pro Tag und insgesamt maximal 200 Einladungen senden.

RCS-Status Ihres Geräts prüfen

Rufen Sie in der Nachrichten App die Nachrichteneinstellungen auf.
Tippen Sie auf RCS-Chats. Wenn Sie „RCS-Chats“ nicht finden, tippen Sie auf Chatfunktionen.
Suchen Sie den Wert Status.

Wenn auf Ihrem Gerät RCS nicht aktiviert ist, aktivieren Sie RCS, indem Sie Ihr Gerät mit Vorabversionen der Messages App und der Carrier Services App konfigurieren.

Wenn auf Ihrem Gerät RCS aktiviert ist, können Sie eine Einladung zum Testen senden. Wenn das Gerät die Einladung annimmt, kann es mit Ihrem noch nicht eingeführten Agent kommunizieren.

RCS auf Ihrem Gerät aktivieren

Wenn Sie RCS auf einem Android-Gerät aktivieren möchten, aktivieren Sie RCS-Chats in der Messages App.

Wenn RCS auf Ihrem Gerät aktiv ist, können Sie eine Einladung zum Testen senden.

Testereinladung senden

Wenn Sie ein Gerät mit aktiviertem RCS-Protokoll als Tester einladen möchten, senden Sie eine Einladung an den Tester. Wenn das Gerät die Einladung annimmt, kann Ihr Agent Nachrichten, Ereignisse und Anfragen an das Gerät senden.

Wenn das Gerät nicht für RCS aktiviert ist, nicht auf die Einladung des Testers reagiert oder die Einladung ablehnt, erhält Ihr Agent einen 403 PERMISSION_DENIED-Fehler, wenn er versucht, mit dem Gerät zu kommunizieren.

Console

So senden Sie eine Einladung an Tester über die Business Communications Developer Console:

Öffnen Sie die Business Communications Developer Console, melden Sie sich mit Ihrem RBM-Google-Konto an und klicken Sie auf Ihren Agent.
Wählen Sie im Menü auf der linken Seite Geräte aus.
Fügen Sie der Liste der Testgeräte ein Testgerät hinzu, indem Sie die Telefonnummer des Geräts einschließlich Landes- und Ortsvorwahl eingeben. Wenn Sie mehrere Telefonnummern hinzufügen möchten, trennen Sie sie durch Kommas.

Wenn ein Gerät der Liste hinzugefügt wird, wird eine Einladung gesendet. Der Nutzer sieht die Einladung auf seinem Gerät und kann sie annehmen oder ablehnen.

In der Liste der Testgeräte wird der Einladungsstatus für Tester für jedes Gerät aufgeführt, das Sie zum Testen Ihres Agents einladen.

API

So senden Sie eine Einladung für Tester mit der RBM Management API:

Verwenden Sie den folgenden Code. Informationen zu Formatierungs- und Wertoptionen finden Sie unter testers.

cURL

curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});

Dieser Code ist ein Auszug aus einem RBM-Beispielagenten.

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Register the device as a tester
   rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}

Dieser Code ist ein Auszug aus einem RBM-Beispielagenten.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
rbm_service.invite_tester('+12223334444')

Dieser Code ist ein Auszug aus einem RBM-Beispielagenten.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Register the device as a tester
rbmApiHelper.RegisterTester("+12223334444");

Dieser Code ist ein Auszug aus einem RBM-Beispielagenten.

Wenn Sie mehr als 200 Einladungen senden, gibt die RBM-Plattform den Fehlercode 429 RESOURCE_EXHAUSTED zurück.

Testereinladung noch einmal senden

Bei Bedarf können Sie eine Einladung an Tester noch einmal senden. Das Ergebnis hängt vom aktuellen Einladungsstatus des Geräts ab.

Gerätestatus	Ergebnis
`PENDING`	Die Einladung für Tester wird an das Gerät gesendet.
`ACCEPTED`	Die Testereinladung wird nicht an das Gerät gesendet, das den Status `ACCEPTED` beibehält.
`DECLINED`	Die Einladung für Tester wurde abgelehnt. Sie müssen das Testgerät zuerst entfernen, bevor Sie eine neue Einladung senden können. Andernfalls schlägt die Anfrage fehl.

Nachdem das Gerät die Einladung des Testers angenommen hat, wird es zu einem festgelegten Testgerät für Ihren Agenten. Sie können Nachrichten, Ereignisse und Funktionsprüfungen an das Gerät senden, um die Funktionen und Arbeitsabläufe Ihres Agenten zu testen.

Einladungsstatus eines Testgeräts abrufen

Wenn Sie einen Tester einladen, kann er die Einladung auf seinem Gerät annehmen oder ablehnen. Sie können den Einladungsstatus des Geräts über die API abfragen.

Console

So rufen Sie den Einladungsstatus eines Testgeräts mit der Business Communications Developer Console ab:

Öffnen Sie die Business Communications Developer Console, melden Sie sich mit Ihrem RBM-Google-Konto an und klicken Sie auf Ihren Agent.
Wählen Sie im Menü auf der linken Seite Geräte aus.
Fügen Sie der Liste der Testgeräte ein Testgerät hinzu, indem Sie die Telefonnummer des Geräts einschließlich Landes- und Ortsvorwahl eingeben. Wenn Sie mehrere Telefonnummern hinzufügen möchten, trennen Sie sie durch Kommas.

Wenn ein Testgerät der Liste hinzugefügt wird, können Sie seinen Status in der Spalte Status prüfen.

API

So rufen Sie den Einladungsstatus eines Testgeräts mit der RBM Management API ab:

Verwenden Sie den folgenden Code. Informationen zu Formatierungs- und Wertoptionen finden Sie unter testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Status aller Testgeräte abrufen

Sie können den Einladungsstatus aller Geräte abfragen, die Sie als Tester eingeladen haben.

Console

So prüfen Sie den Einladungsstatus aller Testgeräte in der Business Communications Developer Console:

Öffnen Sie die Business Communications Developer Console, melden Sie sich mit Ihrem RBM-Google-Konto an und klicken Sie auf Ihren Agent.
Wählen Sie im Menü auf der linken Seite Geräte aus.
Fügen Sie der Liste der Testgeräte ein Testgerät hinzu, indem Sie die Telefonnummer des Geräts einschließlich Landes- und Ortsvorwahl eingeben. Wenn Sie mehrere Telefonnummern hinzufügen möchten, trennen Sie sie durch Kommas.

Wenn ein Testgerät der Liste hinzugefügt wird, können Sie den Status in der Spalte Status prüfen.

API

So prüfen Sie den Einladungsstatus aller Testgeräte mit der RBM Management API:

Verwenden Sie den folgenden Code. Informationen zu Formatierungs- und Wertoptionen finden Sie unter testers.

cURL

curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Testgerät entfernen

Wenn Sie ein Testgerät entfernen, kann es keine Nachrichten mehr von Ihrem noch nicht veröffentlichten Agenten empfangen. Auf der RBM-Plattform werden keine Nachrichten gelöscht, die von Ihrem Agent gesendet wurden und sich auf dem Weg zum Testgerät befinden oder auf dem Testgerät gespeichert sind.

Console

So entfernen Sie ein Testgerät mit der Business Communications Developer Console:

Öffnen Sie die Business Communications Developer Console, melden Sie sich mit Ihrem RBM-Google-Konto an und klicken Sie auf Ihren Agent.
Wählen Sie im Menü auf der linken Seite Geräte aus.
Wählen Sie das Gerät in der Liste der Testgeräte aus und klicken Sie auf das -Menü.
Klicken Sie auf Gerät entfernen.

API

So entfernen Sie ein Testgerät mit der RBM Management API:

Verwenden Sie den folgenden Code. Informationen zu Formatierungs- und Wertoptionen finden Sie unter testers.

cURL

curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"

Zurück

Agent-Informationen bearbeiten

Weiter

Deeplinks

Testgerät einrichten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

RCS-Status Ihres Geräts prüfen

RCS auf Ihrem Gerät aktivieren

Testereinladung senden

Console

API

cURL

Node.js

Java

Python

C#

Testereinladung noch einmal senden

Einladungsstatus eines Testgeräts abrufen

Console

API

cURL

Status aller Testgeräte abrufen

Console

API

cURL

Testgerät entfernen

Console

API

cURL

Testgerät einrichten