SaleSmartly聊天插件JSSDK开发者文档

ssq.push('setLoginInfo', {
  user_id: 'b58e64cfxs2ym', // 加密后的用户id, 必填！
  user_name: 'test_yy', // 对应用户名，可在客户资料查看
  language: 'ru-RU', // 对应用户语言，可在客户资料查看
  phone: '1592014xxxx', // 对应用户手机号，可在客户资料查看
  email: 'test@test', // 对应用户邮箱，可在客户资料查看
  description: '套餐B\n客户端\n收费客户', // 对应用户的描述信息，例如套餐信息，可在客户资料查看
  label_names: ['标签值1', '标签值2'], // 对应用户标签，仅支持传系统已创建的标签值，可在客户资料查看
  custom_fields_ext: {"1210":"test11","more":["s1","s2"]}, // 自定义字段，到项目设置的自定义字段中找到id和对应值进行填入（选择类型以数组形式传入），可在客户资料查看
});

<script>
  ssq.push('setLoginInfo', {
    language: 'ru-RU',         // 插件语言，选填
  });

  // 语言选项（根据需要选择并设置）
  // 'en-US': 'English',       英语
  // 'zh-CN': '中文',          简体中文
  // 'zh-HK': '繁體中文',      繁体中文
  // 'ru-RU': 'русский',      俄语
  // 'th-TH': 'ภาษาไทย',     泰语
  // 'vi-VN': 'Tiếng Việt',   越南语
  // 'mn': 'Монгол',          蒙古语
  // 'ja-JP': 'やまと',        日语
  // 'fr': 'français',        法语
  // 'pt': 'português',       葡萄牙语
  // 'es': 'español',         西班牙语
  // 'ar': 'العربية',         阿拉伯语
  // 'de': 'Deutsch'           德语
  //  ro: 'română', // 罗马尼亚语
  //  pl: 'polski', // 波兰语
  //  id: 'Bahasa Indonesia', // 印度尼西亚语
  //  ko: '한국어', // 韩语
  //  nl: 'Nederlands', // 荷兰语
  //  da: 'Dansk', // 丹麦语
  //  it: 'Italiano', // 意大利语
  //  tr: 'Türkçe', // 土耳其语
  //  bn: 'বাংলা', // 孟加拉语
</script>

ssq.push('clearUser');

ssq.push('chatOpen');

ssq.push('chatClose');

ssq.push('onUnRead', function(obj) {
    console.log(obj.num); // 未读数量
    console.log(obj.list); // 未读内容
});

  //引入SalesSmartly 聊天插件的JavaScript 外部脚本 换成自己的，【确保聊天插件处于打开状态！】
  <script src="https://assets.salesmartly.com/js/project_23232_xxxxx_xxxxxxxxxx.js"></script>

  <script>
   // 隐藏图标（注: 代码放在引入聊天插件js之后执行）
   window.__ssc.setting = { hideIcon: true }; //true为隐藏，false为不隐藏

	// 自定义按钮事件
    function openChat() {
        // 打开聊天窗
        ssq.push('chatOpen');
    }
 </script>

ssq.push('onSendMessage', function(obj) {
   // 在这里执行任何需要的上报或行为
});

ssq.push('onReceiveMessage', function(obj) {
    console.log(obj);
});

ssq.push('onOpenChat', function() {
    // 在这里执行数据上报或其他操作
    // 例如，可以发送事件到分析平台，记录用户打开聊天窗口的行为
});

ssq.push('onCloseChat', function() {
    // 在这里执行你需要的操作，比如数据上报
});

ssq.push('onOpenCollection', (obj) => {
  // obj.type = 'offline' 离线留资
  // obj.type = 'survey' 聊前留资
});

ssq.push('onCollectionInfo', (obj) => {
  //obj包含了用户在信息收集过程中提供的数据
});

// 监听点击Line图标
ssq.push('onOpenLine', (obj) => {
  // 在这里执行点击Line图标后的操作
  console.log('Line icon clicked', obj);
});

// 监听点击Messenger图标
ssq.push('onOpenMessenger', (obj) => {
  // 在这里执行点击Messenger图标后的操作
  console.log('Messenger icon clicked', obj);
});

// 监听点击Email图标
ssq.push('onOpenEmail', (obj) => {
  // 在这里执行点击Email图标后的操作
  console.log('Email icon clicked', obj);
});

// 监听点击Telegram图标
ssq.push('onOpenTelegram', (obj) => {
  // 在这里执行点击Telegram图标后的操作
  console.log('Telegram icon clicked', obj);
});

// 监听点击Whatsapp图标
ssq.push('onOpenWhatsapp', (obj) => {
  // 在这里执行点击Whatsapp图标后的操作
  console.log('Whatsapp icon clicked', obj);
});

// 监听点击微信图标
ssq.push('onOpenWeixin', (obj) => {
  // 在这里执行点击微信图标后的操作
  console.log('Weixin icon clicked', obj);
});

// 监听点击VKontakte图标
ssq.push('onOpenVKontakte', (obj) => {
  // 在这里执行点击VKontakte图标后的操作
  console.log('VKontakte icon clicked', obj);
});

// 监听点击TikTok图标
ssq.push('onOpenTikTok', (obj) => {
  // 在这里执行点击TikTok图标后的操作
  console.log('TikTok icon clicked', obj);
});

// 监听点击自定义图标
ssq.push('onOpenCustom', (obj) => {
  // 在这里执行点击自定义图标后的操作
  console.log('custom icon clicked', obj);
  // obj = {
  //     id, // custom_1、custom_2、custom_3
  //     content,
  // }
});

// 监听点击Zalo图标
ssq.push('onOpenZalo', (obj) => {
  // 在这里执行点击Zalo图标后的操作
  console.log('Zalo icon clicked', obj);
});

ssq.push('onReady', () => {
  // 执行其他事件
});

// 使用示例：
<script id="ss_chat" defer src="https://example.js"></script>

<script>
   const ss_chat = document.getElementById('ss_chat');
   ss_chat.addEventListener('load', (e) => {
      window.ssq && window.ssq.push('onReady', () => {
        // 执行事件
      });
   })
</script>

ssq.push('createWhatsappGreeting', function(msg){
    // msg默认为Hello.
    return msg + 'tony'; // 输出结果：Hello.tony
    // 如果需要完全自定义，可直接返回自定义的文字，如：
    // return '你好' // 输出结果：你好
});

ssq.push('sendTextMessage', 'it is an error');

#示例1捕获错误信息并发送到客服：
function handleError(error) {
    // 发送错误信息到客服系统
    ssq.push('sendTextMessage', `Error encountered: ${error.message}`);
}

// 示例：捕获并处理错误
try {
    // 你的代码逻辑
} catch (error) {
    handleError(error);
}

#示例2点击按钮发送咨询信息
<!-- 示例 HTML 按钮 -->
<button onclick="sendProductInquiry('Product Name')">咨询商品</button>

<script>
    function sendProductInquiry(productName) {
        // 发送商品咨询信息到客服系统
        ssq.push('sendTextMessage', `咨询关于商品: ${productName}`);
    }
</script>

ssq.push('hideUpload', ['img', 'video', 'document'])
// 'img' 图片类型
// 'video' 视频类型
// 'document' 附件类型

// 如果设置了关闭，想要在某个操作中将功能重新开放出来，则将数组中的对应项去除，重新调用
// 例：ssq.push('hideUpload', [])

ssq.push('hideCloseIcon');