Method: phones.agentEvents.create

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

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 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

string

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

string

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.