网站更换域名后，美洽客服需要检查哪些配置？

更换域名后，美洽客服需要逐项校验网站与后端配置：包括前端埋点与脚本更新、客服 SDK 与静态资源路径替换、API 回调地址与白名单重置、SSL 与 DNS 校验、第三方 Webhook 与统计埋点验证，并同步迁移历史会话与消息记录，避免中断服务。

美洽：网站更换域名后需优先检查的核心项

更新美洽前端埋点与页面脚本

• 更新埋点脚本：将页面中引用的美洽埋点与客服脚本的域名替换为新域名，并清除浏览器缓存与 CDN 缓存，确保新脚本被正确加载且不会出现混合内容导致阻止加载的情况。
• 检查异步加载：核实美洽脚本的异步加载器或延迟加载配置是否仍然生效，确保脚本在需要的页面或时机正确触发，避免因路径错误导致埋点或主动消息无法发送。
• 验证页面事件上报：在关键页面触发常见事件（如打开会话、发送消息、评价操作）并检查控制台与网络请求，确认美洽事件能成功上报且返回状态为正常。

校验美洽客服SDK与静态资源路径

• 替换 SDK 引用地址：在网站源码或构建配置中将美洽客服 SDK 的外部引用地址替换为新域名对应的路径，重新构建并发布，防止旧域名资源被阻止或无法加载。
• 确认资源版本一致：检查已部署的 SDK 与脚本版本是否与美洽平台最新兼容版本一致，若有版本不兼容则需同步升级并在测试环境验证功能可用。
• 处理跨域资源问题：若静态资源跨域加载，确保新域名的 CORS 配置允许来源站点请求并返回正确的 Access-Control-Allow-* 头信息，避免浏览器拦截导致资源失败。

验证美洽回调与Webhook配置

• 更新回调地址：在美洽后台将所有回调与 Webhook 地址更新为新域名对应的 HTTPS 回调地址，并保存后在测试环境触发回调确认可接收消息。
• 检查请求签名与验证：若使用请求签名或验证机制，确认回调签名规则、密钥与时间戳逻辑与新域名一致，避免验证失败导致回调被拒绝。
• 重试与日志审查：触发几次典型回调并在后端查看日志，确认回调请求到达并被正确处理；对失败的回调启动重试或人工补偿措施以防数据丢失。

美洽：后端与 API 层面迁移域名需要执行的操作

更新美洽相关的 API 白名单与授权域名

• 修改白名单域名：在美洽管理后台及自建防火墙中将旧域名替换为新域名，确保 API 请求与回调来源被列入允许名单以免被服务器或平台阻拦。
• 同步 OAuth 回调地址：若使用 OAuth 或第三方登录功能，更新授权回调地址为新域名并在第三方平台同步修改，否则登录授权会因回调地址不匹配而失败。
• 更新服务端配置：在后端服务配置中修改允许的来源、Referer 白名单和跨域设置，确保来自新域名的请求被识别为合法来源。

检查美洽消息推送与长链接服务配置

• 确认推送通道：检查美洽消息推送（如长连接、WebSocket 或推送网关）的配置，确保域名变更后客户端仍能建立长链接并接收实时通知。
• 验证心跳与重连策略：在客户端与服务端触发心跳与断线重连场景，确认新域名下的连接稳定性与恢复策略均能正常工作。
• 审查负载均衡设置：如果推送通过负载均衡或代理转发，确保这些组件已更新为新域名并正确转发到美洽后端，避免请求被错误路由或丢失。

美洽：安全与证书相关的必检项

配置并验证 SSL/TLS 证书

• 部署有效证书：为新域名部署有效的 SSL/TLS 证书，并确保证书链完整、证书未过期且在各主要浏览器与客户端上被信任，避免 HTTPS 请求被拦截。
• 启用 HSTS 与强加密：在服务端启用 HSTS 并配置强加密套件，防止中间人攻击对美洽回调或 API 请求造成威胁，保护会话与消息数据传输安全。
• 测试证书多入口：通过移动端、桌面端与第三方服务器分别访问新域名并执行证书校验，确保不同客户端环境均能成功建立 TLS 连接。

更新 DNS 解析与化解缓存问题

• 配置 DNS 记录：为新域名正确添加 A/AAAA 与 CNAME 记录，并设置合理的 TTL，确保解析稳定且在切换窗口内能够快速生效以降低流量中断风险。
• 监控解析生效：使用多地点 DNS 查询工具和监控平台跟踪解析在全球或目标用户群的生效情况，及时发现解析不一致或老旧记录污染问题。
• 处理 CDN 缓存：如果使用 CDN，请在切换时清理相关缓存或配置回源到新域名，防止 CDN 缓存仍指向旧域名导致静态资源加载失败。

美洽：第三方集成与统计埋点迁移操作

