@tencentcloud/ai-desk-customer-vue 1.5.5 → 1.5.6

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.5.6 @2025.8.5
+
+### Features
+- 保障反复切换账号、切换客服号场景下的会话状态的准确性。
+- 强校验 `userID`。
+
 ## 1.5.5 @2024.7.30
 
 ### Fixed

package/components/CustomerServiceChat/index-web.vue

@@ -256,7 +256,7 @@ const initLanguage = () => {
       let navigatorLang = convertLanguageToLowercase(navigator.language);
       language = getValidLanguage(navigatorLang);
     }
-  } 
+  }
   currentLanguage.value = language;
   state.set('currentLanguage', language);
   TUITranslateService.changeLanguage(language);
@@ -392,13 +392,7 @@ function onCurrentConversationIDUpdate(conversationID: string) {
     return;
   }
 
-  if (currentConversationID.value === conversationID) {
-    return;
-  }
-
   currentConversationID.value = conversationID;
-
-  // The TUICustomerServicePlugin plugin determines if the current conversation is a customer service conversation, then sets chatType and activates the conversation.
   activeConversation();
 }
 
@@ -451,6 +445,7 @@ function changeLanguage(languageCode: string) {
     activeConversation();
   });
 }
+
 function activeConversation() {
   TUICore.callService({
     serviceName: TUIConstants.TUICustomerServicePlugin.SERVICE.NAME,

package/components/CustomerServiceChat/message-list/message-elements/message-desk/message-desk-elements/message-multi-form/form-mobile.vue

@@ -328,6 +328,7 @@ export default {
     padding: 6px 10px;
     color: white;
     border-radius: 20px;
+    min-width: 100px;
   }
   .icon-container {
     position: relative;

package/locales/en/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"Unable to send the file as it exceeds 100 MB",
   "image 大小超过 20MB，无法发送":"Unable to send the image as it exceeds 20 MB",
   "video 大小超过 100MB，无法发送":"Unable to send the video as it exceeds 100 MB",
+  "userID 只能包含可打印 ASCII 字符": "The userID can only contain printable ASCII characters",
+  "userID 不能包含'administrator'": "The userID cannot contain the string 'administrator'",
+  "userID 长度不能超过45字节": "The length of the userID cannot exceed 45 bytes",
 }
 export default AIDesk;

package/locales/fil/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"Lampas sa 100MB ang file, hindi maipadala",
   "image 大小超过 20MB，无法发送":"Hindi maipadala ang larawan dahil lampas ito sa 20 MB",
   "video 大小超过 100MB，无法发送":"Hindi maipadala ang video dahil lampas ito sa 100 MB",
+  "userID 只能包含可打印 ASCII 字符": "Ang UserID ay dapat naglalaman lamang ng printable ASCII characters",
+  "userID 不能包含'administrator'": "Ang UserID ay hindi dapat maglaman ng 'administrator'",
+  "userID 长度不能超过45字节": "Ang haba ng UserID ay hindi dapat lumampas sa 45 bytes",
 }
 export default AIDesk;

package/locales/id/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
 	"file 大小超过 100MB，无法发送":"Ukuran file melebihi 100MB, tidak dapat dikirim",
 	"image 大小超过 20MB，无法发送":"Tidak dapat mengirim gambar karena melebihi 20 MB",
   "video 大小超过 100MB，无法发送":"Tidak dapat mengirim video karena melebihi 100 MB",
+	"userID 只能包含可打印 ASCII 字符": "UserID hanya boleh berisi karakter ASCII yang dapat dicetak",
+  "userID 不能包含'administrator'": "UserID tidak boleh mengandung 'administrator'",
+  "userID 长度不能超过45字节": "Panjang UserID tidak boleh melebihi 45 byte",
 }
 export default AIDesk;

package/locales/ja/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"ファイルサイズが100MBを超えているため送信できません",
   "image 大小超过 20MB，无法发送":"画像のサイズが20MBを超えているため送信できません",
   "video 大小超过 100MB，无法发送":"動画のサイズが100MBを超えているため送信できません",
+  "userID 只能包含可打印 ASCII 字符": "UserIDは印字可能なASCII文字のみを含める必要があります",
+  "userID 不能包含'administrator'": "UserIDに'administrator'を含めることはできません",
+  "userID 长度不能超过45字节": "UserIDの長さは45バイトを超えてはいけません",
 }
 export default AIDesk;

