Wysyła zdarzenie od agenta do użytkownika.
Zdarzenia agenta mogą służyć do wskazywania, że agent przeczytał wiadomość od użytkownika lub że agent jest w trakcie pisania (co dodaje element ludzki do korzystania z RCS dla firm). Jeśli użytkownik nie ma włączonej funkcji RCS, platforma RCS dla firm zwraca błąd NOT_FOUND (HTTP 404). Jeśli użytkownik ma włączone czaty RCS, ale nie można się z nim obecnie skontaktować, platforma zwraca odpowiedź 200 OK i obsługuje dostarczanie na podstawie typu zdarzenia. Zdarzenia agenta są umieszczane w kolejce typu „zapisz i przekaż” na maksymalnie 30 dni i dostarczane, gdy użytkownik ponownie przejdzie do trybu online. Tylko zdarzenia IS_TYPING są efemeryczne i nie są umieszczane w kolejce.
W przeciwieństwie do wiadomości agenta zdarzeń agenta nie można cofnąć po wysłaniu.
Żą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. Na przykład w przypadku użytkownika z numerem telefonu w USA +1-222-333-4444 wartość będzie wynosić phones/+12223334444, a wynikowy punkt końcowy będzie miał postać https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Parametry zapytania
| Parametry | |
|---|---|
eventId |
Identyfikator zdarzenia przypisany przez agenta. Musi to być identyfikator UUID, zgodnie z definicją na stronie https://www.rfc-editor.org/info/rfc9562. Platforma RCS dla firm ignoruje każdą wiadomość agenta wysłaną z identyfikatorem, który został użyty w przypadku wcześniejszej wiadomości lub zdarzenia wysłanego przez tego samego agenta. |
agentId |
Wymagane. Unikalny identyfikator agenta. |
Treść żądania
Treść żądania zawiera wystąpienie elementu AgentEvent.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje nowo utworzone wystąpienie elementu AgentEvent.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Więcej informacji znajdziesz w OAuth 2.0 Overview.