网硕互联帮助中心用企微做私域的都有这个需求：销售在跟客户聊的时候，旁边如果能有一个按钮，把客户这段话生成一条回复草稿，人看一眼再发出去，效率会高很多。企业微信确实留了这个口子——「聊天工具栏」（也叫侧边栏），可以把自定义网页挂到会话侧边。下面是一套自己配通的做法和三个我踩过的坑，按顺序做能少走弯路。
一、先确认账号与权限前置
要动的东西在企微管理后台（企业自己的管理后台，不是客户端）。前置三件事：
二、可信域名和回调域名要分开填
这是十有八九卡在这个地方。后台里有几个位置都在让你填域名，它们不是一回事：
- 网页授权及 JS-SDK 可信域名：决定你的页面能不能调 JS-SDK。
- OAuth 回调域名：决定授权跳转时回调地址能不能被接受。
两个都要填同一个域名，并且都要通过归属验证。只填其中一个的常见现象是：页面能打开，但拿不到用户身份，或者 JS-SDK 报权限错误。配置里如果用的是带路径的页面地址，可信域名那栏仍然只填域名本体，不要把路径粘进去。
三、把页面配到聊天工具栏
配置路径大致是：自建应用详情 → 「聊天工具栏」/「配置到聊天工具栏」→ 新建页面 → 填页面名称和自定义 URL。这里有第二处坑：
- URL 必须是完整地址（含 https:// 和路径），末尾少写一个斜杠或漏了文件名，企微会直接显示空白页，而且不报错，很难排查。
- 页面名称会在侧边栏显示成按钮文字，起一个内部看得懂的名字就行，别写成对外营销词。
配好后需要重新登录企微客户端，侧边栏才会出现这个入口。改过一次 URL 后没生效，先退出重登，别在配置页反复提交。
四、身份识别：为什么必须在客户端里打开
侧边栏页面要认得出「现在是谁在跟哪个客户聊天」，靠的是企微注入的授权 code。第三处坑就在这里：这个 code 只在企微客户端内打开页面时才会带上。你在普通浏览器里直接访问那个 URL，页面能渲染，但拿不到身份，看上去就像「配置没生效」。排查时先确认打开方式，再去翻域名配置。
五、AI 草稿这一段怎么接
侧边栏页面本身只是个前端入口，真正生成草稿要接你自己的服务：把当前会话里客户的头一段文字传给你的后端，后端生成候选回复，再回显到侧边栏的输入框里，由销售复制或点发送。三条经验：
如果不想自己从域名验证到 JS-SDK 一路配下来，市面上有已经把这条链路做好的成品，微客AI助手做的就是企业微信侧的这类辅助回复能力，可以直接拿来用。但从自建的角度走一遍上面五步，你会更清楚哪一环才是真正卡你的——多数企业卡在域名归属验证和「浏览器里打不开身份」这两处，而不是模型本身。
参考：
- 私域客服与自动回复的实操记录：https://dingdang.asia/microai/articles/
- 常见问题与边界说明：https://dingdang.asia/faq.html
评论前必须登录！
注册