Method: phones.agentEvents.create

Sendet ein Ereignis vom Agent an einen Nutzer.

Agent-Ereignisse können verwendet werden, um anzuzeigen, dass der Agent eine Nachricht des Nutzers gelesen hat oder dass er gerade tippt (wodurch eine menschliche Komponente zur RBM-Erfahrung hinzugefügt wird). Wenn RBM den Nutzer nicht erreichen kann, gibt die RBM-Plattform 404 NOT_FOUND zurück.

Im Gegensatz zu Agent-Nachrichten können Agent-Ereignisse nach dem Senden nicht widerrufen werden.

HTTP-Anfrage

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

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. Für einen Nutzer mit der US-amerikanischen Telefonnummer +1-222-333-4444 lautet der Wert beispielsweise „phones/+12223334444“ und der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents.

Abfrageparameter

Parameter
eventId

string

Die ID des Ereignisses, die vom Kundenservicemitarbeiter zugewiesen wurde. Es muss eine UUID gemäß der Definition in https://tools.ietf.org/html/rfc4122 sein. Die RBM-Plattform ignoriert alle Nachrichten an Kundenservicemitarbeiter, die mit einer ID gesendet wurden, die von einer früheren Nachricht oder einem früheren Ereignis verwendet wurde, das von demselben Agent gesendet wurde.

agentId

string

Erforderlich. Die eindeutige Kennung des Agents.

Anfragetext

Der Anfragetext enthält eine Instanz von AgentEvent.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.