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ą usługę RCS i być dostępny dla platformy RBM. W przeciwnym razie agent otrzyma kod błędu 404.

Jeśli użytkownik jest online, platforma RBM dostarcza wiadomość od razu. W przeciwnym razie platforma RBM umieszcza wiadomość w kolejce i wysyła ją, gdy użytkownik następnym razem zaloguje się na konto.

Platforma RBM ignoruje wszystkie wiadomości od agenta wysłane z identyfikatorem, który został użyty w poprzedniej wiadomości lub zdarzeniu wysłanym przez tego samego agenta.

Wiadomości od agenta można wycofać w okresie od momentu ich wysłania do momentu ich dostarczenia.

Żą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 wynosić phones/+12223334444, a wynikający z tego punkt końcowy będzie miał postać https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages.

Parametry zapytania

Parametry
messageId

string

Wymagany. Unikalny identyfikator wiadomości przypisany przez pracownika obsługi klienta. Musi to być identyfikator UUID zdefiniowany w dokumencie https://tools.ietf.org/html/rfc4122. Platforma RBM ignoruje wszystkie wiadomości od agenta wysłane z identyfikatorem, który został użyty w poprzedniej wiadomości lub zdarzeniu wysłanym przez tego samego agenta.

agentId

string

Wymagany. Unikalny identyfikator agenta.

Treść żądania

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

Treść odpowiedzi

Jeśli operacja się powiedzie, 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 OAuth 2.0 Overview.