客户端环境要求
快速阅读
客户端环境要求说明座席侧能不能稳定登录工作台、注册软电话、听清对方。它是上线前验收清单，不是职场弱电施工图，也不列未核实的浏览器最低版本号或防火墙端口表。
- 软电话：现代浏览器 + 麦克风/扬声器权限 + 稳定有线耳麦 + 默认声卡正确。
- 管理端浏览要求通常宽于软电话；软电话不要依赖 Flash 或旧版 IE。
- IP 话机走分机类型与话机侧配置；移动作业看 移动端实时通信（RTC）支持。
- 网络：稳定公网出口与 HTTPS 可达；出站回调白名单见 静态 IP 地址。
- 虚拟桌面、无麦权限、浏览器插件拦截是无声和无法签入的常见原因。
阅读地图
- 分终端看什么：读“四”。
- 网络与职场注意：读“五”“六”。
- 上线自检：读“七”和附录 C。
一、文档说明
职场开通时常问：电脑要什么配置、浏览器能不能用、专线要不要。本文给出 CTICloud 座席客户端的原则与验收项；具体带宽测算、端口放行以项目网络方案和现网支持确认为准。
适用：实施顾问、职场 IT、座席班长、需要嵌工作台的前端负责人。
登录与绑定电话流程见 登录座席工作台。号码、Region、计费不在本页展开。
二、产品总览
本页对象是座席使用的终端环境，不是某一通正在振铃的电话。
人、号、权限齐了还打不了，多半是浏览器、麦克风或网络没过关。先按终端类型对表，再打一通测试呼叫验收。
| 能力 | 解决什么 | 典型结果 |
|---|---|---|
| 客户端环境要求（本文） | 座位上的机器和网络够不够 | 能签入软电话、双方有声 |
| 登录座席工作台 | 账号、绑定、上线状态 | 登录成功且可置闲 |
| 分机类型 / 绑定电话 | 软电话、IP 话机、手机等怎么绑 | 设备状态正常 |
| 移动端 RTC | 手机 / 小程序侧通话 | 移动场景可外呼或接听 |
| 静态 IP | 平台出站回调加白 | 企业防火墙放行平台出口 |
三、核心概念
| 概念 | 说明 |
|---|---|
| 客户端环境 | 座席电脑、浏览器、耳麦、话机或移动端运行条件 |
| 软电话 | 浏览器内 WebRTC 类通话能力；需麦克风与扬声器 |
| IP 话机 | 硬件话机，经分机与平台注册 |
| 默认声卡 | 系统选中的输入/输出设备；多设备时选错会导致单通或无声 |
| 实体机优先 | 虚拟化桌面可能限制音频设备或 WebRTC，需额外验证 |
四、分终端要求
版本号、型号以当前控制台提示、SDK 说明和项目验收为准。下表写原则与失败时常见表现。
4.1 浏览器工作台与软电话
| 项 | 原则 | 不满足时常见表现 |
|---|---|---|
| 浏览器 | 使用主流现代浏览器；软电话场景优先 Chrome 正式渠道版本 | 无法注册软电话、页面脚本错误 |
| 过时方案 | 不使用 Flash；不将旧版 IE 作为软电话方案 | 进度条卡住、插件被拦截 |
| 麦克风 / 摄像头权限 | 对工作台域名允许麦克风（按业务需要） | 己方无声、权限弹窗被永久拒绝 |
| 音频设备 | 有线耳麦优先；设为系统默认输入/输出 | 单通、回声、突然静音 |
| 操作系统声音 | 勿静音系统、勿关闭麦克风增强导致异常的设备独占 | 本地有声、呼叫无声或相反 |
| 插件与策略 | 减少劫持 WebRTC 的企业插件；组策略勿禁用必要媒体 | 仅个别座席失败 |
嵌套工作台（iframe / 单点登录）时，父页面也须使用支持的浏览器，并在工作台加载完成后再初始化集成 SDK。
4.2 管理端
管理端主要用于配置与查询，对实时音频要求低于软电话。仍建议使用现代浏览器，并与职场标准版本对齐，避免「只有管理员能打开、座席不能打电话」的版本分裂。
4.3 IP 话机
| 项 | 原则 |
|---|---|
| 分机类型 | 按 分机类型 选择并完成注册 |
| 网络 | 话机到平台路由可达；专线场景按项目方案，不在本页给通用端口表 |
| 品牌与固件 | 以项目已验证型号为准，本页不点名未核实清单 |
| 与软电话关系 | 同一座席绑哪种设备，见绑定电话专题；不要混用未约定的双注册 |
4.4 移动端 RTC
Android、iOS、微信小程序、H5 等的系统版本、权限（麦克风、网络、后台）和鉴权，以 移动端实时通信（RTC）支持 为准。本页只提醒：移动场景不要套用桌面软电话浏览器表。
4.5 集成开发本机
联调 AgentSDK、弹屏页、Webhook 接收方时：
- 本机浏览器与职场标准一致，便于复现无声问题。
- 本地 HTTPS / 证书异常会导致弹屏或回调失败，需与通话媒体问题分开排。
五、网络原则
| 项 | 原则 | 说明 |
|---|---|---|
| 出口带宽 | 按并发通话预留稳定上行/下行 | 具体每路码率与职场总带宽由项目网络方案测算，本页不写死公式 |
| 稳定性 | 避免高丢包、高抖动的共享劣质链路 | 表现为断续、单向、频繁重连 |
| HTTPS / 域名 | 工作台与 API 域名可达 | Region 不同地址不同，见地域说明 |
| 防火墙 | 放行业务所需的 HTTPS 等访问 | 详细端口表以现网支持确认的清单为准，勿照搬历史帮助中心旧文 |
| 专线 | 可选；需路由直达或按方案部署会话边界设备 | 有专线不等于可省略浏览器与耳麦验收 |
| DNS | 能正确解析平台域名 | 错误 DNS 会导致登录或媒体异常 |
| 出站白名单 | 接收平台推送 / 回调时 | 静态 IP 地址 |
六、职场与虚拟化注意
- 优先实体机：VDI / 云桌面需单独验证 WebRTC、声卡重定向与耳麦。
- USB 耳麦：插拔后确认仍是默认设备。
- 多显示器 / 多声卡：避免会议软件占用默认设备导致通话无声。
- 安全软件：勿静默拦截工作台媒体或 WebSocket。
- 远程协助工具：可能抢占音频，联调时先退出。
七、上线自检
- 浏览器版本符合职场标准；软电话场景非 Flash / 旧 IE。
- 工作台域名下麦克风权限为允许。
- 耳麦为默认输入/输出；系统未静音。
- 座席完成登录、绑定电话、软电话或话机状态正常。
- 打通一通测试呼入或外呼，双方有声、可挂断。
- （若有）弹屏页在来电时打开且变量有值。
- （若有）企业侧接收推送的地址已按静态 IP / HTTPS 就绪。
八、与周边文档的边界
本文不提供未核实的最低 Chrome 大版本号、未确认的 UDP 端口区间，也不替代号码实名与线路商务条件。
九、常见问题
必须用 Chrome 吗？
软电话场景强烈建议使用职场已验证的现代 Chrome 系浏览器。管理端可用其他现代浏览器，但勿与软电话标准差过远。
还能按旧文档装 Flash 吗？
不能作为当前软电话方案。进度条卡住应清缓存、换现代浏览器，而不是装 Flash。
虚拟桌面不能用吗？
不是禁止，但必须把音频与 WebRTC 纳入验收；未验证就批量上线，容易出现「能登录无声音」。
带宽不够怎么算？
由职场网络按并发与编码测算。本页只要求「稳定、可验收」；具体数值写进项目网络方案，不写进对外站死表。
环境过了，任务还是拨不出？
转到外显、权限、路由或任务开通问题，见 常见问题 FAQ 通话与任务分组。
附录 A：相关文档
| 文档 | 用途 |
|---|---|
| 登录座席工作台 | 登录与绑定 |
| 座席工作台 | 工作台能力 |
| 分机类型 | 话机 / 软电话类型 |
| 座席绑定电话与外显设置 | 绑定与外显 |
| 移动端实时通信（RTC）支持 | 移动环境 |
| 静态 IP 地址 | 回调白名单 |
| 常见问题 FAQ | 现象导航 |
| 支持与下载 | 提支持 |
附录 B：术语（本篇）
| 中文 | 英文主词 | 说明 |
|---|---|---|
| 客户端环境要求 | Environment Specification | 页名跟线上 |
| 软电话 | Softphone | 浏览器内通话 |
| 默认声卡 | default audio device | 系统默认输入/输出 |
| 实体机 | physical machine | 相对虚拟桌面 |
附录 C：环境验收清单
- 软电话浏览器为职场标准现代版本，非 Flash / 旧 IE
- 麦克风权限已允许
- 耳麦为默认设备且系统未静音
- 实体机或已验证的虚拟桌面方案
- 平台域名 HTTPS 可达
- 一通测试呼叫双方有声
- IP 话机（若使用）注册与分机类型正确
- 移动 RTC（若使用）已按 RTC 专题验收
- 接收回调方已处理静态 IP / HTTPS（若需要）
Updated about 2 months ago