Cenaly Phone:为什么不响——检查发现的问题
Cenaly Phone 会自行监控电话是否已准备好接听来电,并将情况告知门店管理员。当有东西造成阻碍——麦克风被禁用、电池让应用休眠、网络不允许连接 PBX、电话不在外呼计划中——检查会指出问题,用通俗的语言解释,并提示该怎么做。这里汇总了它能发现的全部问题:每个问题都对应应用和管理后台中“详情”链接指向的页面。
工作原理#
电话自行向 PBX 汇报。 应用会发送一份简短的状态报告:权限(麦克风、通知、全屏来电、通话账户)、电源(电池模式、流量节省、省电模式)、push 唤醒(是否有唤醒地址以及它何时到达)、网络类型和 VPN、在 PBX 上的注册状态。报告会在应用启动时、权限或电池模式变化时、注册出错时、每次检查后、每 6 小时一次以及管理员请求时发送。没有网络时,报告会等待,等连接恢复后再发送。
云端会将电话的说法与 PBX 看到的情况进行比对。 例如,电话认为自己在线,而 PBX 却看不到它——这是一个单独的问题。结果是一份来自统一目录的问题列表:电话、管理后台和本文中使用相同的代码和文本。
按管理员请求检查通道。 在设备卡片中有 “从电话检查连接” 按钮。电话在后台只执行网络步骤:DNS、与 PBX 建立 TCP/TLS 连接、SIP OPTIONS 请求、STUN(外部地址和 NAT 类型)、TURN(音频中继)、时钟校准和权限快照。不使用麦克风,也不拨打电话,不超过 30 秒。限制——每台设备每分钟最多一次,每天最多 20 次检查。结果会实时出现在管理后台;员工会在通话记录中看到一条记录“应管理员请求检查连接,12:03”。电话 90 秒内未响应——管理后台会如实显示“电话未响应:应用被系统关闭或没有网络”。
从电话获取日志。 “从电话请求日志” 按钮会要求应用导出运行日志和重连原因——供支持人员排查。每天最多 5 次请求;密码不会进入日志。
员工也可以自行启动同样的检查:“通话帮助” → “检查连接”。在这个界面上还能看到应用发送给管理员的内容(“管理员看到的状态 · 发送于 12:03”)。
电话不会收集什么#
报告是为了通话,而不是为了监视。应用不会发送:Wi‑Fi 网络名称(SSID)、地理位置、本地 IP 地址、电话号码和联系方式、已安装应用列表。会发送:电话型号、系统和应用版本、网络类型(Wi‑Fi、蜂窝、Ethernet、VPN)和外部 IP 地址——也就是 PBX 在连接时本来就能看到的那个。报告会保存到设备断开连接为止,并随设备一起删除。
如何阅读问题描述#
| 图标 | 含义 |
|---|---|
| 🔴 通话无法使用 | 在修复之前,无法从这台电话正常拨打电话,或来电无法到达 |
| 🟠 通话时断时续 | 通话可以使用,但部分可能丢失或音质很差 |
| ℹ️ 仅供参考 | 通常不影响通话,多数情况下无需操作 |
来源会提示到哪里找原因:电话——电话本身的设置,网络——从电话到 PBX 的路径(Wi‑Fi、路由器、运营商、VPN),PBX——门店的 PBX 及其在“电话”中的设置。
每个问题都有两条建议:员工该做什么(持有电话的人会看到),以及管理员该做什么(管理员在管理后台会看到)。如果可以在电话上直接打开所需设置,问题旁边会有 “修复” 按钮。
电话已连接,但打不进来#
最棘手的情况:应用显示绿色,“打给我”检查通过,但群组来电和同事的电话却到不了这台电话。常见原因是员工有个人外呼计划,而新电话在其中没有获得条目。PBX 只拨打计划中的内容:没有计划条目的连接,它不会拨打,也不会用 push 通知唤醒。“打给我”此时会直接拨打这台电话,绕过计划,所以能通过。现在应用在这种情况下会说实话:声音检查通过了,但群组来电不会打到这里,检查会显示问题“电话不在外呼计划中”。
管理员该做什么:
- “电话” → “分机”,Cenaly Phone 自助服务区块——设置 “来自应用的电话——始终拨打”。默认开启:当员工连接 Cenaly Phone 且已有个人计划时,电话会立即在计划中获得“始终拨打”条目。付费号码(外部和上级)永远不会这样自动添加。
- 对于更早连接的手机——在同一位置使用 “将已连接的手机加入计划……”:会先显示将要更改的列表,确认后才会应用。
- 或者单独处理:员工连接窗口 → 电话条目旁有警告和 “加入计划” 按钮,然后点击“保存”。
您之后自行修改过的条目(例如,电话仅在工作时间响铃),重新连接同一台电话不会覆盖它。
所有代码一览#
代码可在支持报告中和管理后台看到。点击名称即可跳转到问题说明。
| 代码 | 问题 | 严重程度 | 所属方 |
|---|---|---|---|
mic_denied |
无麦克风访问权限 | 🔴 电话无法使用 | 手机 |
notifications_off |
通知已关闭 | 🔴 电话无法使用 | 手机 |
fullscreen_intent_denied |
来电未全屏显示 | 🟠 电话时断时续 | 手机 |
battery_optimized |
电池优化限制应用 | 🟠 电话时断时续 | 手机 |
bg_restricted |
禁止后台运行 | 🔴 电话无法使用 | 手机 |
standby_restricted |
系统很少唤醒应用 | 🟠 电话时断时续 | 手机 |
data_saver_on |
已开启流量节省 | 🟠 电话时断时续 | 网络 |
telecom_account_disabled |
通话账户已关闭 | 🔴 电话无法使用 | 手机 |
dnd_active |
已开启“勿扰模式” | 🟠 电话时断时续 | 手机 |
ios_bg_refresh_off |
后台刷新已关闭 | ℹ️ 仅供参考 | 手机 |
ios_low_power |
低电量模式 | ℹ️ 仅供参考 | 手机 |
ios_cellular_data_off |
无蜂窝数据访问权限 | 🟠 电话时断时续 | 网络 |
voip_push_missing |
iPhone 未收到通话地址 | 🔴 电话无法使用 | 手机 |
push_token_missing |
无唤醒地址 | 🟠 电话时断时续 | 手机 |
push_not_delivered |
唤醒未送达 | 🟠 电话时断时续 | 手机 |
clock_skew |
手机时间不正确 | 🟠 电话时断时续 | 手机 |
app_outdated |
应用已过时 | 🟠 电话时断时续 | 手机 |
report_stale |
手机长时间未上报 | 🟠 电话时断时续 | 手机 |
fgs_start_blocked |
系统不允许启动通话服务 | 🔴 电话无法使用 | 手机 |
process_frozen |
系统冻结应用 | 🟠 电话时断时续 | 手机 |
low_memory_kills |
应用因内存不足被关闭 | ℹ️ 仅供参考 | 手机 |
no_network |
无互联网连接 | 🔴 电话无法使用 | 网络 |
captive_portal |
网络需要登录 | 🔴 电话无法使用 | 网络 |
dns_fail |
未找到 PBX 地址 | 🔴 电话无法使用 | 网络 |
pbx_tcp_unreachable |
此网络无法访问 PBX | 🔴 电话无法使用 | 网络 |
tls_pin_mismatch |
PBX 证书不匹配 | 🔴 电话无法使用 | 网络 |
tls_handshake_fail |
安全连接失败 | 🔴 电话无法使用 | 网络 |
register_timeout |
PBX 无响应 | 🔴 电话无法使用 | 网络 |
high_rtt |
到 PBX 的延迟过高 | 🟠 电话时断时续 | 网络 |
packet_loss |
丢包 | 🟠 电话时断时续 | 网络 |
turn_unreachable |
音频中继不可用 | 🟠 电话时断时续 | 网络 |
relay_media_blocked |
音频无法通过中继传输 | 🟠 电话时断时续 | 网络 |
symmetric_nat |
严格 NAT | ℹ️ 仅供参考 | 网络 |
vpn_active |
已开启 VPN | ℹ️ 仅供参考 | 网络 |
public_ip_mismatch |
手机地址与 PBX 不一致 | 🟠 电话时断时续 | 网络 |
signaling_via_relay |
通过备用通道通信 | ℹ️ 仅供参考 | 网络 |
media_via_turn |
音频通过中继传输 | ℹ️ 仅供参考 | 网络 |
signaling_fallback_failed |
备用通道未起作用 | 🟠 电话时断时续 | 网络 |
media_fallback_failed |
音频即使通过中继也未传输成功 | 🟠 电话时断时续 | 网络 |
pbx_offline |
门店 PBX 未连接 | 🔴 电话无法使用 | PBX |
connection_disabled |
设备已被管理员关闭 | 🔴 电话无法使用 | PBX |
not_in_ring_plan |
手机不在外呼计划中 | 🔴 电话无法使用 | PBX |
sip_auth_failed |
PBX 拒绝登录 | 🔴 电话无法使用 | PBX |
register_rejected |
PBX 拒绝注册 | 🔴 电话无法使用 | PBX |
phone_says_registered_pbx_not |
PBX 未看到注册 | 🟠 电话时断时续 | PBX |
pbx_registered_phone_not |
PBX 保留旧注册 | ℹ️ 仅供参考 | PBX |
pbx_rejected_access |
PBX 不允许从此地址或程序访问 | 🔴 电话无法使用 | PBX |
pbx_ip_blocked |
手机地址已被 PBX 封锁 | 🔴 电话无法使用 | PBX |
reg_gaps |
与 PBX 长时间无连接 | 🟠 电话时断时续 | 网络 |
vpn_detected |
通过 VPN 或主机托管连接 | ℹ️ 仅供参考 | 网络 |
push_wake_off |
唤醒未工作 | 🟠 电话时断时续 | 手机 |
nat_udp_unreachable |
UDP 来电无法到达设备 | 🔴 电话无法使用 | 网络 |
sip_alg_suspected |
路由器干扰 SIP(SIP ALG) | 🔴 电话无法使用 | 网络 |
vendor_power_killer |
手机系统关闭应用 | 🟠 电话时断时续 | 手机 |
registration_flapping |
与 PBX 的连接不断中断 | 🟠 电话时断时续 | 网络 |
ice_failed |
音频未连接 | 🟠 电话时断时续 | 网络 |
no_audio_to_phone |
对方声音未传到手机 | 🟠 电话时断时续 | 网络 |
no_audio_from_phone |
您的声音未传到对方 | 🟠 电话时断时续 | 网络 |
mic_silenced_by_system |
系统静音了麦克风 | 🟠 电话时断时续 | 手机 |
loss_downlink |
对方声音断断续续 | 🟠 电话时断时续 | 网络 |
loss_uplink |
您的声音在对方处断断续续 | 🟠 电话时断时续 | 网络 |
wake_late |
手机唤醒接听来电耗时过长 | 🟠 电话时断时续 | 手机 |
wake_missed |
来电未到达休眠中的手机 | 🟠 电话时断时续 | 网络 |
voice_fx_overload |
降噪处理不及时 | 🟠 电话时断时续 | 手机 |
voice_fx_model_missing |
手机上无降噪方法 | ℹ️ 仅供参考 | 手机 |
voice_fx_plan_stale |
降噪设置为旧版本 | ℹ️ 仅供参考 | 手机 |
voice_fx_processor_down |
外部语音处理器不可用 | 🟠 电话时断时续 | PBX |
voice_fx_processor_slow |
外部语音处理器响应缓慢 | 🟠 电话时断时续 | 网络 |
权限与系统#
手机本身的设置:应用权限、电池模式、通知、推送唤醒、时钟和应用版本。这里几乎所有问题员工都能在一分钟内自行解决——“检查连接”屏幕上的“修复”按钮会打开相应的设置页面。
没有麦克风权限#
🔴 电话无法使用 · 方面:手机 · Android 和 iPhone · 代码 mic_denied
- 含义: 在修复之前,无法用这部手机正常通话,或者电话无法接通;原因在于手机本身或其设置。
- 员工操作: 授予应用麦克风权限:没有它对方听不到你。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 请员工在手机设置中授予 Cenaly Phone 麦克风权限。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”标签页;电话自检——“分机”**项。
通知已关闭#
🔴 电话无法使用 · 方面:手机 · 仅 Android · 代码 notifications_off
- 含义: 在修复之前,无法用这部手机正常通话,或者电话无法接通;原因在于手机本身或其设置。
- 员工操作: 开启应用通知:来电通过通知显示。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 请员工开启 Cenaly Phone 通知:没有它们,来电不会出现在屏幕上。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”标签页;电话自检——“分机”**项。
来电未全屏展开#
🟠 电话时断时续 · 方面:手机 · 仅 Android · 代码 fullscreen_intent_denied
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于手机本身或其设置。
- 员工操作: 允许“全屏通知”:否则在锁屏手机上,来电只会显示为通知栏中的一行。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 在锁屏手机上,员工可能注意不到来电:需要“全屏通知”权限。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”**标签页。
电池优化限制了应用#
🟠 电话时断时续 · 方面:手机 · 仅 Android · 代码 battery_optimized
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于手机本身或其设置。
- 员工操作: 为 Cenaly Phone 选择“无限制”电池模式,让手机不使应用休眠。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 员工的手机可能使应用休眠:请选择“无限制”电池模式。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”**标签页。
禁止后台运行#
🔴 电话无法使用 · 方面:手机 · 仅 Android · 代码 bg_restricted
- 含义: 在修复之前,无法用这部手机正常通话,或者电话无法接通;原因在于手机本身或其设置。
- 员工操作: Cenaly Phone 被设为“受限”电池模式:应用关闭时电话无法接通。请选择“无限制”。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 员工的应用被禁止后台运行:应用关闭时,来电会按计划转接到下一处。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”标签页;电话自检——“分机”**项。
系统很少唤醒应用#
🟠 电话时断时续 · 方面:手机 · 仅 Android · 代码 standby_restricted
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于手机本身或其设置。
- 员工操作: 打开应用并选择“无限制”电池模式:系统将其归为很少使用的应用。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 系统认为该应用很少使用,可能会延迟来电。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”**标签页。
已开启流量节省#
🟠 电话时断时续 · 方面:网络 · 仅 Android · 代码 data_saver_on
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于手机与 PBX 之间的网络。
- 员工操作: 允许 Cenaly Phone 不受限制使用流量,或关闭流量节省:否则后台没有连接。手机上有**“修复”**按钮——它会打开相应的设置。
- 管理员操作: 员工手机上的流量节省会切断应用的后台连接。
- 查看位置: 手机——“通话帮助” → “检查连接”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → **“手机报告”**标签页。
通话账户已关闭#
🔴 电话无法使用 · 侧:电话 · 仅 Android · 代码 telecom_account_disabled
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话本身或其设置。
- 员工: 在“通话账户”设置中启用 Cenaly Phone:否则系统不会放行电话。电话上有 “修复” 按钮——它会打开相关设置。
- 管理员: 电话系统中 Cenaly Phone 的通话账户已关闭——电话无法接通。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
“勿扰模式”已开启#
🟠 电话时断时续 · 侧:电话 · 仅 Android · 代码 dnd_active
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于电话本身或其设置。
- 员工: 电话的“勿扰模式”可能会屏蔽电话。请关闭它或将 Cenaly Phone 加入例外。电话上有 “修复” 按钮——它会打开相关设置。
- 管理员: 电话上开启了“勿扰模式”(系统级,非 PBX):电话可能无声到达。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
后台刷新已关闭#
ℹ️ 仅供参考 · 侧:电话 · 仅 iPhone · 代码 ios_bg_refresh_off
- 含义: 通常不影响电话,多数情况下无需操作;原因在于电话本身或其设置。
- 员工: 为 Cenaly Phone 启用“内容更新”:这样应用会及时上报自身状态。电话上有 “修复” 按钮——它会打开相关设置。
- 管理员: 不影响电话,但电话状态上报频率会降低。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
省电模式#
ℹ️ 仅供参考 · 侧:电话 · 仅 iPhone · 代码 ios_low_power
- 含义: 通常不影响电话,多数情况下无需操作;原因在于电话本身或其设置。
- 员工: 在省电模式下,iPhone 在后台联网的频率降低。这通常不影响电话。
- 管理员: iPhone 处于省电模式:报告上报频率降低。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
无蜂窝数据访问权限#
🟠 电话时断时续 · 侧:网络 · 仅 iPhone · 代码 ios_cellular_data_off
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于电话与 PBX 之间的网络。
- 员工: 允许 Cenaly Phone 使用蜂窝数据(设置 → 蜂窝网络):没有 Wi‑Fi 就无法通话。电话上有 “修复” 按钮——它会打开相关设置。
- 管理员: 应用被禁止使用蜂窝数据:离开 Wi‑Fi 后员工将无法联系。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
iPhone 未收到通话地址#
🔴 电话无法使用 · 侧:电话 · 仅 iPhone · 代码 voip_push_missing
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话本身或其设置。
- 员工: 在有网络的情况下打开应用:iPhone 需要获取来电地址。若无效——请重新安装应用。电话上有 “修复” 按钮——它会打开相关设置。
- 管理员: 员工的 iPhone 未注册来电地址:应用关闭时电话将无法到达。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
无唤醒地址#
🟠 电话时断时续 · 侧:电话 · 仅 Android · 代码 push_token_missing
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于电话本身或其设置。
- 员工: 应用未收到唤醒地址:只有在应用运行时电话才会到达。请在有网络的情况下打开它。
- 管理员: 电话未发送唤醒地址:只有应用打开时电话才能到达。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
唤醒未送达#
🟠 电话时断时续 · 侧:电话 · Android 和 iPhone · 代码 push_not_delivered
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在于电话本身或其设置。
- 员工: PBX 已唤醒电话,但信号未送达。请检查网络和电池模式,然后打开应用。
- 管理员: 电话的最后一次唤醒未送达:请检查员工的电池模式和网络。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍了电话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
手机时间不正确#
🟠 电话时断时续 · 侧:手机 · Android 和 iPhone · 代码 clock_skew
- 含义: 电话可以打通,但部分可能丢失或音质很差;原因在手机本身或其设置。
- 员工操作: 开启“网络日期和时间”:时间不正确会破坏安全连接和经中继器的语音。手机上有 “修复” 按钮——它会打开所需设置。
- 管理员须知: 手机时钟与准确时间的偏差超过一分钟。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页。
应用已过时#
🟠 电话时断时续 · 侧:手机 · Android 和 iPhone · 代码 app_outdated
- 含义: 电话可以打通,但部分可能丢失或音质很差;原因在手机本身或其设置。
- 员工操作: 更新 Cenaly Phone:此版本缺少必要的修复。手机上有 “修复” 按钮——它会打开所需设置。
- 管理员须知: 员工的 Cenaly Phone 版本过旧——请让其更新。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页。
手机长时间未上报#
🟠 电话时断时续 · 侧:手机 · Android 和 iPhone · 代码 report_stale
- 含义: 电话可以打通,但部分可能丢失或音质很差;原因在手机本身或其设置。
- 员工操作: 打开 Cenaly Phone 以更新状态。
- 管理员须知: 手机超过一昼夜未发送状态,尽管 push 已注册:应用可能已被休眠或删除。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页。
系统不允许启动通话服务#
🔴 电话无法使用 · 侧:手机 · 仅 Android · 代码 fgs_start_blocked
- 含义: 在修复之前,无法从此手机正常拨打电话,或电话无法到达此手机;原因在手机本身或其设置。
- 员工操作: 系统未允许 Cenaly Phone 在后台启动通话服务——应用关闭时电话无法到达。打开应用并为其解除电池限制。手机上有 “修复” 按钮——它会打开所需设置。
- 管理员须知: 员工手机的系统未允许应用在后台启动通话服务(例如重启后)——应用未打开时,电话会按计划转接下去。员工需打开应用并解除电池限制。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页;电话自检——“分机” 项。
系统冻结应用#
🟠 电话时断时续 · 侧:手机 · 仅 Android · 代码 process_frozen
- 含义: 电话可以打通,但部分可能丢失或音质很差;原因在手机本身或其设置。
- 员工操作: 手机未休眠,但 Cenaly Phone 被系统冻结——此时电话无法到达。允许自启动并解除电池限制(针对您手机的步骤见下文)。手机上有 “修复” 按钮——它会打开所需设置。
- 管理员须知: 员工手机的系统界面冻结应用,尽管手机未休眠——此时电话无法到达。员工需允许自启动并解除电池限制(按厂商的步骤在应用中)。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页。
应用因内存不足被关闭#
ℹ️ 仅供参考 · 侧:手机 · 仅 Android · 代码 low_memory_kills
- 含义: 通常不影响电话,多数情况下无需操作;原因在手机本身或其设置。
- 员工操作: 系统内存不足,在后台关闭了 Cenaly Phone。关闭占用大的应用或重启手机。
- 管理员须知: 员工手机内存不足,系统在后台关闭了应用。这不是设置问题:关闭占用大的应用或重启手机即可。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页。
通道与网络#
从手机到 PBX 的路径:互联网、DNS、安全连接、延迟与丢包、语音中继器(TURN)、VPN。这些问题的检查步骤会找出通道问题。几乎总是同一招管用——切换网络(Wi‑Fi ↔ 移动互联网):在另一网络下恢复,问题就在网络,而不在手机。
无互联网#
🔴 电话无法使用 · 侧:网络 · Android 和 iPhone · 代码 no_network
- 含义: 在修复之前,无法从此手机正常拨打电话,或电话无法到达此手机;原因在手机与 PBX 之间的网络。
- 员工操作: 将手机连接到 Wi‑Fi 或开启移动互联网。手机上有 “修复” 按钮——它会打开所需设置。
- 管理员须知: 员工手机没有互联网。
- 查看位置: 手机—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “手机上报” 标签页;电话自检——“分机” 项。
网络需要登录#
🔴 电话无法使用 · 方面:网络 · Android 和 iPhone · 代码 captive_portal
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话与 PBX 之间的网络。
- 员工: Wi‑Fi 要求通过认证页面登录。请打开浏览器登录,或更换网络。电话上有 “修复” 按钮——它会打开所需设置。
- 管理员: 电话处于需要页面认证的 Wi‑Fi 中:登录前无法与 PBX 通信。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
未找到 PBX 地址#
🔴 电话无法使用 · 方面:网络 · Android 和 iPhone · 代码 dns_fail
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话与 PBX 之间的网络。
- 员工: 电话无法找到 PBX 地址。请更换网络,或关闭私人 DNS/VPN。
- 管理员: 电话所在网络无法找到 PBX 地址(DNS):通常是私人 DNS 或网络过滤器所致。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
此网络无法访问 PBX#
🔴 电话无法使用 · 方面:网络 · Android 和 iPhone · 代码 pbx_tcp_unreachable
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话与 PBX 之间的网络。
- 员工: 网络不允许访问 PBX。请尝试用移动网络代替 Wi‑Fi,或请网络管理员开放端口 5060/5061。
- 管理员: 从电话所在网络无法建立与 PBX 的连接:场所防火墙或运营商拦截了 SIP 端口。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
PBX 证书不匹配#
🔴 电话无法使用 · 方面:网络 · Android 和 iPhone · 代码 tls_pin_mismatch
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话与 PBX 之间的网络。
- 员工: 安全连接被替换,或 PBX 更换了证书。请勿通过此网络连接;稍后再打开应用。
- 管理员: 电话看到了其他证书:网络中可能存在替换(代理、杀毒软件),或 PBX 已重建。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
安全连接失败#
🔴 电话无法使用 · 方面:网络 · Android 和 iPhone · 代码 tls_handshake_fail
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话与 PBX 之间的网络。
- 员工: 与 PBX 的安全连接中断。请检查电话的日期和时间,并更换网络。
- 管理员: 无法与 PBX 建立 TLS:网络干扰连接,或电话时钟不正确。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
PBX 无响应#
🔴 电话无法使用 · 方面:网络 · Android 和 iPhone · 代码 register_timeout
- 含义: 在修复之前,无法用此电话正常拨打电话,或电话无法接通;原因在于电话与 PBX 之间的网络。
- 员工: 注册未收到响应。请检查网络,更换网络,或关闭 VPN。
- 管理员: 电话注册无响应:网络丢包或拦截 SIP。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
到 PBX 的延迟过大#
🟠 电话时断时续 · 方面:网络 · Android 和 iPhone · 代码 high_rtt
- 含义: 电话可以使用,但部分通话可能丢失或音质不佳;原因在于电话与 PBX 之间的网络。
- 员工: 连接缓慢:可能出现停顿和回声。请靠近路由器,或切换到其他网络。
- 管理员: 到 PBX 的延迟超过 300 毫秒:通话会出现停顿。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
丢包#
🟠 电话时断时续 · 方面:网络 · Android 和 iPhone · 代码 packet_loss
- 含义: 电话可以使用,但部分通话可能丢失或音质不佳;原因在于电话与 PBX 之间的网络。
- 员工: 网络丢包:语音会中断。请更换网络。
- 管理员: 电话所在网络丢包:语音会中断。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
音频中继不可用#
🟠 通话不稳定 · 方面:网络 · Android 和 iPhone · 代码 turn_unreachable
- 含义: 通话可用,但部分通话可能丢失或音质不佳;原因在于电话与 PBX 之间的网络。
- 员工: 音频中继不可用:在严格网络下电话可以接通,但可能没有声音。请更换网络。
- 管理员: TURN 从电话所在网络无响应——是“能接通但没声音”的首要嫌疑。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,区块「什么在妨碍通话」;管理后台——「电话」→ 设备卡片 → **「电话报告」**标签页。
音频无法通过中继#
🟠 通话不稳定 · 方面:网络 · Android 和 iPhone · 代码 relay_media_blocked
- 含义: 通话可用,但部分通话可能丢失或音质不佳;原因在于电话与 PBX 之间的网络。
- 员工: 音频中继有响应,但音频无法从该网络通过中继——在严格网络下电话会接通但没有声音。请更换网络。
- 管理员: 从电话经 TURN 的音频探测:中继已分配,但数据包未能通过。电话网络放行信令交换,但拦截媒体——是“能接通但没声音”的首要嫌疑。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,区块「什么在妨碍通话」;管理后台——「电话」→ 设备卡片 → **「电话报告」**标签页。
严格 NAT#
ℹ️ 仅供参考 · 方面:网络 · Android 和 iPhone · 代码 symmetric_nat
- 含义: 通常不影响通话,多数情况下无需操作;原因在于电话与 PBX 之间的网络。
- 员工: 网络严格,音频将通过中继传输。无需操作。
- 管理员: 对称 NAT:音频经 TURN 传输,属正常情况。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,区块「什么在妨碍通话」;管理后台——「电话」→ 设备卡片 → **「电话报告」**标签页。
VPN 已开启#
ℹ️ 仅供参考 · 方面:网络 · Android 和 iPhone · 代码 vpn_active
- 含义: 通常不影响通话,多数情况下无需操作;原因在于电话与 PBX 之间的网络。
- 员工: 通话经 VPN 传输。如果连接质量差——请尝试关闭 VPN。
- 管理员: 电话通过 VPN 工作:地址和质量取决于 VPN。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,区块「什么在妨碍通话」;管理后台——「电话」→ 设备卡片 → **「电话报告」**标签页。
电话与 PBX 的地址不一致#
🟠 通话不稳定 · 方面:网络 · Android 和 iPhone · 代码 public_ip_mismatch
- 含义: 通话可用,但部分通话可能丢失或音质不佳;原因在于电话与 PBX 之间的网络。
- 员工: 网络会改变连接地址(代理、两个运营商或路由器的 SIP ALG)。如果没有声音——请更换网络。
- 管理员: 通过 STUN 获取的公网 IP 与在 PBX 注册的地址不一致:代理、双 WAN 或 SIP ALG。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,区块「什么在妨碍通话」;管理后台——「电话」→ 设备卡片 → **「电话报告」**标签页。
备用通道#
如果从网络到 PBX 的直连路径被阻断,电话会自动切换到备用通道:信令通过端口 443 上的加密通道,声音通过中继服务器。这是两个独立的层:“通过备用通道通信”说的是通话和注册,“通过中继服务器传输声音”只涉及声音。正常切换不是故障:电话可以正常使用,电话会自动回到直连路径。只有备用通道也无效时才是问题。
通过备用通道通信#
ℹ️ 提示 · 来源:网络 · Android 和 iPhone · 代码 signaling_via_relay
- 含义: 通常不影响通话,多数情况下无需操作;原因在于电话与 PBX 之间的网络。
- 员工: 从该网络到 PBX 的直连路径不可用,电话已自动切换到备用通道——通话照常进行。无需任何操作:直连路径恢复后,电话会自动切回。
- 管理员: 信令通过我们的 WSS 中继(端口 443)传输,而非直接走 TLS 5061:电话所在网络封锁了直连端口。通话正常;如果该门店有多部电话出现此情况,请检查办公室网络是否拦截了出站 5061。
- 查看位置: 电话端——「通话帮助」→ 「连接检查」,“什么在妨碍通话”区块;管理后台——「电话」→ 设备卡片 → **「电话上报」**标签页。
通过中继服务器传输声音#
ℹ️ 提示 · 来源:网络 · Android 和 iPhone · 代码 media_via_turn
- 含义: 通常不影响通话,多数情况下无需操作;原因在于电话与 PBX 之间的网络。
- 员工: 最近一次通话的声音经过中继服务器:从该网络直连声音的路径被阻断。通话正常,延迟可能稍大。无需任何操作。
- 管理员: 最近一次通话的声音经过 TURN(协议见证据):从电话所在网络到 PBX 的直连 UDP 未通过。这是正常的备用机制,不是故障;TURN 和信令是不同的层。
- 查看位置: 电话端——「通话帮助」→ 「连接检查」,“什么在妨碍通话”区块;管理后台——「电话」→ 设备卡片 → **「电话上报」**标签页。
备用通道也无效#
🟠 通话时断时续 · 来源:网络 · Android 和 iPhone · 代码 signaling_fallback_failed
- 含义: 通话可用,但部分可能丢失或声音质量差;原因在于电话与 PBX 之间的网络。
- 员工: 到 PBX 的直连路径不可用,备用通道也未能建立。来电可能无法接入。请切换网络(例如从 Wi-Fi 切换到移动数据)并运行「连接检查」。
- 管理员: 电话尝试切换到 WSS 中继(443),切换失败(原因和中继关闭情况见证据)。请检查 PBX 与云端的连接,以及该门店的备用通道是否被关闭(「所有员工规则」→「自有电话」);如果多部电话同时失败,错误看板上会出现群组告警。
- 查看位置: 电话端——「通话帮助」→ 「连接检查」,“什么在妨碍通话”区块;管理后台——「电话」→ 设备卡片 → **「电话上报」**标签页。
声音连中继服务器也未能通过#
🟠 通话时断时续 · 来源:网络 · Android 和 iPhone · 代码 media_fallback_failed
- 含义: 通话可用,但部分可能丢失或声音质量差;原因在于电话与 PBX 之间的网络。
- 员工: 通话声音即使通过 TLS 443 中继也未能连接:网络将其也拦截了。请切换网络并运行「连接检查」。
- 管理员: ICE 自动机已耗尽直连路径和经 TURNS 443 的备用尝试——声音未能传输。电话所在网络连到中继的 TLS 也被拦截(或自有云端的 TURN 故障——参见看板上的 TURN 检查)。
- 查看位置: 电话端——「通话帮助」→ 「连接检查」,“什么在妨碍通话”区块;管理后台——「电话」→ 设备卡片 → **「电话上报」**标签页。
PBX 与呼叫计划#
此处电话本身正常,问题出在门店的 PBX 或其设置上:PBX 主机不在线、设备被关闭、电话不在呼叫计划中、PBX 不接受注册或已封锁地址。由管理员在“电话”中修复。
门店的 PBX 不在线#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 pbx_offline
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: 门店的 PBX 当前不可用。与电话无关——请告知管理员。
- 管理员: PBX 主机未发送心跳或已停止:所有人都无法通话。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
设备被管理员关闭#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 connection_disabled
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: 管理员已关闭此设备。请联系管理员。
- 管理员: 此电话的连接已在员工卡片中关闭。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
电话不在呼叫计划中#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 not_in_ring_plan
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: 群组来电和同事拨给此电话的电话无法接通——请管理员将其加入呼叫计划。
- 管理员: 电话已连接,但员工的个人呼叫计划中没有它的条目(或条目为空),PBX 不会拨打它。打开员工的连接,点击“加入计划”。
- 查看位置: 电话——“主页”上的横幅和“连接检查”屏幕;管理后台——员工连接窗口(警告和 “加入计划” 按钮)、“电话报告”标签页和电话自检(关于呼叫计划的项)。
PBX 拒绝了登录#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 sip_auth_failed
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: PBX 不接受此电话的登录。在应用中关闭设备并重新连接。
- 管理员: PBX 对注册返回 401/403:设备密码已重置或过期——员工需重新连接设备。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
PBX 拒绝注册#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 register_rejected
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: PBX 拒绝了注册。稍后打开应用;若仍无效——向支持发送报告。
- 管理员: PBX 对注册返回拒绝(非 401/403)——查看报告中的代码和 PBX 日志。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
PBX 看不到注册#
🟠 电话时断时续 · 来源:PBX · Android 和 iPhone · 代码 phone_says_registered_pbx_not
- 含义: 电话可以使用,但部分可能丢失或音质不佳;原因在 PBX 或其设置一侧。
- 员工: 电话认为自己已连接,但 PBX 看不到它。重启应用;若仍无效——更换网络。
- 管理员: 电话显示“已注册”,PBX 却没有:通常是路由器(SIP ALG)或代理破坏了地址。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
PBX 保留了旧注册#
ℹ️ 仅供参考 · 来源:PBX · Android 和 iPhone · 代码 pbx_registered_phone_not
- 含义: 通常不影响通话,多数情况下无需操作;原因在 PBX 或其设置一侧。
- 员工: PBX 仍记得电话之前的连接。它会自行过期。
- 管理员: 电话不在线,但 PBX 保留了它之前的联系——在注册过期前,电话可能拨向空处。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
PBX 不允许从此地址或程序接入#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 pbx_rejected_access
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: PBX 仅允许此分机从许可的地址或程序接入。请联系管理员。
- 管理员: 分机的限制(地址/程序)拒绝了此电话的注册——检查访问设置。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
电话地址被 PBX 封锁#
🔴 电话无法使用 · 来源:PBX · Android 和 iPhone · 代码 pbx_ip_blocked
- 含义: 在修复之前,无法用此电话正常拨打,或电话无法接通;原因在 PBX 或其设置一侧。
- 员工: PBX 因登录失败暂时封锁了您网络的地址。请等待或更换网络。
- 管理员: PBX 的自动封禁封锁了电话所用的地址(来自该网络的密码穷举)。在 PBX 的“安全”中解除封锁。
- 查看位置: 电话—— “通话帮助” → “连接检查”,“什么妨碍通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页;电话自检——“分机” 项。
注册稳定性#
云端根据 PBX 通话记录得出的当日结论——适用于任何设备,包括桌面电话:设备多久丢失一次注册、中断持续多久、从何处连接,以及同一地址下相邻设备的表现如何。如果相邻设备稳定,只有一台不稳定——问题在电话一侧;如果同一地址下所有设备都断开——问题在办公室网络或路由器。
与 PBX 长时间失去连接#
🟠 电话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 reg_gaps
- 含义: 电话可以拨打,但部分可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 员工: 电话长时间与 PBX 失去连接——此期间的来电无法送达。请勿关闭应用,并解除电池限制。
- 管理员: 设备长时间未在 PBX 注册:这些中断期间的电话会丢失。原因见「连接稳定性」结论。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面。
通过 VPN 或主机托管连接#
ℹ️ 仅供参考 · 问题方:网络 · Android 和 iPhone · 代码 vpn_detected
- 含义: 通常不影响通话,多数情况下无需处理;原因在于电话与 PBX 之间的网络。
- 员工: PBX 看到来自主机托管网络的连接——可能开启了 VPN。如果连接质量差——请尝试关闭它。
- 管理员: PBX 看到设备的连接来自主机托管网络(VPN 或代理):地址和连接质量取决于它。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面。
唤醒不工作#
🟠 电话时断时续 · 问题方:电话 · Android 和 iPhone · 代码 push_wake_off
- 含义: 电话可以拨打,但部分可能丢失或音质很差;原因在于电话本身或其设置。
- 员工: 电话与 PBX 失去连接,而 push 无法唤醒它——中断期间的电话会丢失。请在联网状态下打开应用,并解除电池限制。
- 管理员: 移动设备有时与 PBX 失去连接,而 push 唤醒对它不工作:中断期间的来电会丢失。原因见结论。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面。
通过 UDP 的来电无法到达设备#
🔴 电话无法使用 · 问题方:网络 · Android 和 iPhone · 代码 nat_udp_unreachable
- 含义: 在修复之前,无法用这部电话正常拨打,或来电无法送达;原因在于电话与 PBX 之间的网络。
- 员工: 路由器不放行通过 UDP 的 SIP 入站数据包到设备。请将设备切换到 TCP,或在路由器上开放 UDP。
- 管理员: 设备已注册,但从未响应 PBX 的检查:来电无法送达。请将其切换到 TCP,或配置路由器。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面;电话自检——「分机」 项。
路由器干预 SIP(SIP ALG)#
🔴 电话无法使用 · 问题方:网络 · Android 和 iPhone · 代码 sip_alg_suspected
- 含义: 在修复之前,无法用这部电话正常拨打,或来电无法送达;原因在于电话与 PBX 之间的网络。
- 员工: 办公室路由器破坏了 SIP 数据包。请在其中关闭 SIP ALG,或将设备切换到 TCP。
- 管理员: 同一地址下其他设备正常工作,而这台通过 UDP 不行(或两台设备共用一个地址):路由器干预了 SIP。请关闭 SIP ALG,或将设备切换到 TCP。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面;电话自检——「分机」 项。
电话系统关闭应用#
🟠 电话时断时续 · 问题方:电话 · 仅 Android · 代码 vendor_power_killer
- 含义: 电话可以拨打,但部分可能丢失或音质很差;原因在于电话本身或其设置。
- 员工: 厂商定制系统在后台关闭 Cenaly Phone。请允许自启动,并解除应用的电池限制。电话上有 「修复」 按钮——它会打开所需设置。
- 管理员: 电话系统一天内多次在后台终止应用——此期间的电话无法送达。员工需要允许自启动(按厂商的操作步骤在应用中)。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面。
与 PBX 的连接不断断开#
🟠 电话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 registration_flapping
- 含义: 电话可以拨打,但部分可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 员工: 电话经常与 PBX 失去连接。请检查 Wi‑Fi 和电池模式。
- 管理员: 电话一天内多次断开并重新连接到 PBX。
- 查看位置: 管理后台——「电话」→ 设备卡片 →「运行状况」,「连接稳定性」 区块(Cenaly Phone 还有「电话上报」标签页);Cenaly Phone 还有「连接检查」界面。
具体通话分析#
每次通话后,电话会发送一份简短的“通行证”:连接如何建立、声音走了哪条路径、坐席听到了什么、从他那里发出了什么、电话如何被唤醒接听。云端会将其与 PBX 对同一通电话的所见进行比对,并指出是哪一方的问题:电话、网络还是 PBX。如果双方都正常——投诉很可能不涉及这一段:请查看通话的另一方或提供商。号码、地址和通话录音不会进入通行证。
声音未接通#
🟠 通话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 ice_failed
- 这意味着什么: 通话可以工作,但部分通话可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 坐席: 电话接通了,但声音没有:电话无法为声音铺设到 PBX 的路径。通常是严格的网络。请更换网络并运行“连接检查”——它会检查中继服务器。
- 管理员: 就本次通话而言:ICE 未协商成功,双方都没有声音(电话和 PBX 均为 0 个数据包)。原因是电话的网络或中继服务器(TURN)不可用。请从电话通过“连接检查”检查 TURN。
- 在哪里查看: 电话—— “通话帮助” → “连接检查”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
对方的声音没有到达电话#
🟠 通话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 no_audio_to_phone
- 这意味着什么: 通话可以工作,但部分通话可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 坐席: 通话中 PBX 发送了声音,但电话没有收到。通常是网络:路由器或电信运营商没有放行传入的声音。请尝试其他网络(Wi‑Fi ↔ 移动互联网)并运行“连接检查”。
- 管理员: 就本次通话而言:PBX 收到了来自电话的声音并向其发送了对方的声音,而电话一个数据包都没有接收。问题出在 PBX → 电话的路径(NAT、传入 UDP 过滤、ICE 配对错误)。请从电话在“连接检查”中检查中继服务器;如果在同一网络中反复出现——问题在该网络的路由器。
- 在哪里查看: 电话—— “通话帮助” → “连接检查”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
您的声音没有到达对方#
🟠 通话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 no_audio_from_phone
- 这意味着什么: 通话可以工作,但部分通话可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 坐席: 电话发送了您的声音,但 PBX 没有收到。通常是网络:路由器或 VPN 拦截了发出的声音。请尝试其他网络或关闭 VPN 并运行“连接检查”。
- 管理员: 就本次通话而言:电话发送了声音数据包,而 PBX 一个都没有接收。问题出在电话 → PBX 的路径(严格 NAT 且无中继服务器、传出 UDP 过滤、VPN)。如果在同一网络中反复出现——问题在该网络的路由器;请在“连接检查”中检查中继服务器。
- 在哪里查看: 电话—— “通话帮助” → “连接检查”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
系统静音了麦克风#
🟠 通话时断时续 · 问题方:电话 · Android 和 iPhone · 代码 mic_silenced_by_system
- 这意味着什么: 通话可以工作,但部分通话可能丢失或音质很差;原因在于电话本身或其设置。
- 坐席: 通话期间麦克风静音了,尽管您没有关闭它:它被其他应用(录音机、视频通话、语音助手)或系统占用了。请关闭这类应用并重新拨打。
- 管理员: 就本次通话而言:与网络无关——PBX 收到了数据包,但其中是静音:电话系统静音了应用的麦克风,或它被其他应用占用。请让坐席关闭正在录制声音的应用;如果反复出现——重启电话。
- 在哪里查看: 电话—— “通话帮助” → “连接检查”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
对方的声音断断续续#
🟠 通话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 loss_downlink
- 这意味着什么: 通话可以工作,但部分通话可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 坐席: 对方的部分声音在传向电话的途中丢失了。如果您使用 Wi‑Fi——请靠近路由器或切换到移动互联网。
- 管理员: 就本次通话而言:PBX → 电话路径上有丢包(电话在恢复丢失的声音,PBX 在电话的报告中看到丢包)。通常是 Wi‑Fi 信号弱或电话所在网络信道拥塞。
- 在哪里查看: 电话—— “通话帮助” → “连接检查”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
您的声音在对方那里断断续续#
🟠 通话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 loss_uplink
- 这意味着什么: 通话可以工作,但部分通话可能丢失或音质很差;原因在于电话与 PBX 之间的网络。
- 坐席: 您的部分声音在从电话发出的途中丢失了。最常见的是 Wi‑Fi 上行带宽弱:请靠近路由器或切换到移动互联网。
- 管理员: 就本次通话而言:电话 → PBX 路径上有丢包(PBX 丢失了来自电话的数据包,电话在其报告中看到了丢包)。通常是 Wi‑Fi 上行带宽或办公室信道拥塞。
- 在哪里查看: 电话—— “通话帮助” → “连接检查”,“什么妨碍了通话”区块;管理后台——“电话” → 设备卡片 → “电话报告” 标签页。
电话唤醒接听耗时过长#
🟠 电话时断时续 · 问题方:电话 · Android 和 iPhone · 代码 wake_late
- 含义: 电话可以打通,但部分可能丢失或音质不佳;原因在电话本身或其设置。
- 员工: 电话打进来了,但电话接通速度超过 PBX 等待时间,群组来电可能已转给他人。请为 Cenaly Phone 解除电池限制,并允许其在后台运行。
- 管理员: 从唤醒链路看:push 已送达,但电话响应过慢——push 送达缓慢、应用冷启动、电话休眠或注册耗时过长。电话输出中会标明在哪一环节消耗了时间。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块;管理后台——「电话」→ 设备卡片 → 「电话上报」 标签页。
电话未送达至休眠中的电话#
🟠 电话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 wake_missed
- 含义: 电话可以打通,但部分可能丢失或音质不佳;原因在电话与 PBX 之间的网络。
- 员工: PBX 已唤醒电话准备接听,但电话上始终未出现来电。请检查 Cenaly Phone 的通知和后台运行权限是否已允许,并运行「连接检查」。
- 管理员: 从唤醒链路看:云端已发送 push,但电话上未出现来电——push 未送达电话,或电话已注册但 PBX 未向其发送群组来电。电话输出中会标明环节。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块;管理后台——「电话」→ 设备卡片 → 「电话上报」 标签页。
降噪#
降噪可消除员工声音中的环境噪音和对方声音中的街道噪音。可在电话或 PBX 上运行——具体位置由管理员在「电话」→「降噪」中选择。如果处理无法完成,通话不会中断:声音照常传输,不做抑制,电话或 PBX 会在此处上报。随时可以关闭抑制——通话不会因此中断。
降噪处理不及时#
🟠 电话时断时续 · 问题方:电话 · Android 和 iPhone · 代码 voice_fx_overload
- 含义: 电话可以打通,但部分可能丢失或音质不佳;原因在电话本身或其设置。
- 员工: 电话来不及处理语音,在通话中途关闭降噪。请选择更轻量的方法(「系统」)或关闭占用资源较大的应用。
- 管理员: 员工电话无法承载所选降噪方法,一天内多次回退到普通音质。请为其设置更轻量的方法(「系统」)或改用 PBX 处理:「电话」→「降噪」。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块;管理后台——「电话」→ 设备卡片 → 「电话上报」 标签页。
电话上降噪方法不可用#
ℹ️ 仅供参考 · 问题方:电话 · Android 和 iPhone · 代码 voice_fx_model_missing
- 含义: 通常不影响通话,多数情况下无需操作;原因在电话本身或其设置。
- 员工: 此版本应用中没有所选方法——通话使用系统降噪。请更新 Cenaly Phone。
- 管理员: 员工电话上没有所选降噪方法,通话使用系统降噪。请让员工更新 Cenaly Phone,或选择电话上已有的方法。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块;管理后台——「电话」→ 设备卡片 → 「电话上报」 标签页。
降噪设置为旧版本#
ℹ️ 仅供参考 · 问题方:电话 · Android 和 iPhone · 代码 voice_fx_plan_stale
- 含义: 通常不影响通话,多数情况下无需操作;原因在电话本身或其设置。
- 员工: 电话仍在使用旧的降噪设置。请在联网状态下打开应用——新设置会自动同步。
- 管理员: 员工电话尚未收到更改后的降噪设置。应用联网后即会生效;无需任何操作。
- 查看位置: 电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块;管理后台——「电话」→ 设备卡片 → 「电话上报」 标签页。
外部语音处理器不可用#
🟠 电话时断时续 · 问题方:PBX · Android 和 iPhone · 代码 voice_fx_processor_down
- 含义: 电话可以打通,但部分可能丢失或音质不佳;原因在 PBX 或其设置。
- 员工: 通话未使用外部语音处理。请告知管理员。
- 管理员: PBX 无法连接外部语音处理器:连接不通、密钥或证书错误。通话未使用该处理器。请在「电话」→「降噪」→「外部处理器」中检查处理器。
- 查看位置: 管理后台——「电话」→「降噪」(外部处理器状态);电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块。
外部语音处理器响应缓慢#
🟠 电话时断时续 · 问题方:网络 · Android 和 iPhone · 代码 voice_fx_processor_slow
- 含义: 电话可以打通,但部分可能丢失或音质不佳;原因在电话与 PBX 之间的网络。
- 员工: 部分声音未经处理。如果语音听起来不稳定,请告知管理员。
- 管理员: 处理器未能在帧时限内完成,PBX 将部分声音未经处理直接输出。请检查处理器负载及其网络,或在其设置中增大允许延迟。
- 查看位置: 管理后台——「电话」→「降噪」(外部处理器状态);电话——「通话帮助」→ 「连接检查」,「什么在妨碍通话」区块。