Wysyła zdarzenie od agenta do użytkownika.
Zdarzenia agenta mogą służyć do wskazania, że agent odczytał wiadomość od użytkownika lub jest w trakcie pisania (co dodaje element do interfejsu RBM jako człowiek). Jeśli RBM nie może skontaktować się z użytkownikiem, platforma RBM zwraca wartość 404 NOT_FOUND
.
W przeciwieństwie do wiadomości agentów po wysłaniu zdarzenia nie można odwoływać.
Żądanie HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
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. W przypadku użytkownika z numerem telefonu w Stanach Zjednoczonych +1-222-333-4444 będzie to telefon/+12223334444, a wynikowy punkt końcowy będzie wyglądał tak: https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Parametry zapytania
Parametry | |
---|---|
eventId |
Identyfikator zdarzenia 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 AgentEvent
.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję AgentEvent
.
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.