Sendet eine Nachricht vom Agent an einen Nutzer.
Der Nutzer muss RCS-fähig und über die RBM-Plattform erreichbar sein, damit der Agent eine Nachricht senden kann. Wenn die Nachricht erfolgreich gesendet wurde, wird der Aufruf ohne Fehler zurückgegeben. Andernfalls erhält der Agent einen Fehlercode.
Wenn die Nutzenden online sind, übermittelt die RBM-Plattform die Nachricht sofort. Andernfalls stellt die RBM-Plattform die Nachricht in die Warteschlange und sendete sie, wenn der Nutzer das nächste Mal online ist.
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.
Agent-Nachrichten können zwischen dem Zeitpunkt des Sendens und dem Zeitpunkt ihrer Zustellung widerrufen werden.
HTTP-Anfrage
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
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. Bei der US-Telefonnummer +1-222-333-4444 würde der Wert beispielsweise phone/+12223334444 und der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages lauten. |
Abfrageparameter
| Parameter | |
|---|---|
messageId |
Die eindeutige ID der Nachricht, die vom Agent zugewiesen wurde. 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 AgentMessage.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von AgentMessage.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/rcsbusinessmessaging
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.