PolyAI 中文文档 下载 App

部署不生效:改了配置但客户还是看到旧版本

问题现象

  1. 你在 Sandbox 里改了欢迎语 → Publish → Deployments 显示 Live 已更新
  2. 你用 Staging 的测试号码打进去,听到的是新欢迎语 ✓
  3. 客户用生产号码打进去,听到的还是旧欢迎语 ✗

排查路径

第一步:确认 Publish 真的成功了

打开 Deployments → Live history,看:

如果 diff 里没有你改的内容,说明 Publish 过程中有问题(可能是合并冲突没解决、或 Branch 没正确 Push 回去)。回到 Studio 或 ADK 重新操作一遍。

第二步:检查号码绑定到哪个环境

最常见的"部署不生效"原因——你改了 A 环境,但生产号码绑定在 B 环境。

打开 Voice → Numbers,逐个看每个号码绑定的环境(Sandbox / Staging / Live):

号码绑定环境你的 Publish 环境结果
+1 (800) XXX-XXXX(生产号码)LiveLive✓ 生效
+1 (800) XXX-XXXX(生产号码)StagingLive✗ 不生效!生产号码还在 Staging

这种情况的原因通常是:新开通项目时默认 Staging,后来忘了切到 Live;或者之前做测试时临时改了号码绑定,测试完忘了切回去。

修复:把生产号码从 Staging 切到 Live。这个改动实时生效,不需要重新 Publish。

第三步:检查是不是多环境 / 多项目混淆

复杂场景下(多个项目、多个 Apex 号码)容易搞混:

混淆场景检查
多个项目,改了项目 A 但客户打的号码属于项目 B确认号码 → 项目 → 环境的完整映射
同一个 PolyAI 集群里多个客户账户检查登录的账户对不对
号码从 PolyAI 购买的 vs 外部 Port-in 的外部号码的路由可能还在旧平台上,需要确认转发目标

第四步:真实号码延迟(极少见)

极罕见的情况:生产号码的路由更新有延迟(Twilio / Vonage / 运营商那边需要同步),可能需要几分钟到几十分钟。等 15-30 分钟后再测试,如果还是不生效联系 PolyAI 技术支持。

部署生效的快速验证方法

每次 Publish 后,按这个顺序快速验证:

  1. 看 Deployments → Live history 最新版本时间戳 ✓ → 进入步骤 2
  2. Voice → Numbers 确认生产号码绑定 Live ✓ → 进入步骤 3
  3. 用生产号码打一个测试电话,听欢迎语或问一个刚改过的 FAQ → 确认生效

三步走完,99% 的部署问题都能定位。