Method: phones.agentMessages.create

Hiermit wird eine Nachricht vom Kundenservicemitarbeiter an einen Nutzer gesendet.

Der Nutzer muss RCS-fähig sein und von der RBM-Plattform erreichbar sein, damit der Kundenservicemitarbeiter eine Nachricht senden kann. Andernfalls erhält der Kundenservicemitarbeiter den Fehlercode 404.

Wenn der Nutzer online ist, sendet die RBM-Plattform die Nachricht sofort. Andernfalls stellt die RBM-Plattform die Nachricht in die Warteschlange und sendet sie, sobald der Nutzer das nächste Mal online ist.

Die RBM-Plattform ignoriert alle Agentennachrichten, die mit einer ID gesendet wurden, die bereits für eine frühere Nachricht oder ein früheres Ereignis vom selben Agenten verwendet wurde.

Nachrichten von Kundenservicemitarbeitern können zwischen dem Senden und dem Empfang widerrufen werden.

HTTP-Anfrage

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages

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. Bei der US-amerikanischen Telefonnummer +1-222-333-4444 wäre der Wert „phones/+12223334444“ und der resultierende Endpunkt https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages.

Abfrageparameter

Parameter
messageId

string

Erforderlich. Die vom Kundenservicemitarbeiter zugewiesene eindeutige ID der Nachricht. Dies muss eine UUID sein, wie unter https://tools.ietf.org/html/rfc4122 definiert. Die RBM-Plattform ignoriert alle Agentennachrichten, die mit einer ID gesendet wurden, die bereits für eine frühere Nachricht oder ein früheres Ereignis vom selben Agenten verwendet wurde.

agentId

string

Erforderlich. Die eindeutige Kennung des Kundenservicemitarbeiters.

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.