美洽怎么设置访客端聊天窗口免密登录开关？
在美洽管理后台，进入【设置/渠道管理】—选择对应的聊天渠道（网站/小程序/APP）—在该渠道的访客或聊天窗口设置里找到“免密登录/访客识别”开关并开启，按提示填写签名密钥、允许域名和token有效期后保存并发布，前端需将用户标识或后端签名一起传给美洽完成免密识别；上线前务必测试并确认安全和隐私配置到位，开启日志审计。
先把概念讲清楚：什么是“访客端聊天窗口免密登录”
先想象一个场景：用户访问你的官网，点开客服小窗，不想再输入手机号或注册就能被识别为“同一人”，这样客服能看到过往对话、偏好、订单信息。这个过程，通常就叫“免密登录”——通过前端或后端把某种可验证的标识（token、签名、openid等）传给客服系统，让系统在不要求用户再次输入密码或验证码的情况下识别访客。
美洽里的免密登录，核心就是让访客端（网页、小程序、APP嵌入的聊天组件）和美洽后台建立一种受控的“信任传递”方式。你把一个由后端生成、带签名的标识交给前端，前端带着它挂载在聊天窗里（或通过SDK传参），美洽收到后就把会话与该用户绑定。
在美洽后台大致在哪儿设置？（一步步跟着做）
各公司后台界面会有小差别，别紧张，按下面的逻辑去找就能找到开关：登录美洽控制台 → 找到“设置/渠道/渠道管理/网站聊天窗” → 进入你要启用的渠道配置页 → 查找“访客识别/免密登录/免注册登录”相关选项 → 开启并配置。
- 登录：用管理员账号登录美洽管理后台（控制台）。
- 定位渠道：左侧通常有“设置/渠道/渠道管理/产品”之类的菜单，选择你嵌入聊天窗的渠道（网站、微信小程序、APP）。
- 打开访客设置：在该渠道的设置页里查找“访客识别”、“访客信息”、“免密登录”或“匿名/免登”等条目。
- 开启开关：通常是一个开关按钮，打开后页面会要求你填写签名密钥、token 时效、允许域名等参数。
- 保存并发布：保存配置后，某些渠道还需要“发布/重新部署/刷新脚本”才能让前端生效。
必须配置的项目（表格说明）
| 配置项 | 含义 | 建议/示例 |
| 开关状态 | 是否启用免密登录 | 开启（测试环境先开启） |
| 签名密钥（secret） | 后端用来对token或参数签名的密钥 | 长度≥32，存后端，不在前端暴露 |
| token 有效期 | 该标识的时效，过期需重新生成 | 短一点更安全，建议 5-60 分钟视场景而定 |
| 允许域名/白名单 | 只允许指定来源域名发起免密请求 | 严格列出你的网站/子域名 |
| 回落验证方式 | 免密失败时的备用方案（短信/验证码） | 建议开启短信或弹窗提示 |
| 数据映射字段 | 把 token 解出后与哪些用户属性对应 | name、email、user_id、order_id 等常见字段 |
具体怎么实现免密登录（技术思路，费曼式解释）
用一句通俗话说：后端发“证明”，前端拿“证明”去找美洽，证明是真的，美洽就信任你。
1) 后端生成带签名的 token（或签名串）
- 后端基于用户 ID、时间戳、过期时间、随机数等，拼成一段数据，然后用 secret 做 HMAC-SHA256 签名，得到签名串。
- 最终把 payload + signature 发给前端。这样即使 payload 被篡改，签名校验会失败。
2) 前端把 token 传给美洽
- 如果用美洽提供的网页脚本，通常支持初始化时传入 visitor 信息或 token 参数；SDK 也有对应接口。
- 请确保通过 HTTPS 传输，避免在 URL 参数暴露 token（最好放在初始化脚本的配置或通过后端代理注入）。
3) 美洽后台验证 token 并绑定用户
- 美洽根据你在控制台配置的签名密钥和规则做校验，校验通过就把会话关联到该访客 ID，并把映射的属性显示给客服。
- 若校验失败，美洽会走回落流程（如要求输入手机号或显示匿名访客）。
测试步骤（建议按这个顺序走）
- 在一个测试环境域名上开启免密登录，不要直接在生产上试。
- 用开发者工具或后端接口生成一个 token（按后台配置的签名规则）。
- 在本地网页上嵌入美洽脚本，初始化时带上 token，打开页面观察控制台与网络请求。
- 在美洽客服端后台观察是否能识别到访客 ID、用户属性与历史会话。
- 尝试修改 token（篡改签名或过期）确认回落逻辑与错误提示生效。
常见问题与排查技巧
- 开了开关但无效：检查是否忘记“保存并发布”、脚本是否为最新版本、域名是否在白名单内。
- 前端传了 token 后仍显示匿名：看美洽后台的验签失败日志，确认签名密钥一致、时间戳无误、payload 字段名和映射规则匹配。
- 跨域或 cookie 问题：如果你的站点跨子域或使用第三方 Cookie，注意浏览器的 SameSite 和 third-party cookie 策略。
- 并发问题：短期内大量校验请求可能触发限流或签名校验超时，检查 token 有效期设置与服务器时间同步。
安全与合规注意事项（别跳过）
免密登录虽然用户体验好，但带来的风险也真实存在。下面是一些必须遵守的原则，实践中别偷懒：
- 密钥放后端：签名密钥不要放前端或公开仓库，只能存后端。
- 短时有效：token 的有效期设短一点，敏感操作（改密码、支付）仍需二次验证。
- 只信白名单来源：限定允许发起免密的域名、IP，减少被恶意站点滥用风险。
- HTTPS 全程：所有传输都要用 HTTPS，避免中间人窃取 token。
- 日志审计：开启相关日志和告警，记录免密登录的成功/失败事件，定期审计异常。
- 隐私合规：遵守相关法律法规（如 GDPR/中国个人信息保护法等），告知用户并在必要时获得同意。
生产环境部署与运维建议
- 分阶段上线：先在内测域名试验，再小范围灰度，最后全面开启。
- 监控指标：设置免密登录成功率、验签失败率、异常来源 IP 的监控与告警。
- 回滚策略：一旦发现安全问题，能迅速在美洽控制台关闭开关并调整白名单/密钥。
- 文档与培训：将免密登录流程写入运维手册，客服也要知道失败时如何核实访客身份。
小结一下我在脑子里走的流程（随手记）
基本上就是三步：后台打开并配置 → 后端生成签名并交给前端 → 前端把签名告诉美洽，等待美洽验签绑定。过程中不断测试、看日志、微调过期和白名单。别忘了安全和合规，工作不是只做能用就完，得把风险也管了。
如果你现在就要动手，先在美洽控制台找“渠道”或“访客识别”相关设置，开启开关，用一个短时 token 试验，看到会话被正确识别再放开到生产。写着写着想起还有很多细节，但大体就是这套流程，边做边改，不要一次性把所有东西都上线。