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 RCS für den Nutzer nicht aktiviert ist, gibt die RCS for Business-Plattform den Fehler NOT_FOUND (HTTP 404) zurück. Wenn der Nutzer RCS aktiviert hat, aber derzeit nicht erreichbar ist, gibt die Plattform eine 200 OK-Antwort zurück und verarbeitet die Zustellung basierend auf dem Ereignistyp. Agent-Ereignisse werden bis zu 30 Tage lang in einer Store-and-Forward-Warteschlange gespeichert und zugestellt, sobald der Nutzer wieder online ist. Nur IS_TYPING-Ereignisse sind kurzlebig und werden nicht in die Warteschlange gestellt.
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äre der Wert beispielsweise „phones/+12223334444“ und der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Suchparameter
| Parameter | |
|---|---|
eventId |
Die ID des Ereignisses, die vom Agent 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 |
Erforderlich. Die eindeutige ID des Agents. |
Anfragetext
Der Anfragetext enthält eine Instanz von AgentEvent.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, 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.