Wysyłanie i odbieranie wiadomości oraz zdarzeń to podstawowe aspekty komunikacji między agentem a użytkownikiem. Agenty wysyłają wiadomości, zdarzenia i prośby do użytkowników za pomocą żądań HTTP POST do interfejsu RBM API, ale otrzymują wiadomości i zdarzenia utworzone przez użytkowników na skonfigurowanym webuku.
Poniżej przedstawiamy przykładowy przebieg rozmowy, który wykorzystuje dane przykładowe, aby pokazać, jak wiadomości, zdarzenia i prośby mogą tworzyć przydatne i znaczące interakcje.
Witaj, świecie!
W tym przykładzie agent wysyła użytkownikowi wiadomość Hello, World!
, a użytkownik odpowiada Hello to you!
.
Agent wysyła żądanie sprawdzenia możliwości, aby zweryfikować, czy urządzenie użytkownika obsługuje RBM.
Pracownik obsługi klienta wysyła:
GET /v1/phones/+12223334444/capabilities?requestId=147547143069602483572&agentId=welcome-bot HTTP/1.1 Host: us-rcsbusinessmessaging.googleapis.com Content-Type: application/json
Platforma RBM wysyła do agenta odpowiedź z sprawdzaniem możliwości, która wskazuje, że urządzenie użytkownika może odbierać wiadomości RBM.
Agent otrzymuje:
{ "rbmEnabled": true, "features": [ "REVOCATION", "RICHCARD_STANDALONE", "RICHCARD_CAROUSEL", "ACTION_CREATE_CALENDAR_EVENT", "ACTION_DIAL", "ACTION_OPEN_URL", "ACTION_SHARE_LOCATION", "ACTION_VIEW_LOCATION" ] }
Agent wysyła wiadomość
Hello, World!
do interfejsu RBM API, który przekazuje ją na urządzenie użytkownika.Pracownik obsługi klienta wysyła:
POST /v1/phones/+12223334444/agentMessages?messageId=123&agentId=welcome-bot HTTP/1.1 Host: us-rcsbusinessmessaging.googleapis.com Content-Type: application/json { "contentMessage": { "text": "Hello, World!", } }
Platforma RBM wysyła wiadomość na urządzenie użytkownika i wysyła do agenta zdarzenie
DELIVERED
.Pracownik obsługi klienta otrzymuje:
{ "senderPhoneNumber": "+12223334444", "agentId": "welcome-bot@rbm.goog", "eventType": "DELIVERED", "eventId": "Ms6oOiEli6QS-fe8QFrmhfIg", "messageId": "123" }
Użytkownik otwiera wiadomość na urządzeniu, co powoduje wysłanie do agenta zdarzenia
READ
.Agent otrzymuje:
{ "senderPhoneNumber": "+12223334444", "agentId": "welcome-bot@rbm.goog", "eventType": "READ", "eventId": "Ms6oOiEli6QS-ge9ZFsmgTj", "messageId": "123" }
Użytkownik pisze i wysyła odpowiedź do pracownika obsługi klienta.
Pracownik obsługi klienta otrzymuje:
{ "senderPhoneNumber": "+12223334444", "agentId": "welcome-bot@rbm.goog", "messageId": "msg000999888777a", "sendTime": "2018-12-31T15:01:23.045123456Z", "text": "Hello to you!", }
Gdy platforma RBM otrzyma wiadomość od użytkownika, automatycznie wyśle na jego urządzenie zdarzenie
DELIVERED
.Agent wysyła zdarzenie
READ
w odpowiedzi na wiadomość użytkownika, aby poinformować go, że wiadomość została odebrana i zapoznana.Pracownik obsługi klienta wysyła:
POST /v1/phones/+12223334444/agentEvents?eventId=1234&agentId=welcome-bot HTTP/1.1 Host: us-rcsbusinessmessaging.googleapis.com Content-Type: application/json { "eventType": "READ", "messageId": "msg000999888777a" }