帮你快速理解、总结文档立即下载

前置准备

最近更新时间:2026-09-15 15:36:01
我的收藏

概述

通过 TCCC 用户端外呼 SDK ,您可以快速集成音频外呼能力,包括发起通话、发送 DTMF 按键等。

整体流程



接入前提

2. 购买并添加 座席账号。

接入流程

步骤1:获取 SecretId 和 SecretKey

获取腾讯云账号的 SecretId 和 SecretKey,您可参见 获取密钥。
警告:
SecretId 和 SecretKey 为敏感信息,为防止他人盗用,请妥善保管,谨防泄露。


步骤2:获取 TCCC 的 SDKAppId

登录 云联络中心控制台 即可查看。


步骤3:管理端配置

1. 登录 管理端。
若您是首次登录,您可参考 首次登录管理端 获取账号密码。
2. 创建技能组。
在管理端左侧导航栏人工管理模块,选择音频客服 > 技能组管理 > 添加技能组,输入技能组名称后单击确定,创建技能组完成。


3. 添加座席并加入技能组。
在管理端左侧导航栏人工管理模块,选择客服管理 > 客服管理 > 添加成员。在弹窗中输入座席姓名、对外昵称、工号、邮箱。角色选择语音员工,技能组 / 分组 选择上1步添加的技能组并单击确定,添加座席完成。

4. 创建简单的座席应答 IVR。
4.1 在管理端左侧导航栏人工管理模块,单击音频客服 > IVR 管理 > 呼入 IVR > 新建,您可以选择 “空 IVR” 做快速测试。

4.2 您可按下图配置一个简单的 IVR 流程,注意的是“转人工”节点里,“技能组名称” 选项需要选择第2步添加的技能组。

5. 
创建渠道
,获取 audioChannelId。
5.1 在管理端左侧导航栏人工管理模块,单击音频客服 > 渠道管理 > 配置音频入口 > 新建。

5.2 新建渠道时,输入音频入口名称,可视化 IVR中需要选择第4步新建的 IVR并单击确定。

5.3 创建完成后,在音频入口 ID 列复制 ID(统一称为 audioChannelId ),后面将作为 SDK 外呼时的参数,例如 startAudioCall(audioChannelId)


步骤4:获取 userSig 签名

接入方的后台服务引入 tencentcloud-sdk,引入方式可参见 SDK 中心 的对应语言。
调用接口 CreateUserSig(在线调试或具体语言实现 Demo 可参见 API Explorer)。
将获取到的 userSig 返回给接入方客户端。
下文将使用接口 example.api.com/genUserSig 来说明该步骤。以下代码以 Node.js 为例。
const express = require('express');
const app = express();
const tencentcloud = require('tencentcloud-sdk-nodejs');
const CccClient = tencentcloud.ccc.v20200210.Client;

app.get('/genUserSig', (req, res) => {
// 1. 从请求参数中读取 userId (例如: /genUserSig?userId=qiao123)
// 调用方业务系统的唯一用户标识
const userId = req.query.userId;

// 2. 基础校验:如果没有传入 userId,直接拦截并报错
if (!userId) {
return res.status(400).send({
error: 'Missing parameter: userId is required'
});
}

const clientConfig = {
credential: {
// secret获取地址: https://console.cloud.tencent.com/cam/capi
secretId: 'Your_SecretId',
secretKey: 'Your_SecretKey'
},
// 中国站填 'ap-guangzhou', 新加坡站填 'ap-singapore'
region: 'ap-guangzhou',
profile: {
httpProfile: {
// 新加坡站填 'ccc.ap-singapore.tencentcloudapi.com'
endpoint: 'ccc.tencentcloudapi.com'
}
}
};

const client = new CccClient(clientConfig);
const params = {
SdkAppId: 1400000000, // TCCC 应用的 SdkAppId
Uid: userId, // 3. 将读取到的 userId 赋值给 Uid
ExpiredTime: 3600,
// 可选字段
// ClientData: 'xxx',
};

client.CreateUserSig(params).then(
(data) => {
console.log("接口调用成功 ->", data);
res.send({
userId: userId,
userSig: data.UserSig
// ClientData是可选字段,但如果请求时指定了,需要一起返回给前端用于sdk的初始化
// userClientData: params.ClientData,
});
},
(err) => {
console.error('腾讯云接口调用失败', err);
// 4. 确保错误时返回 JSON 结果并结束请求
res.status(500).send({
error: err.message || 'Internal Server Error'
});
}
);
});

步骤5:客户端开发

使用上述步骤获取到的参数完成客户端的最终开发,如下:
SDKAppId: TCCC 应用 ID。
userId:调用方业务系统的唯一用户标识。
audioChannelId:外呼 IVR 地址。
userSig:用户签名。