一、 业务场景：导购的“第二大脑”
在私域沟通中，导购最怕遇到这种场景：面对上百个客户，打开对话框却记不起对方是谁，买过什么，更不知道对方此时此刻想看什么。
痛点在于：
信息滞后：客户画像锁在 CRM 系统里，导购需要退出企微、登录后台查询，沟通效率极其低下。
话术盲目：因为不了解客户偏好（如：更在意价格还是质量），导购只能群发通用的推销话术，导致回复率低。
通过QiWe API（官网地址）开发的智能侧边栏（H5/小程序），我们可以直接在企微对话框右侧嵌入一个“实时画像中枢”。当导购点击客户头像时，侧边栏自动通过 API 拉取数据并渲染出一张“用户偏好雷达图”。
二、 技术方案设计：侧边栏数据的“即时渲染”架构
侧边栏本质上是一个嵌入在企微内部的 Web 页面，其核心逻辑如下：
身份锚定：通过 QiWe 官网平台 提供的 JS-SDK 接口
agentConfig和getContext，在侧边栏加载瞬间获取当前对话的external_userid。多维数据聚合：
交易维度：从订单系统提取累计消费、客单价、购买频率。
互动维度：从会话存档提取关键词频率（如：提到“优惠” 15 次）。
行为维度：从埋点系统提取最近浏览的小程序商品详情。
雷达图可视化：前端使用ECharts或AntV，将上述数据转化为五个维度的评分（忠诚度、消费力、互动度、活跃度、价格敏感度）。
动态话术推荐：API 根据雷达图的长短板，自动在下方匹配 3 条最适合该客户的“开场白”。
三、 核心代码实现：侧边栏画像拉取与渲染
以下展示侧边栏前端如何通过 API 获取客户身份，并请求后端画像数据。
1. 前端：获取当前客户身份 (JS-SDK)
// 详情查阅：https://doc.qiweapi.com/ 中的 JS-SDK 指南 wx.ready(function(){ wx.invoke('getContext', {}, function(res){ if(res.err_msg == "getContext:ok"){ let entry = res.entry; // 入口环境：single_chat(单聊) if(entry === 'single_chat'){ wx.invoke('getCurExternalContact', {}, function(res_contact){ if(res_contact.err_msg == "getCurExternalContact:ok"){ // 拿到当前聊天对象的唯一ID const extUserId = res_contact.userId; renderRadarChart(extUserId); } }); } } }); });2. 后端：计算偏好并返回可视化数据 (Python)
import requests from flask import Flask, jsonify app = Flask(__name__) API_BASE = "https://api.qiweapi.com/v1" HEADERS = {"Authorization": "Bearer YOUR_TOKEN"} @app.route('/api/get_user_radar/<ext_userid>') def get_user_radar(ext_userid): """ 聚合多端数据生成雷达图坐标 接口文档：https://doc.qiweapi.com/ """ # 1. 从 QiWe API 获取基础标签 tags_res = requests.get(f"{API_BASE}/contact/detail?external_userid={ext_userid}", headers=HEADERS).json() tags = tags_res.get("data", {}).get("tags", []) # 2. 模拟计算逻辑（实际应查询 CRM/数据库） # 维度：[互动, 消费, 活跃, 价格敏感, 忠诚] radar_data = [85, 40, 90, 20, 65] # 3. 动态生成推荐话术 tips = [] if radar_data[3] < 30: # 价格不敏感 tips.append("客户对品质要求高，建议推荐【高客单新品】") if radar_data[0] > 80: # 互动度高 tips.append("客户近期非常活跃，建议直接发起语音邀请") return jsonify({ "code": 200, "radar": radar_data, "tips": tips, "customer_name": tags_res.get("data", {}).get("name") })四、 避坑指南：让侧边栏真正“好用”
1. 缓存优化：侧边栏在导购切换对话时会频繁加载。如果每次都去后台进行复杂的 SQL 聚合计算，页面会出现明显的白屏。对策： 在 Redis 中为每个客户缓存一份 30 分钟有效的“画像快照”。
2. 配置签名错误：JS-SDK 的 agentConfig 经常因为 URL 包含参数导致签名校验失败。对策： 务必在 QiWe 官网平台 下载官方签名工具，且动态获取当前页面的 window.location.href.split('#')[0] 进行签名。
3. UI 适配：企微侧边栏的宽度较窄（通常为 300px-400px）。对策： 雷达图不要堆砌太多维度，建议保持在 5-6 个，且使用简洁的图标代替繁琐的文字。
4. 权限控制：侧边栏会展示敏感画像。建议： 在 QiWe 开发者文档 中查阅 check_member_auth 逻辑，确保只有拥有该客户跟进权的导购才能看到对应的画像。

五、 运营总结：把导购变成“半个算法工程师”
智能侧边栏的上线，彻底改变了私域的沟通效率：
1. 盲聊变“明”聊：导购在开口前就已经知道了客户的消费实力和活跃周期，成交转化率平均可提升 15% - 22%。
2. 标准化服务：通过 API 自动生成的“动态话术推荐”，即使是新入职的导购也能像金牌导购一样进行专业对谈。
3. 数据价值闭环：侧边栏不仅是展示窗口，导购在侧边栏点击的每一个标签、选用的每一条话术，都会通过 API 再次回流到系统中，完善画像模型。
下一步行动：
• 前往 QiWe 官网 注册并开启“聊天工具栏”配置。
• 在您的 Web 项目中集成 JS-SDK，并配置好安全域名。
• 参考 QiWe 开发者文档 调取 getCurExternalContact 接口进行联调。
