云联络中心
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 云联络中心 > SDK 开发指南 > 集成音视频客服 > 集成用户端音频客服

集成用户端音频客服

最近更新时间：2023-11-27 11:49:11

我的收藏

本页目录：

本文主要介绍如何快速集成腾讯云联络中心音频客服，只要按照如下步骤进行配置，就可以跑通用户端的音频客服。

前提条件

您已 注册腾讯云 账号，并完成 实名认证。
您已 开通云联络中心 服务，并创建了 云联络中心实例。

集成用户端音频客服前置准备

1. 登录 云联络中心管理端，选择登录云联络中心 > 管理端 > 音频客服 > 技能组管理 > 添加技能组。
?
?
2. 添加 新客服 到对应的技能组中。
?
?
3. 新增 IVR， 选择登录的云联络中心 > 管理端 > 音频客服 > IVR管理 > 呼入 IVR > 新建。
?
?
4. 新建 IVR，在 IVR 画布左上角输入 IVR 名称，如：音频客服 IVR。根据您的场景需要拖拽 IVR 模块到画布区域合适的位置释放，连接模块并在各个模块填写相应信息。IVR 流程必须以开始模块为第一个模块，以结束模块为最后一个模块。
?
?
5. 新增配置音频入口。 选择管理端 > 渠道管理 > 配置音频入口 > 新增 ，输入音频入口名称，选择 IVR。
?
?
6. 复制音频入口 ID。
?
?
?
腾讯云联络中心提供了多种方式集成音频客服，包括跳转到 TCCC 联络小程序平台 完成音频客服功能，同时也提供了小程序 SDK、Android SDK 方便开发者实现音频客服相关功能。

跳转到 TCCC 联络小程序平台

我们提供了 TCCC 联络小程序平台，可以方便您在微信小程序里、企业微信里、自有 App 内打开 TCCC 联络小程序 完成音频客服。

跳转参数说明

拉起 TCCC 联络小程序平台需要用到以下参数。 请先记录这些参数，后文将会详细介绍具体开发方式。
参数
值
备注
appId
wxf3ac5a9dfc918430
固定值
path
/pages/call/call??sdkAppId={YourAppID}&channelId={YourChannelID}
请将具体参数值修改为您自己的

path 参数说明

参数
类型
必填
备注
sdkAppId
String
是
腾讯云联络中心应用 ID
channelId
String
是
视频入口 ID，参考 复制音频入口 ID。

微信小程序内进行跳转

使用 wx.navigateToMiniProgram 拉起 TCCC 联络小程序即可，请参见 打开另一个小程序。
代码示例：
const sdkAppId = '140xxxx';   // 请修改为自己的SDK APP ID。
const channelId = 'xxx';      // 请修改为自己的音频入口 ID
wx.navigateToMiniProgram({
  appId: 'wxf3ac5a9dfc918430',
  //path参数请参照前文说明填写
  path:`/pages/call/call?sdkAppId=${sdkAppId}&channelId=${channelId}`,
  success(res) {
    // 打开成功
  },
  fail(err) {
     // 打开失败
  },
})

企业微信里发起音频客服

1. 调用 wx.agentConfig 注入应用权限；
2. 调用 launchMiniprogram 打开小程序； 详细请参考 跳转到小程序。

App 内发起音频客服

使用微信提供的 OpenSDK 拉起 TCCC 联络小程序，请参见 App 拉起小程序功能。
Android 开发示例
iOS 开发示例

导入代码片段

如果您还未申请到小程序，或者想先测试预览跳转效果。我们也提供了小程序代码片段，方便您快速跳转 TCCC 联络小程序 平台。
1. 在微信开发者工具选择项目的界面中，左侧可以选择代码片段页卡，单击右上角的导入按钮。
?
?
2. 粘贴 https://developers.weixin.qq.com/s/daMLfYmC7Zzl 到输入框中。
?
?
3. 导入代码后，输入您的 SDK APP ID 和 在线客服入口 ID 即可选择真机调试。运行效果如下
?
?
?

小程序音频客服集成

我们提供了小程序组件，可以方便您在小程序中快速集成音频客服。您可参考下面相关文档。
?腾讯云联络中心用户端小程序集成指引?
?腾讯云联络中心用户端小程序 SDK API 概览以及示例?

Android 音频客服集成

本文主要介绍如何快速地将腾讯云联络中心用户端音频客服 （TCCC User SDK（Android）） 集成到您的项目中，只要按照如下步骤进行配置，就可以完成 SDK 的集成工作。

开发环境要求

Android Studio 3.5+。
Android 4.1（SDK API 16）及以上系统。

集成 Android端 SDK（aar、jar）

手动下载（aar、jar）

目前我们暂时还未发布到 mavenCentral ，您只能手动下载 SDK 集成到工程里：
1. 下载最新版本 TCCC User SDK。
2. 在工程根目录下的 build.gradle 中，指定本地仓库路径。
?
?
implementation fileTree(dir: "libs",includes: ['*.aar','*.jar'])
3. 在 app/build.gradle的defaultConfig 中，指定 App 使用的 CPU 架构。
defaultConfig {
    ndk {
        abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
    }
}
说明：
目前 TCCC User SDK 支持 armeabi ， armeabi-v7a 和 arm64-v8a。
4. 在 app/src/AndroidManifest.xml 中，指定 App 不允许应用参与备份和恢复基础架构。
?
?
5. 单击
?
Sync Now，完成 TCCC User SDK 的集成工作。

