ตรวจสอบสิทธิ์ผู้ใช้

ตัวแทนมักมีข้อมูลเชิงลึกเกี่ยวกับผู้ใช้ที่สื่อสารด้วยเพียงเล็กน้อย จากข้อมูลที่ผู้ใช้ให้ไว้ในการสนทนา อย่างไรก็ตาม ตัวแทนสามารถ ตรวจสอบสิทธิ์ผู้ใช้ด้วย OAuth เพื่อยืนยันตัวตนของผู้ใช้ ปรับเปลี่ยนการสนทนาในแบบของคุณ และดำเนินการในนามของผู้ใช้ ของผู้ใช้

ในขั้นตอนการสนทนานี้ ผู้ใช้เลือกที่จะเพิ่มเครดิตลงในบัญชี และ Agent จะแจ้งให้ผู้ใช้ลงชื่อเข้าใช้เพื่อตรวจสอบข้อมูลประจำตัวของผู้ใช้ ดึงข้อมูล ข้อมูลที่ทราบเกี่ยวกับผู้ใช้ และสั่งซื้อเครดิต

1. ผู้ใช้เริ่มการสนทนากับตัวแทน

2. เมื่อผู้ใช้เริ่มต้นพิมพ์คำตอบ ผู้ใช้จะส่งกิจกรรมการพิมพ์ไปยัง ตัวแทน

   {
     "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. ผู้ใช้ส่ง "สวัสดี ฉันต้องการเพิ่มเครดิต 5 รายการในบัญชีของฉัน" เป็นข้อความ

   {
     "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. ตัวแทนจะส่งข้อความว่า "ฉันช่วยคุณเรื่องนั้นได้ ลงชื่อเข้าใช้บัญชีเพื่อ ต่อไป" พร้อมกับคำแนะนำเกี่ยวกับคำขอการตรวจสอบสิทธิ์

   ผู้ให้บริการ OAuth เป็นผู้กำหนด clientId และ scopes ตัวแทน สร้างค่า codeChallenge ตาม

   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. ผู้ใช้จะได้รับข้อความ แตะคำแนะนำคำขอการตรวจสอบสิทธิ์ และลงชื่อเข้าใช้บัญชี

6. ตัวแทนจะได้รับข้อความที่มีรหัสการให้สิทธิ์ OAuth ใน authenticationResponse.code

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

7. ตัวแทนสื่อสารกับผู้ให้บริการ OAuth โดยแลกเปลี่ยนการให้สิทธิ์ สำหรับโทเค็นเพื่อการเข้าถึงและดึงข้อมูลบัญชีของผู้ใช้

8. ตัวแทนจะส่งข้อความ "ขอบคุณสำหรับการลงชื่อเข้าใช้ ขณะนี้คุณมี 2 เครดิต ถึง ยืนยันว่าคุณต้องการให้เราเพิ่มเครดิต 5 เครดิตในบัญชีของคุณ และเรียกเก็บเงินจาก รวมทั้งวิธีการชำระเงินเริ่มต้น" เป็นข้อความที่มี "ใช่" และ "ไม่ใช่" เป็นคำตอบที่แนะนำ

   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. ผู้ใช้แตะปุ่ม "ใช่" คำตอบที่แนะนำ

   {
     "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. ตัวแทนจะประมวลผลธุรกรรมโดยใช้โทเค็นเพื่อการเข้าถึง OAuth แล้วจึงส่ง ข้อความ "เยี่ยมมาก เราเพิ่งเพิ่ม 5 เครดิตในบัญชีของคุณ มีไหม มีอะไรที่เราจะช่วยคุณได้อีกไหม"

    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. ผู้ใช้ส่งข้อความ "ไม่เป็นไร"

    {
      "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. ตัวแทนจะส่งข้อความ "ขอขอบคุณที่ติดต่อเรา ขอให้มีความสุข!"

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