package/locales/ms/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"Saiz fail melebihi 100MB, tidak boleh dihantar",
   "image 大小超过 20MB，无法发送":"Tidak dapat menghantar gambar kerana melebihi 20 MB",
   "video 大小超过 100MB，无法发送":"Tidak dapat menghantar video kerana melebihi 100 MB",
+  "userID 只能包含可打印 ASCII 字符": "UserID hanya boleh mengandung aksara ASCII yang boleh dicetak",
+  "userID 不能包含'administrator'": "UserID tidak boleh mengandung 'administrator'",
+  "userID 长度不能超过45字节": "Panjang UserID tidak boleh melebihi 45 bait",
 }
 export default AIDesk;

package/locales/ru/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"Размер файла превышает 100MB, отправка невозможна",
   "image 大小超过 20MB，无法发送":"Невозможно отправить изображение, так как оно превышает 20 MB",
   "video 大小超过 100MB，无法发送":"Невозможно отправить видео, так как оно превышает 100 MB",
+  "userID 只能包含可打印 ASCII 字符": "UserID должен содержать только печатные символы ASCII",
+  "userID 不能包含'administrator'": "UserID не должен содержать 'administrator'",
+  "userID 长度不能超过45字节": "Длина UserID не должна превышать 45 байт",
 }
 export default AIDesk;

package/locales/th/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"ขนาดไฟล์เกิน 100MB ไม่สามารถส่งได้",
   "image 大小超过 20MB，无法发送":"ไม่สามารถส่งรูปภาพได้เนื่องจากขนาดเกิน 20 MB",
   "video 大小超过 100MB，无法发送":"ไม่สามารถส่งวิดีโอได้เนื่องจากขนาดเกิน 100 MB",
+  "userID 只能包含可打印 ASCII 字符": "UserID ต้องมีเฉพาะตัวอักษร ASCII ที่พิมพ์ได้เท่านั้น",
+  "userID 不能包含'administrator'": "UserID ห้ามมี 'administrator'",
+  "userID 长度不能超过45字节": "ความยาว UserID ต้องไม่เกิน 45 ไบต์",
 }
 export default AIDesk;

package/locales/vi/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"Kích thước tệp vượt quá 100MB, không thể gửi",
   "image 大小超过 20MB，无法发送":"Không thể gửi hình ảnh do vượt quá 20 MB",
   "video 大小超过 100MB，无法发送":"Không thể gửi video do vượt quá 100 MB",
+  "userID 只能包含可打印 ASCII 字符": "UserID chỉ được chứa ký tự ASCII có thể in được",
+  "userID 不能包含'administrator'": "UserID không được chứa 'administrator'",
+  "userID 长度不能超过45字节": "Độ dài UserID không được vượt quá 45 byte",
 }
 export default AIDesk;

package/locales/zh_cn/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送": "file 大小超过 100MB，无法发送",
   "image 大小超过 20MB，无法发送":"image 大小超过 20MB，无法发送",
   "video 大小超过 100MB，无法发送":"video 大小超过 100MB，无法发送",
+  "userID 只能包含可打印 ASCII 字符": "userID 只能包含可打印 ASCII 字符",
+  "userID 不能包含'administrator'": "userID 不能包含'administrator'",
+  "userID 长度不能超过45字节": "userID 长度不能超过45字节",
 }
 export default AIDesk;

package/locales/zh_tw/aidesk.ts

