Testgeräte

Bis zur Aktivierung des Agents kann er nur mit festgelegten Testgeräten kommunizieren. Auf diese Weise können Sie Ihren Agent intern testen und gleichzeitig versehentlichen Zugriff auf Endnutzer verhindern.

Für die Kommunikation mit einem RBM-Agent muss ein Testgerät RCS-fähig sein. Auf einigen Android-Geräten ist RCS standardmäßig nicht aktiviert. Du kannst den RCS-Status deines Geräts prüfen und bei Bedarf RCS aktivieren. Dazu konfigurierst du dein Gerät mit Vorabversionen der Apps Messages und Carrier Services.

Wenn Ihr Gerät RCS-fähig ist, können Sie eine Tester-Anfrage senden, um das Gerät zum Testen des Agents einzuladen. Sobald das Gerät die Anfrage akzeptiert, kann es Nachrichten von deinem nicht unterstützten Agent empfangen und darauf antworten.

Ein Agent kann pro Tag maximal 20 Testeranfragen senden. Wenn Sie Tester über die RBM API hinzufügen und mehr als 200 Anfragen senden, gibt die RBM-Plattform eine 429 RESOURCE_EXHAUSTED-Antwort zurück.

RCS-Status Ihres Geräts prüfen

  1. Gehen Sie in der Messages App zu Nachrichteneinstellungen.
  2. Tippen Sie auf RCS-Chats. Wenn „RCS-Chats“ nicht angezeigt wird, tippen Sie auf Chatfunktionen.

  3. Suchen Sie den Wert Status.

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

Nächste Schritte

Wenn RCS auf Ihrem Gerät aktiv ist, können Sie eine Tester-Anfrage senden. Wenn RCS auf Ihrem Gerät inaktiv ist, müssen Sie RCS auf Ihrem Gerät aktivieren, bevor Sie damit beginnen können.

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.

Nächste Schritte

Wenn RCS auf Ihrem Gerät aktiv ist, können Sie eine Tester-Anfrage senden.

Testeranfrage senden

Wenn Sie ein RCS-fähiges Gerät als Tester einladen möchten, senden Sie eine Testeranfrage. Wenn das Gerät die Anfrage akzeptiert, kann Ihr Agent Nachrichten, Ereignisse und Anfragen an das Gerät senden.

Wenn das Gerät nicht RCS-fähig ist, nicht auf die Testeranfrage reagiert oder die Anfrage ablehnt, erhält der Agent einen 403 PERMISSION_DENIED-Fehler, wenn er versucht, mit dem Gerät zu kommunizieren.

Option 1: Testeranfrage mit der Business Communications Developer Console senden

  1. Öffnen Sie die Business Communications Developer Console, melden Sie sich mit Ihrem RBM-Google-Konto an und klicken Sie auf Ihren Agent.
  2. Klicken Sie in der linken Navigationsleiste auf Geräte.
  3. Geben Sie unter Testgeräte hinzufügen die Telefonnummer Ihres Geräts ein und klicken Sie auf Hinzufügen.

Die Liste der Testgeräte enthält den Status der Testeranfrage für jedes Gerät, das Sie zum Testen des Agents einladen.

Option 2: Testeranfrage mit der RBM API senden

Mit dem folgenden Code wird eine Testeranfrage gesendet. Informationen zu Formatierungs- und Wertoptionen finden Sie unter phones.testers.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('../libs/rbm_api_helper');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});
Dieser Code ist ein Auszug aus einem RBM-Beispiel-Agent.

Java

import com.google.rbm.samples.lib.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-Beispiel-Agent.

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-Beispiel-Agent.

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-Beispiel-Agent.

Nächste Schritte

Sobald das Gerät die Testeranfrage akzeptiert, ist es ein vorgesehenes Testgerät für Ihren Agent. Sie können Nachrichten, Ereignisse und Funktionsprüfungen an Ihr Gerät senden, um die Funktionalität und Workflows Ihres Agents zu testen.

Testgerät entfernen

Wenn Sie ein Testgerät entfernen, kann das Gerät keine Nachrichten mehr von Ihrem nicht aktivierten Agent empfangen. Die RBM-Plattform löscht keine Nachrichten Ihres Agents, die gerade an das Testgerät gesendet werden oder auf diesem gespeichert sind.

  1. Öffnen Sie die Business Communications Developer Console, melden Sie sich mit Ihrem RBM-Google-Konto an und klicken Sie auf Ihren Agent.
  2. Klicken Sie in der linken Navigationsleiste auf Geräte.
  3. Suchen Sie in der Testliste für Geräte nach dem Gerät und klicken Sie für dieses Listenelement auf das Menü .
  4. Klicken Sie auf Gerät entfernen.