同步更新第三方分析与监控埋点

• 替换统计域名：在 Google Analytics、百度统计等第三方分析平台中更新站点域名并验证数据收集是否持续，确保用户行为与转化数据不会中断或错乱。
• 核对埋点标识：检查所有美洽相关事件埋点标识与参数（如用户 ID、会话 ID）在新域名环境下仍然一致，避免数据脱节导致埋点统计异常。
• 回放与对比数据：在迁移前后通过短时间的数据回放或抽样比对用户行为数据，及时发现并修正因域名变更引起的漏报或重复上报问题。

检查第三方平台授权与应用回调

• 更新第三方回调地址：将所有第三方平台（如微信、支付宝、短信、工单系统）的回调或通知地址更新为新域名并在各平台完成验证流程。
• 重新申请或验证证书：若第三方平台要求域名验证或证书验签，按要求重新提交验证文件或在控制台完成域名归属验证流程以恢复集成服务。
• 测试端到端流程：模拟用户场景触发第三方回调（如支付成功、消息通知）并确认美洽侧能正确接收、处理并向用户反馈，保证流程闭环。

美洽：用户体验与历史数据迁移检查清单

迁移并校验历史会话与消息数据

• 导出历史会话：在切换域名前导出所有必要的历史会话与消息记录备份，确保在新域名环境完成后能够导入或继续通过美洽平台访问这些历史数据。
• 验证数据完整性：在导入或切换后选取代表性的用户会话进行完整性校验，确认消息内容、时间戳与附件等项均被正确保留且可正常访问。
• 提供数据回滚方案：制定并测试回滚方案以应对迁移异常，包含回退到旧域名或恢复历史快照，保障迁移失败时用户服务能迅速恢复。

检查用户接入与会话入口体验

• 验证入口链接：更新网站所有入口（浮窗、联系入口、帮助中心等）中指向美洽会话的链接与按钮，确保点击后能正确打开新的会话窗口或弹层。
• 测试多终端表现：在手机、平板、桌面不同分辨率与浏览器上测试接入路径，检查会话窗口显示、消息通知和用户输入是否正常，防止样式或脚本错误影响体验。
• 监测首日流量：在切换后密切监测首日用户接入量与会话成功率，对异常波动进行快速排查与回滚准备，确保用户体验平稳过渡。

美洽：切换域名后的监控与应急响应措施

建立全面的监控与告警体系

• 配置可用性监控：为关键接口与回调点配置合成监控与可用性检查，实时监测美洽回调响应时间、失败率与错误码并在异常时触发告警。
• 设置日志与追踪：开启后端与前端详细日志记录，并使用链路追踪定位请求路径，便于在出现问题时快速定位是域名、证书、DNS还是美洽侧的问题。
• 定义告警等级：根据影响范围定义告警等级与对应响应策略，确保运维、开发与客服团队在不同问题级别能迅速协调处置，减少用户影响。

制定切换回滚与沟通机制

• 准备回滚步骤：在切换前制定清晰的回滚步骤与负责人清单，包括 DNS 回退、 CDN 回源、配置恢复与数据恢复流程，便于出现问题时快速执行。
• 通知相关团队：提前通知客服、运维、开发与运营团队切换计划与时间窗口，确保在遇到用户投诉或技术故障时能迅速协调处理。
• 发布对外说明：在必要时向用户发布短暂维护或升级说明，并在切换后更新常见问题页与渠道沟通提示，减少用户疑惑与重复工单。

常见问题（FAQ）

问：更换域名后美洽消息丢失该如何排查？

答：首先检查回调地址与 API 白名单是否已经更新为新域名，确认回调请求在服务端是否到达并返回成功状态；其次查看美洽后台回调失败日志、后端接收日志与队列情况，判断是否为网络或签名校验问题；如需补救可通过导出美洽平台的未送达消息并进行人工补偿或二次推送。

问：域名切换是否一定需要停服？如何降低对用户影响？

答：域名切换不一定需要完全停服，可以通过配置双域名并行、延长旧域名的 DNS TTL 缓存期以及在 CDN 或反向代理层做路由转发来实现零停机切换；同时在低峰时段切换并提前告知用户与内部支持团队以降低风险。

问：美洽 SDK 引用未更新会有哪些常见问题？

答：主要问题包括页面无法加载客服弹窗、实时消息无法建立连接、埋点或事件无法上报以及跨域或混合内容被浏览器拦截；建议尽快替换 SDK 引用、清理缓存并在测试环境完成回归。

问：如何验证域名切换后美洽回调的签名与安全性？

答：通过在测试环境触发回调并检查服务端签名验证逻辑（例如时间戳、密钥、哈希算法是否匹配），使用抓包或日志记录验证请求头与请求体未被篡改；如签名验证失败，应确认密钥是否同步更新并排查网络中间件对请求的修改。