帮你快速理解、总结文档立即下载
文档中心>云联络中心>SDK 开发指南>集成语音和在线工作台 SDK>座席端外呼>小程序

小程序

最近更新时间：2026-01-20 10:32:55
我的收藏

本页目录：

介绍

腾讯云联络中心提供外呼小程序，您可以以下几种方式来打开小程序进行外呼电话：
小程序内 打开小程序 进行外呼。
企业微信 跳转小程序 进行外呼。
自有 App 拉起小程序 进行外呼。

效果展示





参数说明

公共参数说明

拉起外呼小程序需要用到以下参数。 请先记录这些参数，后文将会详细介绍具体开发方式。
参数
值
备注
appId
wx49e8ab828096cff3
固定值。
path
/pages/call/call?sdkAppId=1400000000&userId=FooOrBar@tencent.com&calleePhone=19999999999&calleeRemark=DisplayName&uui=HelloWorld
请将具体参数值修改为您自己的 path。
id
gh_bafb4b7e104a
腾讯云联络中心小程序原始 ID，仅 App 拉起小程序时使用。

path 参数说明

参数
类型
必填
备注
sdkAppId
String
是
腾讯云联络中心应用 SDKAppID。
userId
String
是
座席账号，一般为邮箱格式。
calleePhone
String
是
需要呼叫的电话号码。
calleeRemark
String
否
该电话的备注文案，可替代号码显示。
uui
String
否
自定义参数，传入后将通过 CDR 事件推送 返回。
token
String
否
使用 Token 方式 快速登录外呼小程序，建议每次发起呼叫的时候都重新从 TCCC 获取。
skillGroupId
String
否
指定技能组内绑定的外呼号码。
callerPhoneNumber
String
否
指定外呼号码。
servingNumberGroupIds
String[]
否
指定号码 ID 列表。
innerUserId
String
否
指呼叫内线的员工邮箱或 SIP 话机，当 calleePhone 参数为 null 时，该参数才生效。
建议同时使用 calleeRemark 显示对方姓名。
员工邮箱格式为：xxx@xx.com，SIP 话机格式为：1011@1400xxx.tccc.qcloud.com。
phoneEncodeType
'number'
否
目前仅支持'number'，在开启 号码映射 时强制使用真实号码。
soundMode
String
否
指定声音模式，默认为扬声器。
speaker：表示扬声器。
ear：表示听筒模式。
autoExitTime
'number'
否
指定对端挂断后多少秒后自动退出TCCC小程序，值范围[-1, 30]。
默认值为 -1，即表示不主动退出。
若值为 0 即立刻退出。
若值为2.5的时候即2.5秒后自动退出。

接入方式

小程序内打开小程序进行外呼

推荐使用 wx.navigateToMiniProgram 跳转打开小程序，具体接入指引请参见 跳转小程序
可直接点击 外呼小程序代码片段 使用，使用方式请参见 导入代码片段 代码示例：
const sdkAppId = '1400000000'
const userId = 'userid@email.com'
const calleePhone = '19999999999'
wx.navigateToMiniProgram({
    appId: 'wx49e8ab828096cff3',
    path: `pages/call/call?sdkAppId=${sdkAppId}&userId=${userId}&calleePhone=${calleePhone}`,
    success(res) {
        // 打开成功
    },
    fail(e) {
        wx.showToast({
            icon: 'error',
            title: '打开失败',
        })
    }
})

企业微信里进行外呼

情景一：企业微信应用是网页
说明：
前提条件：开发前需要联系官方人员授权小程序：点此进入 TCCC 社群联系官方人员，否则打开小程序会报错 "not allow to cross corp"。
操作步骤：
1. 通过 wx.agentConfig 注入应用的权限。
说明：
如果通过新版的 wecom-jssdk.js 来实现注入应用的权限，需要在调用 ww.register 的时候指定getAgentConfigSignature，非 getConfigSignature。
如果用 getConfigSignature 的话，会报 "launch Miniprogram:fail_no permission to execute".
2. 调用 launchMiniprogram 打开小程序。
代码示例：
const sdkAppId = '1400000000'
const userId = 'userid@email.com'
const calleePhone = '19999999999'
wx.invoke('launchMiniprogram', {
  appid : "wx49e8ab828096cff3", 
  path : `pages/call/call?sdkAppId=${sdkAppId}&userId=${userId}&calleePhone=${calleePhone}`,
}, function(res) {
    if(res.err_msg == "launchMiniprogram:ok") {
        // 正常
    } else {
        // 错误处理
    }
})
情景二：企业微信应用是小程序
推荐使用 wx.navigateToMiniProgram 跳转打开小程序。
代码示例：
const sdkAppId = '1400000000'
const userId = 'userid@email.com'
const calleePhone = '19999999999'
wx.navigateToMiniProgram({
    appId: 'wx49e8ab828096cff3',
    path: `pages/call/call?sdkAppId=${sdkAppId}&userId=${userId}&calleePhone=${calleePhone}`,
    success(res) {
        // 打开成功
    },
    fail(e) {
        wx.showToast({
            icon: 'error',
            title: '打开失败',
        })
    }
})

App 内打开小程序外呼

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

中国站