驗證使用者

但代理程式不瞭解與使用者互動的使用者擷取使用者在對話中提供的資訊不過，服務專員可以使用 OAuth 驗證使用者確認使用者身分、打造個人化對話，以及代表使用者執行動作使用者數量。

在這個對話流程中，使用者選擇將抵免額存入自己的帳戶，且代理程式會提示使用者登入以驗證使用者身分，擷取並輸入抵免額。

使用者開始和代理程式對話。

使用者開始輸入回覆後，系統會將輸入事件傳送到代理程式。

{
  "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",
}

使用者傳送：「嗨，我想將 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",
}

服務專員會傳送「我可以協助你解決問題，登入帳戶即可繼續回答。」以及驗證要求建議。

clientId 和 scopes 是由 OAuth 供應商定義。虛擬服務專員系統會根據 OAuth 供應商的codeChallenge Google Cloud 就是最佳選擇

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

使用者收到訊息後輕觸驗證要求建議，並登入帳戶

代理程式會收到訊息，其中包含「authenticationResponse.code」欄位。

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

代理程式會與 OAuth 供應商通訊，交換授權存取權杖並擷取使用者的帳戶資訊。

服務專員傳送「感謝您登入。你目前有 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'
  }
}"

使用者輕觸「是」建議回覆。

{
  "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",
}

代理程式會使用 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'
  }
}"

使用者傳送「不用了，謝謝」。

{
  "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",
}

服務專員傳送「感謝您與我們聯絡。祝你有美好的一天！」

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