Method: phones.agentEvents.create

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

string

„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

string

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

string

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.