阿里云云联络中心对接使用完全指南：从SIP中继到API/SDK集成
1. 云联络中心产品概述
阿里云云联络中心（Cloud Contact Center，简称CCC）是一款全渠道云客服平台，以软件即服务（SaaS）方式提供。它帮助企业快速搭建覆盖电话、在线IM、钉钉等多渠道的统一客户服务系统，实现智能路由、坐席分配、通话录音、IVR导航、数据报表等完整呼叫中心管理功能。
云联络中心主要由以下子系统构成：阿里云控制台和坐席控制台提供实例管理、座席与技能组配置、电话号码管理、IVR流程编排、录音管理、报表监控等功能；核心服务层负责话务路由、媒体转发、AI交互等底层能力；开放接口层通过OpenAPI和SDK向开发者提供编程集成能力。
需要先登录阿里云控制台，点击：阿里云控制台
2. 对接前置准备
2.1 账号注册与企业认证
使用云联络中心前需完成阿里云账号注册并进行企业实名认证。企业认证是申请语音号码和开通SIP对接的必要前提。认证通过后，在云联络中心产品详情页单击立即开通即可进入服务开通流程。
2.2 RAM访问控制授权
开通云联络中心时需要开通RAM访问控制并进行角色授权。RAM（资源访问管理）用于控制不同子账号对云联络中心资源的操作权限。建议遵循最小权限原则，为不同角色（管理员、坐席、开发者）分别创建RAM用户并赋予相应权限策略。
2.3 创建云联络中心实例
登录云联络中心控制台，在实例管理页面单击新建按钮，填写实例名称、访问地址和描述信息。创建实例时需根据业务需求选择客服类型——如果同时需要人工坐席和数字员工，应勾选两个选项。企业账号可以先创建体验版演示实例进行联调测试，体验版可试用50通电话，联调成功后再购买标准版。
实例创建成功后，需进一步完成坐席创建、技能组配置、坐席分配到技能组等操作。这些是坐席能够正常接听和拨打电话的基础配置。
3. SIP Trunk中继对接：企业自有号码接入
云联络中心支持通过SIP Trunk的方式与企业自带的固话号码进行对接，实现使用企业自有号码进行呼入和呼出。对接完成后，企业自行与号码所属运营商结算通信费用，云联络中心不收取对接与号码产生的通信费用。一条SIP线路不限配置使用的号码数量。
3.1 SIP对接技术参数
云联络中心SIP对接的信令服务器和媒体服务器地址如下：
信令服务器：106.15.103.10
媒体服务器：106.14.62.239、139.196.184.245、139.196.104.70、
139.196.196.243、47.100.87.231、101.132.169.114、
106.14.41.152、47.100.180.51、106.14.6.101、
106.14.171.191、106.14.14.98、139.224.190.86、
47.103.81.233、47.103.70.225、47.102.122.227
信令UDP端口：8000
媒体UDP端口范围：40000 ~ 600003.2 设备要求与接入流程
云联络中心侧不提供语音网关设备，需企业自行采购支持SIP协议对接的语音网关设备。号码运营商侧提供对应的线路IP后，双方确认满足对接条件后在约定时间进行联调。自有号码接入包含两步：创建SIP通道并配置SIP设备或SIP中继，然后在SIP通道内添加号码。
3.3 SIP软电话接入
除了中继对接，坐席还可以通过SIP软电话接入云联络中心。云联络中心推荐使用Linphone进行SIP软电话接入，主要考虑其跨平台（支持Windows和Mac）、代码开源免费、支持TLS加密、提供录音功能和通话质量监控功能等优势。接入流程包括云联络中心设备注册、Linphone下载安装、Linphone参数配置和注册四个步骤。
4. OpenAPI与SDK对接
云联络中心提供丰富的OpenAPI接口，支持开发者通过编程方式管理和调用云联络中心各项能力。推荐使用各语言SDK进行开发，SDK封装了底层API调用的网络通信、请求格式化和响应解析等复杂细节。
4.1 SDK版本说明
阿里云智能联络中心提供V1.0 SDK和V2.0 SDK两个版本。V2.0 SDK为最新版本，支持更多编程语言，解决了V1.0 SDK中存在的单Client线程安全问题，具备更强的健壮性和易用性。V1.0 SDK已不再维护，推荐使用V2.0 SDK。
SDK支持的语言包括Java、Python、PHP、Go、TypeScript、C++、Swift等。服务地址（Endpoint）为：aiccs.aliyuncs.com。
4.2 Java SDK调用示例
以下为使用Java SDK调用RobotCall接口发起智能联络机器人外呼的完整示例。使用前请确保Java版本高于Java 8，并通过Maven添加SDK依赖。
import com.aliyun.aiccs20191015.Client;
import com.aliyun.aiccs20191015.models.RobotCallRequest;
import com.aliyun.aiccs20191015.models.RobotCallResponse;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
public class RobotCallDemo {
public static void main(String[] args) throws Exception {
// 1. 创建配置对象
Config config = new Config()
.setAccessKeyId("your-access-key-id")
.setAccessKeySecret("your-access-key-secret")
.setEndpoint("aiccs.aliyuncs.com");
// 2. 创建客户端
Client client = new Client(config);
// 3. 构造请求参数
RobotCallRequest request = new RobotCallRequest()
.setInstanceId("ccc_xp_pre-cn-xxxxx") // 实例ID
.setCalledNumber("13800000000") // 被叫号码
.setCallerNumber("057100000000") // 主叫号码（已购号码）
.setRobotId("robot-xxxxx") // 机器人ID
.setOutId("order-20260703-001") // 业务外部ID
.setRecordFlag(true) // 开启录音
.setEarlyMediaAsr(true); // 开启早媒体ASR
// 4. 发起调用
RuntimeOptions runtime = new RuntimeOptions();
RobotCallResponse response = client.robotCallWithOptions(request, runtime);
// 5. 处理响应
System.out.println("请求ID：" + response.getRequestId());
System.out.println("状态码：" + response.getBody().getCode());
System.out.println("消息：" + response.getBody().getMessage());
System.out.println("通话ID：" + response.getBody().getData().getCallId());
}
}4.3 常用API接口
云联络中心提供的主要API接口包括：ListInstances获取当前阿里云账号下的云联络中心实例列表；ListInstancesOfUser获取用户所属的实例列表；CreateInstance创建云联络中心实例；GetInstance获取指定实例的详细信息。此外还有QueryHotlineNumber查询热线号码配置列表，以及用于外呼任务管理的task-list和task-recover-call等接口。
5. 前端SDK集成：坐席工作台嵌入
云联络中心提供前端SDK，支持将坐席工作台嵌入到第三方业务系统中。通过前端SDK，企业可以在自己的CRM、ERP、OA等系统中直接实现单点登录、接打电话等功能，并且可以通过监听SDK中的方法实现来电弹屏。
5.1 接入方式
前端SDK接入采用iframe嵌入方式，将云联络中心坐席工作台页面嵌入到第三方系统的页面中。当坐席工作台响铃或坐席主动外呼时，云联络中心系统以HTTP GET请求方式调用第三方客户管理系统的URL，并将相关参数发送给第三方系统。
5.2 后端服务转发
前端SDK的请求需要经过企业后端服务转发到云联络中心服务端。后端服务根据API概览调用对应的OpenAPI，将返回结果透传给前端SDK即可。前端SDK所需的返回结果必须是JSON数据格式。
6. IVR与函数计算集成
云联络中心与阿里云函数计算做了深度集成，用户可以通过函数计算完成云联络中心IVR对第三方服务或自有业务系统的调用。这一机制使得IVR流程不再局限于静态配置，而是可以动态调用外部系统的数据或逻辑。
6.1 应用场景示例
以根据来电号码归属地路由通话为例：用户来电后，IVR流程中的函数计算模块获取来电号码，调用第三方号码归属地查询接口，根据返回的地域信息将通话路由到对应区域的技能组或坐席。这种动态路由能力极大提升了客户服务的本地化和精细化水平。
6.2 配置要点
在语音业务控制台的IVR流程编辑器中，从左侧组件库中拖拽函数计算模块到画布中。配置模块时需要指定函数计算的服务名称、函数名称和请求参数。函数计算模块的执行结果可以在后续IVR节点中通过变量引用的方式使用，从而实现灵活的业务逻辑编排。
7. 事件推送与消息队列配置
云联络中心提供数据推送服务，可以将实例中订阅的事件推送到指定的消息队列中。通过对数据的整理分析，可以实现坐席事件、呼叫事件、满意度事件、录音事件以及云联络中心事件的实时查询监控。
7.1 配置步骤
在云联络中心实例的语音业务中点击坐席的设置，进入事件推送页面。点击管理按钮开启事件推送，填写接入点、主题（Topic）、生产者标识（GroupID）。然后根据业务需求勾选需要订阅的事件类型。
7.2 支持的事件类型
云联络中心支持订阅的事件类型包括：坐席状态变更事件、呼入呼出通话事件、客户满意度评价事件、录音文件生成事件、IVR流程执行事件等。通过这些事件数据，企业可以构建自定义的监控大盘、实时大屏或数据分析系统。
8. 网络业务渠道对接
除了语音业务，云联络中心还支持网络业务（在线IM）的渠道对接。企业可以将网站、APP、微信、钉钉等渠道的在线咨询统一接入云联络中心平台。
8.1 网页渠道接入
在云联络中心控制台的网络业务中，选择接入-渠道，点击添加渠道。选择网页部署方式，获取渠道ID。将渠道ID配置到企业网站的在线客服组件中，即可实现网站访客与云联络中心坐席的实时IM沟通。
8.2 对话机器人联动
云联络中心支持与阿里云对话机器人（原智能对话机器人）联动。在机器人空间中配置转人工能力，填写转入指定技能组及技能组ID。当机器人无法解决用户问题时，可以平滑转接到人工坐席。转人工时还可以通过自定义参数透传客户相关信息。部署服务渠道时选择仅人工接待或机器人加人工接待模式。
9. 成本构成与计费建议
云联络中心的费用主要由以下几个部分构成：实例费用根据选择的版本（体验版、标准版、企业版）按年或按量计费；语音号码费用包括号码月租和通信费用，通信费用按分钟计费；SIP对接费用为一次性收费（约30000元/线路），一条线路不限号码数量；短信服务费用如果使用云联络中心的短信功能，需单独开通阿里云短信服务并承担短信发送费用。
建议企业在正式采购前先使用体验版实例进行功能验证和联调测试。根据实际业务量选择合适的实例规格，避免资源浪费。SIP对接的一次性投入适合拥有大量自有号码且长期使用云联络中心的企业。
10. 常见问答
问：云联络中心是否支持对接企业自有的400号码？
答：支持。企业自有400号码可以通过SIP Trunk的方式与云联络中心进行对接。对接完成后企业自行与运营商结算通信费用，云联络中心不额外收取对接费用。
问：前端SDK接入坐席工作台时，每个操作都必须经过企业服务器转发吗？
答：是的。前端SDK的请求需要经过企业后端服务转发到云联络中心服务端。后端服务调用对应的OpenAPI并将结果透传给前端SDK。
问：云联络中心支持哪些编程语言的SDK？
答：云联络中心V2.0 SDK支持Java、Python、PHP、Go、TypeScript、C++、Swift等多种编程语言。开发者可以根据自身技术栈选择合适的SDK版本。
问：IVR流程中如何调用企业自有业务系统的数据？
答：云联络中心与函数计算做了深度集成。在IVR流程中拖入函数计算模块，配置函数计算的服务和函数，即可在IVR执行过程中动态调用企业自有业务系统的API接口获取数据。
问：云联络中心的事件推送支持哪些事件类型？
答：支持坐席事件、呼叫事件、满意度事件、录音事件以及云联络中心事件的实时推送。企业可以在控制台中按需订阅特定事件类型。
问：企业自有号码通过SIP对接需要采购额外的硬件设备吗？
答：需要。云联络中心侧不提供语音网关设备，企业需自行采购支持SIP协议对接的语音网关设备。设备采购后与运营商侧提供的线路IP进行联调对接。
