Method: phones.agentMessages.create

Wysyła wiadomość od agenta do użytkownika.

Aby agent mógł wysłać wiadomość, użytkownik musi mieć włączoną obsługę RCS i być dostępny na platformie RCS Business Messaging. W przeciwnym razie agent otrzyma kod błędu 404.

Jeśli użytkownik jest online, platforma RCS Business Messaging natychmiast dostarcza wiadomość. W przeciwnym razie platforma RCS Business Messaging umieszcza wiadomość w kolejce i dostarcza ją, gdy użytkownik będzie ponownie online.

Platforma RCS Business Messaging ignoruje wszystkie wiadomości agenta wysłane z identyfikatorem, który został użyty w wcześniejszej wiadomości lub zdarzeniu wysłanym przez tego samego agenta.

Wiadomości agenta można cofnąć w okresie między wysłaniem a dostarczeniem.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

„phones/{E.164}”, gdzie {E.164} to numer telefonu użytkownika w formacie E.164. Na przykład w przypadku amerykańskiego numeru telefonu +1-222-333-4444 wartość będzie mieć postać phones/+12223334444, a wynikowy punkt końcowy będzie wyglądać tak: https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages.

Parametry zapytania

Parametry
messageId

string

Wymagane. Unikalny identyfikator wiadomości przypisany przez agenta. Musi to być identyfikator UUID zgodnie z definicją w dokumencie https://tools.ietf.org/html/rfc4122. Platforma RCS Business Messaging ignoruje wszystkie wiadomości agenta wysłane z identyfikatorem, który został użyty w wcześniejszej wiadomości lub zdarzeniu wysłanym przez tego samego agenta.
agentId

string

Wymagane. Unikalny identyfikator agenta.

Treść żądania

Treść żądania zawiera wystąpienie elementu AgentMessage.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję AgentMessage.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.