tencent cloud

云联络中心

产品公告
产品动态
关于云联络中心术语更新
产品简介
产品概述
功能列表
名词介绍
应对防火墙限制相关
AI 专区
购买指南
语音通话计费概述
在线会话计费概述
查看账单
退费指引
新用户手册
语音通话指引
在线会话指引
场景用例
客服热线(呼入)
电话营销(呼出)
语音提醒(自动外呼)
集成用例(SDK)
管理员操作手册
语音通话分册
在线会话分册
工作台操作手册
语音通话分册
在线会话分册
AI 智能体操作手册
语音智能体介绍
语音智能体实践教程
新建语音智能体
实现智能体通话
查看智能体通话
开发操作手册
SDK 开发指南
数据推送
语音通话 API 文档
History
Introduction
API Category
Making API Requests
Agent APIs
Skill Group APIs
Number APIs
Dual Call APIs
Predictive Outbound Call APIs
SIP Phone APIs
Call Service Record APIs
Billing APIs
Other APIs
Outbound Call APIs
Speech Intelligent Agent APIs
Data Types
Error Codes
在线会话 API 文档
服务端 API
回调配置
常见问题
数据删除指引
相关协议
隐私政策
数据隐私和安全协议
服务等级协议
云联络中心用户协议
词汇表
联系我们
文档云联络中心管理员操作手册语音通话分册来电弹屏:iframe 集成业务系统

来电弹屏:iframe 集成业务系统

PDF
聚焦模式
字号
最后更新时间: 2025-07-02 19:05:18
说明:
云联络中心 支持通过 iframe 方式嵌入您的业务系统,解决云联络中心与业务系统对接的问题。
当有用户来电/会话时,可以自动调取业务系统数据,展示给客服人员使用。
当座席需要呼出时,可在业务系统内调用拨号盘呼出电话。

来电弹屏效果展示





操作步骤

1. 直接访问 云联络中心 管理工作台,左侧导航栏单击通用设置 > 来电弹屏进入来电弹屏页面,左上角单击添加来电弹屏

2. 在添加来电弹屏对话窗口中填写如下信息:
页面名称:填写后于客服工作台来电弹屏标签中展示。
URL:为了保证您的通话数据安全性,腾讯云联络中心系统仅支持 HTTPS 协议方式登录,所以来电弹屏仅支持 HTTPS 协议的 URL。例如:https://andon.xxx.com/ticket/list/
常显:启用后,来电弹屏页面会常驻显示,否则只会在有呼入时弹出展示。
状态:需打开后来电弹屏有效。

3. 配置完成后前往工作台刷新页面即可查看,如下图所示。

业务系统获取通信相关参数

当有新的来电/会话时,将相关参数拼接在 URL 的 hash 上面,并通过 HashChange 监听。 示例:以腾讯网为例,假如您填写的页面地址为:https://www.qq.com,那么每次呼入时,我们请求的 URL 为:https://www.qq.com#?mobile=18888888888&type=phone 来电弹屏参数说明:
参数
描述
参数描述
mobile
手机号
/
userId
电话/网页渠道:用户 ID
微信渠道:用户微信 openID
/
nickName
用户微信昵称
/
avatar
用户头像
/
status
用户状态
100:呼入中
200:已接入
400:已结束
type
服务类型
phone:电话
im:微信/网页渠道图文会话
om:全媒体,仅音频通话
oim:音频通话 + 图文会话
agentEmail
客服邮箱
/
agentMobile
客服手机号
/
agentNickName
客服昵称
/
agentRoleId
客服角色
管理员
普通客服
sdkAppId
应用 ID
/


相关事件

window.addEventListener('message', (event) => {
if (event.data && event.data.source === 'ccc-console' && event.data.payload) {
const event = event.data.payload.event
// 当前event为completed,表示会话完成
}
})


来电弹屏调用电话呼出能力

效果展示





操作步骤

如果您需要在业务系统中配置呼出按钮并呼出电话,您可在业务系统呼出功能中调用 ccc-sdk,调用云联络中心呼出拨号盘。后续我们将支持呼出时获取通信相关参数,届时您可以将呼出时通信相关参数用于您的业务系统。 调用方法如下所示:
window.parent.postMessage({
source: 'ccc-sdk',
payload: {
event: 'callOut',
message: {
phoneNumber: '15889xxxxxx', // 必传
desc: '刘先生' // 呼出时系统显示字段,选填,没有时显示 phoneNumber
}
}
}, '*')


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