配置 App 权限

在 AndroidManifest.xml 中配置 App 的权限，TCCC SDK 需要以下权限：
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

设置混淆规则

在 proguard-rules.pro 文件，将 TCCC SDK 相关类加入不混淆名单：
-keep class com.tencent.** { *; }

Android 音频客服集成相关文档

?快速跑通云联络中心用户端 Android Demo?
?快速集成云联络中心用户端Android SDK?
?云联络中心用户端Android SDK API 概览以及示例?

iOS 音频客服集成

本文主要介绍如何快速地将腾讯云联络中心 iOS User SDK 集成到您的项目中，只要按照如下步骤进行配置，就可以完成 SDK 的集成工作。

开发环境要求

Xcode 9.0+。
iOS 9.0 以上的 iPhone 或者 iPad 真机。
项目已配置有效的开发者签名。

集成 iOS SDK

方案一：使用 CocoaPods

1. 安装 CocoaPods 在终端窗口中输入如下命令（需要提前在 Mac 中安装 Ruby 环境）：
sudo gem install cocoapods
2. 创建 Podfile 文件 进入项目所在路径，输入以下命令行之后项目路径下会出现一个 Podfile 文件。
pod init
3. 编辑 Podfile 文件 根据您的项目需要编辑 Podfile 文件：
 platform :ios, '8.0'
?
  target 'App' do
    pod 'TCCCCloud_Ios', :podspec => 'https://tccc.qcloud.com/assets/doc/user/release/TCCCCloud_Ios.podspec'
  end
4. 更新并安装 SDK
在终端窗口中输入如下命令以更新本地库文件，并安装 SDK：
pod install
或使用以下命令更新本地库版本：
pod update
pod 命令执行完后，会生成集成了 SDK 的 .xcworkspace 后缀的工程文件，双击打开即可。

方案二：手动下载

1. 下载最新版本 TCCC User SDK。
2. 打开您的 Xcode 工程项目，选择要运行的 target , 选中 Build Phases 项。
?
?
?
3. 单击 Link Binary with Libraries 项展开，单击底下的“+”号图标去添加依赖库。
?
?
?
4. 依次添加下载的 TCCCCloud.Framework、ImSDK_CPP.framework、TXFFmpeg.xcframework、TXSoundTouch.xcframework 及其所需依赖库 GLKit.framework、AssetsLibrary.framework、SystemConfiguration.framework、libsqlite3.0.tbd、CoreTelephony.framework、AVFoundation.framework、OpenGLES.framework、Accelerate.framework、MetalKit.framework、libresolv.tbd、MobileCoreServices.framework、libc++.tbd、CoreMedia.framework。
?
?
?
5. 单击 General，选择 Frameworks,Libraries,and Embedded Content，检查 TCCCCloud.framework 所需要动态库 TXFFmpeg.xcframework、TXSoundTouch.xcframework、ImSDK_CPP.framework 是否已经添加，是否正确选择选择 Embed & Sign，如果没有单击底下的“+”号图标依次添加。
?
?
?
6. 在工程 target 中 Build Settings 的 Other Linker Flags 增加 -ObjC 配置。
?
?
?

配置 App 权限

1. 如需使用 SDK 提供的音视频功能，需要给 App 授权麦克风的使用权限。在 App 的 Info.plist 中添加以下两项，分别对应麦克风在系统弹出授权对话框时的提示信息。选择Privacy - Microphone Usage Description，并填入麦克风使用目的提示语。
?
?
?
2. 如需 App 进入后台仍然运行相关功能，可在 XCode 中选中当前工程项目，并在 Capabilities 下将设置项 Background Modes 设定为 ON，并勾选 Audio，AirPlay and Picture in Picture ，如下图所示：
?
?
?

代码实现

目前我们只提供了通过 C++ 接口，可以用下面代码引入头文件
// 引入C++头文件
#include "TCCCCloud/tccc/include/ITCCCCloud.h"
// 使用tccc命名空间
using namespace tccc;
// 获取tcccSDK 单例
ITCCCCloud* tcccSDK = getTCCCShareInstance();
// 获取SDK版本号
const char *  version = tcccSDK->getSDKVersion();
具体编码实现可参考 API 概览以及示例?

iOS 音频客服集成相关文档

?快速跑通云联络中心用户端 iOS Demo?
?快速集成云联络中心用户端 iOS SDK?
?云联络中心用户端 iOS SDK API 概览以及示例?

常见问题

如何查看 TCCC 日志？

TCCC 的日志默认压缩加密，后缀为 .log。
iOS：日志路径：sandbox/Documents/tccc
Android?日志路径：/sdcard/Android/data/包名/files/tccc

在iOS下回调是否都在主线程

目前在iOS下回调都不在主线程，需要业务层面上判断并且把他转为主线线程
if ([NSThread isMainThread]) {
    // 在主线程，直接可以处理
    return;
}
dispatch_async(dispatch_get_main_queue(), ^{
    // 回调在非主线程。
});

TCCC 怎么校验生成的 UserSig 是否正确？

可通过云 API 调用生成UserSig，具体可查看 创建用户数据签名 接口文档。
中国站


http://www.vxiaotou.com