@@ -30,5 +30,8 @@ const AIDesk = {
   "file 大小超过 100MB，无法发送":"檔案大小超過100MB，無法傳送",
   "image 大小超过 20MB，无法发送":"圖片大小超過20MB，無法傳送",
   "video 大小超过 100MB，无法发送":"影片大小超過100MB，無法傳送",
+  "userID 只能包含可打印 ASCII 字符": "userID 只能包含可打印 ASCII 字元",
+  "userID 不能包含'administrator'": "userID 不能包含'administrator'",
+  "userID 长度不能超过45字节": "userID 長度不能超過45位元組",
 }
 export default AIDesk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencentcloud/ai-desk-customer-vue",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "description": "Vue2/Vue3 UIKit for AI Desk",
   "main": "index",
   "keywords": [

package/server.ts

@@ -19,9 +19,9 @@ import TUIChatEngine, {
 import Log from './utils/logger';
 import { version } from './package.json'
 import { Toast, TOAST_TYPE } from "./components/common/Toast/index-web";
-import { switchReadStatus, transferToHuman, transferToTaskFlow } from "./utils/utils";
+import { switchReadStatus, transferToHuman, transferToTaskFlow, validateUserID } from "./utils/utils";
 import state from "./utils/state";
-import { CUSTOM_MESSAGE_SRC, USER_DEFAULT_AVATAR } from "./constant";
+import { USER_DEFAULT_AVATAR } from "./constant";
 import { vueVersion } from "./adapter-vue-web";
 import { ITransferToHumanModel, ITransferToTaskFlowModel } from './interface';
 
@@ -46,6 +46,7 @@ export default class TUICustomerServer {
   private currentCustomerServiceID: string;
   private loggedInUserID: string;
   private myProfile: IProfile;
+  private paramsForActiveAgain: any;
   constructor() {
     TUICore.registerService(TUIConstants.TUICustomerServicePlugin.SERVICE.NAME, this);
     TUICore.registerExtension(TUIConstants.TUIContact.EXTENSION.CONTACT_LIST.EXT_ID, this);
@@ -63,9 +64,9 @@ export default class TUICustomerServer {
     return TUICustomerServer.instance;
   }
 
-  private loginCustomerUIKit(SDKAppID:number, userID:string, userSig:string) {
+  private async loginCustomerUIKit(SDKAppID:number, userID:string, userSig:string) {
     clearChatStorage(SDKAppID, userID);
-    TUIChatEngine.login({
+    return TUIChatEngine.login({
       SDKAppID,
       userID,
       userSig,
@@ -74,7 +75,7 @@ export default class TUICustomerServer {
       Log.i(`login success. userID:${userID}`);
       this.isLoggedIn = true;
       this.loggedInUserID = userID;
-      TUIConversationService.switchConversation(`C2C${this.currentCustomerServiceID}`);
+      this.switchConversation(`C2C${this.currentCustomerServiceID}`);
       switchReadStatus(state.get('showReadStatus'));
       TUIChatEngine.chat.callExperimentalAPI('isFeatureEnabledForStat', Math.pow(2, 42));
     })
@@ -88,24 +89,45 @@ export default class TUICustomerServer {
       })
   }
 
-  public init(SDKAppID:number, userID:string, userSig:string) {
+  public async init(SDKAppID:number, userID:string, userSig:string) {
     Log.l(`TUICustomerServer.init vueVersion:${vueVersion} version:${version} SDKAppID:${SDKAppID} userID:${userID}` +
       ` isLoggedIn:${this.isLoggedIn} loggedInUserID:${this.loggedInUserID} currentCustomerServiceID:${this.currentCustomerServiceID}`);
+    if (userID) {
+      let ret = validateUserID(userID);
+      if (ret > 0) {
+        setTimeout(() => {
+          let reason = '';
+          if (ret === 1) {
+            reason = TUITranslateService.t("AIDesk.userID 只能包含可打印 ASCII 字符");
+          } else if (ret === 2) {
+            reason = TUITranslateService.t("AIDesk.userID 不能包含'administrator'");
+          } else if (ret === 3) {
+            reason = TUITranslateService.t("AIDesk.userID 长度不能超过45字节");
+          }
+          Toast({
+            message: reason,
+            type: TOAST_TYPE.ERROR,
+            duration: 30000,
+          });
+        }, 500);
+        return;
+      }
+    }
     if (this.isLoggedIn) {
       if (this.loggedInUserID === userID) {
-        TUIConversationService.switchConversation(`C2C${this.currentCustomerServiceID}`);
+        await this.switchConversation(`C2C${this.currentCustomerServiceID}`);
         return;
       }
-      this.unInit().finally(() => {
+      return this.unInit().finally(() => {
         this.isLoggedIn = false;
         this.loginCustomerUIKit(SDKAppID, userID, userSig);
       });
     } else {
-      this.loginCustomerUIKit(SDKAppID, userID, userSig);
+      return this.loginCustomerUIKit(SDKAppID, userID, userSig);
     }
   }
 
-  public initWithProfile(options: IInitWithProfile) {
+  public async initWithProfile(options: IInitWithProfile) {
     const { SDKAppID, userID, userSig, nickName, avatar, customerServiceID } = options;
     Log.l(`TUICustomerServer.initWithProfile version:${version}`);
     if (nickName) {
@@ -118,10 +140,10 @@ export default class TUICustomerServer {
     if (customerServiceID) {
       this.currentCustomerServiceID = customerServiceID;
     }
-    this.init(SDKAppID, userID, userSig);
+    return this.init(SDKAppID, userID, userSig);
   }
 
-  public unInit() {
+  public async unInit() {
     this.isLoggedIn = false;
     return TUIChatEngine.logout();
   }
@@ -228,9 +250,18 @@ export default class TUICustomerServer {
     }
   }
 
+  private async switchConversation(conversationID: string) {
+    const ret = await TUIConversationService.switchConversation(conversationID);
+    // -100002 即要切换的会话 ID 跟当前已打开的会话 ID 相同，这个时候我们重发 src 7，确保服务流状态正确
+    if (ret.code === -100002) {
+      this.activeServiceFlow(this.paramsForActiveAgain);
+    }
+  }
+
   // 激活会话服务流
   private activeServiceFlow(params: any) {
-    Log.i(`activeServiceFlow params: language:${params.robotLang} country:${params.country} timezone:${params.timezone}`)
+    Log.i(`TUICustomerServer.activeServiceFlow params: language:${params.robotLang} country:${params.country} timezone:${params.timezone}`);
+    this.paramsForActiveAgain = { ...params };
     TUIChatService.sendCustomMessage({
       to: params.conversationID.slice(3),
       conversationType: TUIChatEngine.TYPES.CONV_C2C,
@@ -238,8 +269,8 @@ export default class TUICustomerServer {
         data: JSON.stringify({
           src: '7',
           customerServicePlugin: 0,
-          triggeredContent: { 
-            language: params.robotLang, 
+          triggeredContent: {
+            language: params.robotLang,
             country: params.country,
             timezone: params.timezone,
           }
@@ -247,5 +278,6 @@ export default class TUICustomerServer {
       },
     }, { onlineUserOnly: true });
     TUIStore.update(StoreName.CUSTOM, "isInSession", true);
+    Log.w(`TUICustomerServer.activeServiceFlow src 7 sent`);
   }
 }

package/utils/utils.ts

@@ -306,4 +306,19 @@ export function transferToHuman(conversationID: string, groupID?: number, specif
       })
     }
   },{ onlineUserOnly: description ? false : true });
+}
+
+export function validateUserID(userID: string) {
+  let ret = 0;
+  if (!/^[\x20-\x7E]+$/.test(userID)) {
+    ret = 1;
+  }
+  if (userID.toLowerCase().includes('administrator')) {
+    ret = 2;
+  }
+  const byteSize = new TextEncoder().encode(userID).length;
+  if (byteSize > 45) {
+    ret = 3;
+  }
+  return ret;
 }