Wysyła do użytkownika wiadomość od agenta.
Aby agent mógł wysłać wiadomość, użytkownik musi mieć włączony protokół RCS i mieć do niego dostęp przez platformę RBM. Jeśli wiadomość zostanie wysłana, połączenie zostanie zwrócone bez błędów. W przeciwnym razie agent otrzyma kod błędu.
Jeśli użytkownik jest online, platforma RBM od razu dostarcza wiadomość. W przeciwnym razie platforma RBM umieszcza wiadomość w kolejce i dostarcza ją, gdy użytkownik znów będzie online.
Platforma RBM ignoruje wszystkie komunikaty agenta wysłane z identyfikatorem, który był używany przez wcześniejszą wiadomość lub zdarzenie wysłane przez tego samego agenta.
Wiadomości agenta można anulować między godziną wysłania 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 |
„phones/{E.164}”, gdzie {E.164} to numer telefonu użytkownika w formacie E.164. Jeśli np. numer telefonu w Stanach Zjednoczonych to +1-222-333-4444, wartość będzie miała postać passwords/+12223334444, a powstały punkt końcowy – https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Parametry zapytania
| Parametry | |
|---|---|
messageId |
Unikalny identyfikator wiadomości przypisany przez agenta. Musi to być identyfikator UUID zgodny z definicją podaną w artykule https://tools.ietf.org/html/rfc4122. Platforma RBM ignoruje wszystkie komunikaty agenta wysłane z identyfikatorem, który był używany przez wcześniejszą wiadomość lub zdarzenie wysłane przez tego samego agenta. |
agentId |
To pole jest 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 artykule Omówienie protokołu OAuth 2.0.