Method: phones.agentEvents.create

Sendet ein Ereignis vom Agent an einen Nutzer.

Mit Agent-Ereignissen kann angegeben werden, dass der Agent eine Nachricht vom Nutzer gelesen hat oder dass der Agent gerade tippt. So wird die Nutzung von RCS for Business persönlicher. Wenn der Nutzer über RCS for Business nicht erreicht werden kann, gibt die RCS for Business-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-Telefonnummer +1-222-333-4444 wäre 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. Dies muss eine UUID sein, wie in https://tools.ietf.org/html/rfc4122 definiert. Die RCS for Business-Plattform ignoriert alle Agent-Nachrichten, die mit einer ID gesendet werden, die bereits für eine frühere Nachricht oder ein früheres Ereignis desselben Agents verwendet wurde.

agentId

string

Erforderlich. Die eindeutige ID 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.