Method: phones.agentEvents.create

Wysyła zdarzenie od agenta do użytkownika.

Zdarzenia agenta mogą wskazywać, że agent odczytał wiadomość od użytkownika lub że jest w trakcie pisania (co dodaje ludzki element do RCS Business Messaging). Jeśli użytkownik nie ma włączonej usługi RCS, platforma RCS dla Firm zwraca błąd NOT_FOUND (HTTP 404). Jeśli użytkownik ma włączone czaty RCS, ale w danym momencie jest niedostępny, platforma zwraca odpowiedź 200 OK i obsługuje dostarczanie na podstawie typu zdarzenia. Zdarzenia agenta są umieszczane w kolejce typu store-and-forward na maksymalnie 30 dni i dostarczane, gdy użytkownik ponownie połączy się z internetem. Tylko zdarzenia IS_TYPING są ulotne i nie są umieszczane w kolejce.

W przeciwieństwie do wiadomości agenta nie można cofnąć wysłanych zdarzeń agenta.

Żą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. Na przykład w przypadku użytkownika z numerem telefonu w Stanach Zjednoczonych +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/agentEvents.

Parametry zapytania

Parametry
eventId

string

Identyfikator zdarzenia 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 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 sekcji OAuth 2.0 Overview.