Kullanıcının kimliğini doğrulama

Temsilciler genellikle web dışında iletişim kurdukları kullanıcılar hakkında kullanıcıların sohbet sırasında verdiği bilgilerden yararlanırız. Ancak temsilciler OAuth ile kullanıcıların kimliğini doğrulama Kullanıcı kimliğini onaylamak, görüşmeleri kişiselleştirmek ve adına işlem yapmak için elde etti.

Bu görüşme akışında kullanıcı hesabına kredi eklemeyi seçer ve aracı, kullanıcının kimliğini doğrulamak için kullanıcıdan oturum açmasını ister. kullanıcı hakkında bilinen bilgileri edinebilir ve krediler için bir sipariş verebilir.

1. Kullanıcı, temsilciyle görüşmeye başlar.

2. Kullanıcı bir yanıt yazmaya başladığında yardımcı olur.

   {
     "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. Kullanıcı "Merhaba, hesabıma 5 kredi eklemek istiyorum" mesajı gönderir. bunu yapabilirsiniz.

   {
     "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. Temsilci, "Size yardımcı olabilirim. Şu işlemi gerçekleştirmek için hesabınızda oturum açın: devam et." ve bir Kimlik doğrulama isteği önerisiyle birlikte görünür.

   clientId ve scopes, OAuth sağlayıcısı tarafından tanımlanmış. Temsilci OAuth sağlayıcısının koduna göre codeChallenge değerini oluşturur gereksinimlerini karşılayın.

   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. Kullanıcı mesajı alır, kimlik doğrulama isteği önerisine dokunur ve ve kullanıcının hesabında oturum açar.

6. Temsilci, authenticationResponse.code alanı boş bırakılamaz.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "oauth",
     "requestId": "1234567895",
     "authenticationResponse": {
       "code": "fkhoe541658sfk684d135j186mngkjdrt5425415a2s1dfa68s4edf",
       },
     }
     "sendTime": "2020-10-02T15:01:24.045123456Z",
   }
   

7. Temsilci, OAuth sağlayıcısıyla iletişim kurarak yetkilendirmeyi bildirir ve kullanıcının hesap bilgilerini getirmesine yardımcı oluyorum.

8. Temsilci, "Oturum açtığınız için teşekkür ederiz. Şu anda 2 krediniz var. Alıcı: hesabına 5 kredi eklememi ve ödeme yöntemi nedir?" "Evet" yazan bir mesaj olarak ve "Hayır" önerilen yanıt olarak kabul edilir.

   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. Kullanıcı "Evet"e dokunur önerilen yanıt.

   {
     "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. Temsilci, işlemi OAuth erişim jetonunu kullanarak işler, ardından “Mükemmel. Az önce hesabınıza 5 kredi ekledim. Cevap var mı? yardımcı olabileceğim başka bir konu var mı?" diye sorun.

    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. Kullanıcı "Hayır, teşekkürler" gönderir.

    {
      "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. Temsilci, "Bizimle iletişime geçtiğiniz için teşekkür ederiz. İyi günler dilerim."

    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'
      }
    }"