Przepływy rozmów

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!

Podstawowa rozmowa między pracownikiem obsługi klienta a użytkownikiem.

W tym przykładzie agent wysyła użytkownikowi wiadomość Hello, World!, a użytkownik odpowiada Hello to you!.

Sekwencja przepływu wiadomości od pracownika obsługi klienta i odpowiedzi od użytkownika.

  1. 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
  2. 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"
       ]
    }
  3. 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!",
      }
    }
  4. 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"
    }
  5. 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"
    }
  6. 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!",
    }
  7. Gdy platforma RBM otrzyma wiadomość od użytkownika, automatycznie wyśle na jego urządzenie zdarzenie DELIVERED.

  8. 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"
    }