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 schreibt. Dadurch wird der RBM-Erfahrung ein menschliches Element hinzugefügt. 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 |
„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ürde der Wert beispielsweise phone/+12223334444 lauten und der resultierende Endpunkt wäre https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Abfrageparameter
| Parameter | |
|---|---|
eventId |
Die vom Agent zugewiesene ID des Ereignisses. Dabei muss es sich um eine UUID gemäß https://tools.ietf.org/html/rfc4122 handeln. Auf der RBM-Plattform werden alle Agent-Nachrichten ignoriert, die mit einer ID gesendet wurden, die von einer früheren Nachricht oder einem früheren Ereignis vom selben Agent gesendet wurde. |
agentId |
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 in der Übersicht über OAuth 2.0.