Sendet eine Nachricht vom Agent an einen Nutzer.
Der Nutzer muss RCS-fähig und über die RCS for Business-Plattform erreichbar sein, damit der Agent eine Nachricht senden kann. Andernfalls erhält der Agent den Fehlercode 404.
Wenn der Nutzer online ist, wird die Nachricht sofort über die RCS for Business-Plattform zugestellt. Andernfalls wird die Nachricht auf der RCS for Business-Plattform in die Warteschlange gestellt und zugestellt, wenn der Nutzer das nächste Mal online ist.
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.
Agent-Nachrichten können zwischen dem Zeitpunkt des Sendens und dem Zeitpunkt der 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äre der Wert beispielsweise „phones/+12223334444“ und der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Abfrageparameter
| Parameter | |
|---|---|
messageId |
Erforderlich. Die eindeutige ID der Nachricht, die vom Agent zugewiesen wird. 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 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 unter OAuth 2.0 Overview.