来电显示和拨号故障排除
在出问题的终端上打开 Back Office → Diagnostics(管理后台 → 诊断),查看 Telephony(电话)卡片。Listening 表示回调监听器正在运行。Connected 表示 USB 桥报告有设备。请查看 Last Refused Callback,并拨打一通测试电话以确认来电能到达收银机。Off 表示没有选择来源。然后在桌面应用中打开 Back Office → Local Settings → Caller ID & Clover(本机设置 → 来电显示和 Clover)。这两个页面都需要管理员身份。
- 在 Caller ID Source(来电显示来源)区域查看 Device on This Terminal(本终端的设备)。
- 确认所选来源与实际连接的设备一致:Yealink Action URL、AD102 USB Caller ID 或 Phonic USB Caller ID。
- 选择 Save Caller ID & Clover(保存来电显示和 Clover),然后查看 Device Status(设备状态)。
- 只按下面对应来源的那一节排查。
Caller ID & Dialling
示意图,不是截图。实际界面可能因主题或版本而有所不同。
同一时间只有一个来源生效。选择 USB 来源时,FMX EPOS 会忽略 Yealink 回调,所以同一通电话不会被两台设备重复记录。每台收银机只记录自己设备上的来电,因此多台收银机可以各接一部电话。
AD102 或 Phonic USB
Section titled “AD102 或 Phonic USB”- 确认设备已插在这台电脑上;如果设备需要供电,确认电源已接通。
- 确认选择的 USB 型号与设备完全一致。
- 查看 Device Status。“AD102 connected · 1 device” 表示已找到设备。“Starting AD102…” 表示 FMX EPOS 仍在查找设备。“No AD102 detected. Check USB and driver.” 或 “AD102 unavailable. Check the USB connection and driver. Retrying…” 表示没有找到设备。
- 重新连接设备,然后再看一次诊断页的 Telephony 卡片。
- 给店里打一个测试电话。
USB 设备只能接收来电号码,不能拨出电话。如果仍然找不到设备,先检查它的 Windows 驱动和硬件,不要急着把软件切换到别的设备型号。
使用 USB 来电显示盒时,没有号码的来电不会在收银机上显示,也不会保存在 Customers → Calls 中。隐藏号码的来电是否传入空号码,取决于设备。使用 Yealink 话机时,即使没有传入号码,FMX EPOS 也可以保留该来电。
如果显示 “… call pending: waiting for database.”,说明数据库不可用时收到了来电。数据库一恢复响应,这通来电就会保存下来。
Yealink 来电回调
Section titled “Yealink 来电回调”- 确认所选来源是 Yealink Action URL。
- 确认已经保存了有效的 Yealink Dial URL(Yealink 拨号 URL)。没有有效的拨号 URL,FMX EPOS 不会保存 Yealink 设置;设置保存后才会开始监听话机,即使你从不外拨也是如此。在此之前,Device Status 显示 “Configure the Yealink dial URL to enable callbacks.”(请配置 Yealink 拨号 URL 以启用回调)。
- 检查 Callback Port(回调端口,没有改过就是 880)和话机上保存的 Action URL。Action URL Help(Action URL 帮助)会列出要在话机上填写的准确地址。这些地址走回调端口上的普通 HTTP,不是 5139 端口,并且包含这台收银电脑的网络地址。
- 确认 Windows 防火墙允许回调端口连入这台终端。
- 检查 Allowed Callback IPs(允许的回调 IP)。其中必须包含话机当前的 IP 地址,多个地址用英文逗号分隔。这一栏为空时无法保存设置(提示 “Enter the phone’s IP address. Callbacks from other addresses are rejected.”)。
- 给话机和这台收银电脑设置固定 IP 地址或 DHCP 保留地址。
- 选择 Save Caller ID & Clover。之后 Device Status 应显示 “Listening on port …”,诊断页的 Telephony 卡片应显示 Listening。
- 测试一通来电。
Caller ID & Dialling
示意图,不是截图。实际界面可能因主题或版本而有所不同。
如果 Device Status 显示 “Callback port … could not open. Check whether another application is using it.”,说明这台电脑上有别的程序占用了该端口。其余设置仍然已经保存。关闭那个程序,或换一个 Callback Port,并在话机上把 Action URL 改成相同的端口。端口不能是 5139 或 8990,这两个端口由 FMX EPOS 和 Clover 使用。
回调监听有自己的 Allowed Callback IPs 列表,Local Settings → Security(本机设置 → 安全)里的 Allowed IP Addresses 列表不能代替它。来自列表以外地址的回调一律拒绝,相应的来电不会被记录。监听仍显示 Listening,但 Caller ID & Clover 和诊断页 Telephony 卡片上的 Last Refused Callback(最近被拒绝的回调)会显示被拒绝的地址和时间。如果那是话机的新地址,请把它加入 Allowed Callback IPs。
Yealink 无法拨号
Section titled “Yealink 无法拨号”如果收银机上的拨号按钮是灰色的,说明 Device on This Terminal 不是 Yealink Action URL。USB 设备不能拨号。
- 确认已保存 Yealink Dial URL。保存后,输入框保持为空,下方说明显示 “Saved securely ·”,后面跟着去掉了登录信息的话机地址。
- 新的 URL 必须以
https://开头,并以=结尾或包含{number},这样 FMX EPOS 才能填入电话号码。否则保存时会提示 “Enter a valid HTTPS Yealink dial URL.” 或 “The Yealink dial URL must end with = or contain {number}.”。 - 如果话机使用自签名 HTTPS 证书,勾选 Allow the Phone’s Self-Signed HTTPS Certificate(允许话机的自签名 HTTPS 证书),而且只对这部已知的话机这样做。
- Show Keys(显示密钥)只显示你刚输入的新值,方便保存前核对。已保存的 URL 不会再显示。
- 保存后试拨一个号码。
Caller ID & Dialling
示意图,不是截图。实际界面可能因主题或版本而有所不同。
收银机上的提示会告诉你该查哪里:
- “Calling …”:话机已接受请求。
- “The phone could not be reached.” 或 “The phone did not respond.”:检查拨号 URL 中的话机地址、网络,以及话机是否开机。如果话机使用自签名证书,还要确认已勾选 Allow the Phone’s Self-Signed HTTPS Certificate。
- “The phone rejected the dial request.”:检查拨号 URL 中的用户名和密码,以及话机本身的设置。
- “Enter a valid UK telephone number.”:订单或顾客记录上的号码无法拨打。
保存其他字段时,拨号 URL 输入框留空即可保留已保存的 URL。不要把含有话机登录信息的拨号 URL 发给技术支持。
状态在已连接和失败之间来回切换
Section titled “状态在已连接和失败之间来回切换”检查话机地址是否变了、防火墙规则是否改过,或话机是否在重启。把出问题的时间与诊断页的 Recent Errors(最近错误)对照。如果话机换了地址,先更新 Allowed Callback IPs,再重新测试。如果这台收银电脑换了地址,更新话机上的 Action URL。