tencent cloud

云联络中心

前置准备

下载
聚焦模式
字号
最后更新时间: 2026-09-17 15:36:43

概述

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

整体流程



接入前提

2. 购买并添加 座席账号

接入流程

步骤1:获取 SecretId 和 SecretKey

获取腾讯云账号的 SecretIdSecretKey,您可参见获取密钥
警告:
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步新建的 IIVR 并单击确定

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-intl-en');

const CccClient = tencentcloud.ccc.v20200210.Client;
const models = tencentcloud.ccc.v20200210.Models;

const Credential = tencentcloud.common.Credential;
const ClientProfile = tencentcloud.common.ClientProfile;
const HttpProfile = tencentcloud.common.HttpProfile;

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

if (!userId) {
return res.status(400).send({
error: 'Missing parameter: userId is required',
});
}

let cred = new Credential('Your_SecretId', 'Your_SecretKey');
let httpProfile = new HttpProfile();

httpProfile.endpoint = 'ccc.intl.tencentcloudapi.com';
let clientProfile = new ClientProfile();
clientProfile.httpProfile = httpProfile;

let client = new CccClient(cred, 'ap-singapore', clientProfile);
let clientReq = new models.CreateUserSigRequest();
let params = {
SdkAppId: 20000000,
Uid: userId,
ExpiredTime: 3600,
// 可选字段
// ClientData: 'xxx',
};

clientReq.from_json_string(JSON.stringify(params));
client.CreateUserSig(clientReq, function (err, response) {
if (err) {
console.log(err);
res.status(500).send({
error: err.message || 'Internal Server Error',
});
return;
}

res.send({
userId: userId,
userSig: response.UserSig,
// ClientData是可选字段,但如果请求时指定了,需要一起返回给前端用于sdk的初始化
// userClientData: params.ClientData,
});
});
});

步骤5:客户端开发

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

帮助和支持

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

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

文档反馈