Uwierzytelnianie użytkownika

Agenci zwykle mają niewiele informacji o użytkownikach, z którymi się komunikują. na podstawie informacji podanych przez użytkowników podczas rozmowy. Jednak pracownicy obsługi klienta mogą uwierzytelnianie użytkowników za pomocą protokołu OAuth potwierdzania tożsamości użytkowników, personalizowania rozmów i podejmowania działań w imieniu użytkowników.

W ramach rozmowy użytkownik dodaje środki do swojego konta. prosi użytkownika o zalogowanie się w celu weryfikacji tożsamości użytkownika, pobranie znane informacje o użytkowniku i składając zamówienie na środki.

  1. Użytkownik rozpoczyna rozmowę z agentem.
  2. Gdy użytkownik rozpocznie wpisywanie odpowiedzi, wysyła zdarzenie pisania do funkcji .

    {
      "agent": "brands/1111/agents/2222",
      "conversationId": "3333",
      "customAgentId": "oauth",
      "requestId": "1234567890",
      "userStatus": {
        "isTyping": "true",
        "createTime": "2020-10-02T15:01:23.045123456Z",
      },
      "sendTime": "2020-10-02T15:01:24.045123456Z",
    }
    
  3. Użytkownik wysyła wiadomość „Cześć, chcę dodać do mojego konta 5 środków”. jako wiadomość.

    {
      "agent": "brands/1111/agents/2222",
      "conversationId": "3333",
      "customAgentId": "oauth",
      "requestId": "123123123",
      "message": {
        "messageId": "4444",
        "name": "conversations/12345/messages/67890",
        "text": "Hi, I'd like to add 5 credits to my account",
        "createTime": "2020-10-02T15:05:23.045123456Z",
      },
      "context": {
        "entryPoint": "PLACESHEET",
        "userInfo": {
          "displayName": "Michael",
          "userDeviceLocale": "en",
        },
        "resolvedLocale": "en",
      }
      "sendTime": "2020-10-02T15:05:24.045123456Z",
    }
    
  4. Pracownik obsługi klienta wysyła komunikat: „Mogę Ci w tym pomóc. Zaloguj się na konto, aby: kontynuuj”. wraz z sugestią żądania uwierzytelnienia.

    Elementy clientId i scopes są definiowane przez dostawcę OAuth. Agent generuje wartość codeChallenge zgodnie z .

    curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
    -H "Content-Type: application/json" \
    -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
    -d "{
      'messageId': '5555',
      'text': 'I can help you with that. Sign into your account to continue.',
      'suggestions': [
        {
          'AuthenticationRequest': {
            'clientId': 'oauth_client_id_1234567890',
            'codeChallenge': 'code_challenge',
            'scopes': [
              'account',
              'billing',
            ],
          },
        },
      ],
      'representative': {
        'avatarImage': 'https://oauth.agent/bot-avatar.jpg',
        'displayName': 'OAuth Agent',
        'representativeType': 'BOT'
      }
    }"
    
  5. Użytkownik otrzymuje wiadomość, klika sugestię prośby o uwierzytelnienie. i zaloguje się na swoje konto.

  6. Agent otrzyma wiadomość z kodem autoryzacji OAuth w sekcji authenticationResponse.code.

    {
      "agent": "brands/1111/agents/2222",
      "conversationId": "3333",
      "customAgentId": "oauth",
      "requestId": "1234567895",
      "authenticationResponse": {
        "code": "fkhoe541658sfk684d135j186mngkjdrt5425415a2s1dfa68s4edf",
        },
      }
      "sendTime": "2020-10-02T15:01:24.045123456Z",
    }
    
  7. Agent komunikuje się z dostawcą OAuth, wymieniając autoryzację. dla tokena dostępu i pobierania informacji o koncie użytkownika.

  8. Agent wysyła wiadomość „Dziękujemy za zalogowanie się. Obecnie masz 2 punkty. Do potwierdź, że chcesz dodać do swojego konta 5 środków i obciążyć jako domyślną formę płatności?” jako wiadomość z opcją „Tak” i „Nie” jako sugerowane odpowiedzi.

    curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
    -H "Content-Type: application/json" \
    -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
    -d "{
      'messageId': '7777',
      'text': 'Thanks for signing in. You currently have 2 credits. To confirm, you'd like to me to add 5 credits to your account and bill your default payment method?',
      'suggestions': [
        {
          'reply': {
            'text': 'Yes',
            'postbackData': 'process-transaction',
          },
        },
        {
          'reply': {
            'text': 'No',
            'postbackData': 'cancel-transaction',
          },
        },
      ],
      'representative': {
        'avatarImage': 'https://oauth.agent/bot-avatar.jpg',
        'displayName': 'OAuth Agent',
        'representativeType': 'BOT'
      }
    }"
    
  9. Użytkownik klika „Tak”. sugerowana odpowiedź.

    {
      "agent": "brands/1111/agents/2222",
      "conversationId": "3333",
      "customAgentId": "oauth",
      "requestId": "1234567898",
      "suggestionResponse": {
        "message": "conversations/333/messages/8888",
        "postbackData": "process-transaction",
        "createTime": "2020-10-02T15:01:26.045123456Z",
        "text": "Yes",
        "suggestionType": "REPLY",
      }
      "sendTime": "2020-10-02T15:01:27.045123456Z",
    }
    
  10. Agent przetwarza transakcję przy użyciu tokena dostępu OAuth, a następnie wysyła komunikat „Świetnie. Właśnie dodaliśmy do Twojego konta 5 środków. Czy jest Czy mogę Ci w czymś jeszcze pomóc?”.

    curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
    -H "Content-Type: application/json" \
    -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
    -d "{
      'messageId': '9999',
      'text': 'Great. I just added 5 credits to your account. Is there anything else I can help you with?',
      'representative': {
        'avatarImage': 'https://oauth.agent/bot-avatar.jpg',
        'displayName': 'OAuth Agent',
        'representativeType': 'BOT'
      }
    }"
    
  11. Użytkownik wysyła wiadomość „Nie, dziękuję”.

    {
      "agent": "brands/1111/agents/2222",
      "conversationId": "3333",
      "customAgentId": "oauth",
      "requestId": "123123133",
      "message": {
        "messageId": "4444",
        "name": "conversations/12345/messages/101010",
        "text": "No, thanks",
        "createTime": "2020-10-02T15:05:23.045123456Z",
      },
      "context": {
        "entryPoint": "PLACESHEET",
        "userInfo": {
          "displayName": "Michael",
          "userDeviceLocale": "en",
        },
        "resolvedLocale": "en",
      }
      "sendTime": "2020-10-02T15:05:28.045123456Z",
    }
    
  12. Pracownik obsługi klienta wysyła wiadomość „Dziękujemy za skontaktowanie się z nami. Miłego dnia!

    curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
    -H "Content-Type: application/json" \
    -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
    -d "{
      'messageId': '11111111',
      'text': 'Thanks for contacting us. Have a great day!',
      'representative': {
        'avatarImage': 'https://oauth.agent/bot-avatar.jpg',
        'displayName': 'OAuth Agent',
        'representativeType': 'BOT'
      }
    }"