Method: phones.testers.create

Lädt einen Nutzer zum Testen eines Agents ein.

Der eingeladene Nutzer muss RCS-fähig und über die RBM-Plattform erreichbar sein. Wenn ein Agent einen Nutzer einlädt, Tester zu werden, sendet ein Agent der RBM-Plattformverwaltung eine Nachricht an den Nutzer, in der er um Bestätigung bittet, dass er Tester des Agents sein möchte. Sobald der Nutzer dies bestätigt hat, wird sie Tester.

Ein noch nicht gestarteter Agent kann nur mit Nutzern interagieren, die diesen Agent testen. Wenn ein nicht gestarteter Agent versucht, einen Nachrichten-, Ereignis- oder Funktionsrückruf an einen Nicht-Tester zu senden, gibt die RBM-Plattform den Fehler 403 PERMISSION_DENIED zurück.

Ein Agent kann pro Tag 20 Testeranfragen mit insgesamt maximal 200 Testeranfragen senden. Wenn du Testeranfragen über diese Limits hinaus sendest, gibt die RBM-Plattform eine 429 RESOURCE_EXHAUSTED-Antwort zurück.

HTTP-Anfrage

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

„phones/{E.164}“, wobei {E.164} die Telefonnummer des Nutzers im E.164-Format ist. Bei der US-Telefonnummer +1-222-333-4444 wäre der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/.

Abfrageparameter

Parameter
agentId

string

Erforderlich. Die eindeutige Kennung des Agents.

Anfragetext

Der Anfragetext enthält eine Instanz von Tester.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Tester.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.