Appearance
浏览器兼容性
什么样的设备和浏览器打得开对话链接，打不开时是什么表现。
客户的设备能不能打开聊天窗
这些年正常在用、更新过的设备都打得开。打不开的是十年前的老手机和还在用 IE 的老电脑，在今天的客户里是极少数。
| 客户用的是 | 是否支持 |
|---|---|
| Windows 10、Windows 11 电脑 | 支持。系统自带的 Edge 会自动更新 |
| Windows 7、8 电脑，装了 Chrome 或 Edge | 支持，版本远超要求 |
| Windows 7 电脑，只用 IE 浏览器 | 不支持。IE 全系列都打不开，让客户换 Chrome 或 Edge |
| 苹果电脑 | 支持。macOS 10.13（2017 年）及以后都没问题 |
| iPhone、iPad | iPhone 6s（2015 年秋）及以后支持 |
| 安卓手机 | 基本都支持，见下面这段 |
| 微信、QQ 里直接点开 | 支持 |
再老的 iPhone 系统停在 iOS 12，打不开；Windows 7 上的 Chrome 和 Edge 虽然 2023 年初就停止更新了，那个版本仍远超要求。
安卓手机看的是浏览器版本，跟系统是安卓几关系不大。安卓上的浏览器自己会更新，哪怕是 2016 年前后的老机器，系统早就不再升级，浏览器版本也远远超过要求。真正打不开的，是那种搁了很多年没开过机、浏览器从没更新过的设备。
版本过低时客户看到的是什么
聊天窗根本不出现，页面其他部分照常显示。
这种情况容易被误判成接入代码装错，其实代码那边完全正常。判断方法是让客户换一个浏览器打开同一个地址：能出现就是浏览器版本的问题，让他升级浏览器或者换台设备。
具体的版本要求
这张表可以直接给技术人员做兼容性评估。
| 浏览器 | 最低版本 | 该版本发布时间 |
|---|---|---|
| Chrome、Edge | 80 | 2020 年 2 月 |
| Firefox | 74 | 2020 年 3 月 |
| Safari（电脑） | 13.1 | 2020 年 3 月 |
| Safari（iPhone、iPad） | iOS 13.4 | 2020 年 3 月 |
| Internet Explorer | 全系列不支持 | — |
这条线来自聊天窗使用的 JavaScript 语法标准（ES2020）。按 caniuse.com 的全球统计，满足要求的浏览器占 94% 上下，剩下的多是功能机和十年前的老设备，估算覆盖面时可以按这个数算。
语音消息的门槛比这更高
聊天窗打得开，不代表客户就能按住说话。 录语音用的是浏览器的录音能力，它比聊天窗本身多两道要求，任何一道不满足，麦克风按钮直接不出现 —— 不报错、不提示，看上去就像这个功能没开。
第一道：页面必须是 HTTPS。 浏览器只允许安全网页调用麦克风，http:// 开头的地址连申请权限的机会都没有。这是浏览器的硬规定，合从这边放不开，唯一的办法是把网站换成 HTTPS。
需要注意的是，用 localhost 在本机调试时浏览器视同安全环境，语音是正常的。所以「本地测好好的，上线就没了」这个现象，八成就是线上还在跑 HTTP。
第二道：浏览器要够新。 录下来的音频要能压成合从统一使用的格式，各家浏览器支持这个格式的时间比支持聊天窗晚了好几年。
| 浏览器 | 能不能录语音 |
|---|---|
| Chrome、Edge | 120 及以上可以（2023 年 12 月） |
| Safari（电脑、iPhone、iPad） | 14.5 及以上可以（2021 年 4 月） |
| Firefox | 全版本都不行，实测到 2026 年的最新版仍不支持这个格式 |
用 Firefox 的客户看不到麦克风按钮，其他消息类型不受影响，让他打字或者换个浏览器即可。
排查顺序固定为三步：先在 设置 > 渠道管理 > 聊天窗口 确认语音消息没关（默认是「仅手机」，所以电脑上没有按钮属于正常），再确认网站地址是 https:// 开头，最后看浏览器版本。
换了浏览器还是不出现
那就不是兼容性的问题。页面本身打不开、白屏、或者聊天窗一直转圈，都属于另外的成因，按故障排查逐项对照。