Method: phones.agentEvents.create

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

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 wäre der Wert beispielsweise „phones/+12223334444“ und der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents.

Suchparameter

Parameter
eventId

string

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

string

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.