云联络中心
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 云联络中心 > SDK 开发指南 > 集成电话客服 > 实现一键外呼 > 小程序

小程序

最近更新时间：2023-08-07 11:27:42

我的收藏

本页目录：

介绍

腾讯云联络中心提供外呼小程序，您可以以下几种方式来打开小程序进行外呼电话：
小程序内 打开小程序 进行外呼。
企业微信 跳转小程序 进行外呼。
自有 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 方式快速登录外呼小程序
skillGroupId
String
否
指定技能组内绑定的外呼号码
callerPhoneNumber
String
否
指定外呼号码
servingNumberGroupIds
String[]
否
指定号码 ID 列表
phoneEncodeType
'number'
否
目前仅支持'number'，在开启 号码映射 时强制使用真实号码

接入方式

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

推荐使用 wx.openEmbeddedMiniProgram 打开半屏小程序，减少二次确认步骤；接入详细指引请参考：打开半屏小程序
可直接点击 外呼小程序代码片段 使用，使用方式请参考 导入代码片段 代码示例：
const sdkAppId = '1400000000'
const userId = 'userid@email.com'
const calleePhone = '19999999999'
wx.openEmbeddedMiniProgram({
    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 注入应用的权限
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 {
        // 错误处理
    }
})

App 内打开小程序外呼

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