Sendet ein Ereignis vom Agent an einen Nutzer.
Agentenereignisse können verwendet werden, um anzuzeigen, dass der Agent eine Nachricht vom Nutzer gelesen hat oder gerade eine Nachricht eingibt. Das verleiht der RCS for Business-Nutzung eine menschliche Note. Wenn der Nutzer RCS nicht aktiviert hat, gibt die RCS for Business-Plattform den Fehler NOT_FOUND (HTTP 404) zurück. Wenn der Nutzer RCS aktiviert hat, aber momentan 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 flüchtig und werden nicht in die Warteschlange gestellt.
Im Gegensatz zu Agentennachrichten können Agentenereignisse 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-amerikanischen 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 unter https://www.rfc-editor.org/info/rfc9562 definiert. Die RCS for Business-Plattform ignoriert alle Agentennachrichten, die mit einer ID gesendet werden, die bereits für eine frühere Nachricht oder ein früheres Ereignis desselben Agenten verwendet wurde. |
agentId |
Erforderlich. Die eindeutige Kennung des KI-Agenten. |
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.