- 最新动态
- 产品介绍
- 快速入门
-
用户指南
- 云控制台操作指南
-
租户管理员指南
- 认识您的租间
- 配置员工中心
- 启用人工服务
- 配置移动客服
- 配置多媒体渠道
-
机器人管理配置指南
- 快速入门
-
配置智能机器人
- 概述
- 配置一个预约挂号机器人(任务型对话机器人)
- 添加问答型对话机器人
- 其他操作
-
相关参考
- 图元
- 参数
-
TUC接口
- /chatbot/rest/tuc/v1/nlp/detectRegularEntity
- /chatbot/rest/tuc/v1/nlp/identify
- /chatbot/rest/tuc/v1/recommendFaq
- /chatbot/rest/tuc/v1/qualityInspection/qiOnline/recognize
- /chatbot/rest/tuc/v1/nlp/feedback
- /chatbot/rest/tuc/v1/nlp/textClassify
- /chatbot/rest/tuc/v1/nlp/detectEntity
- /chatbot/rest/tuc/v1/qualityInspection
- 内置函数
- 常见问题
- 操作员:配置普通IVR
- 配置预置流程
- IVR Journey分析
- 外呼风险监控
- 管理工单配置
- 质检管理
- 管理通知中心
- 管理客户中心
- 配置智能外呼
- 管理问卷
- 管理智能实训
- 配置知识库
- 配置公共资源
- 业务故障放通管理
- 护航浏览
- 社交媒体运营
- 绩效管理
- 客服座席指南
- 质检员指南
- 价格说明
-
开发指南
- 开发概述
- 用户接入——VOIP音视频接入
- 用户接入——网页版客户端集成 (RESTful)
- 用户接入——网页版轻量级客户端集成 (JS)
- 座席集成——座席轻量级接续块集成(JS)
- 座席集成——座席呼叫处理 (RESTful)
-
座席集成——Openeye H5 软电话接口集成
- 修订记录
- OpenEye H5软电话接口概述
- OpenEye软电话安装指导
- 座席侧集成H5软电话开发指导
- 音频呼叫接口
-
音视频呼叫接口扩展
- 音视频呼叫
-
设备管理
- getMediaDevices(获取设备列表)
- setMicIndex(设置麦克风)
- mediaGetMicIndex(查询当前使用的麦克风)
- setSpeakIndex (设置扬声器)
- mediaGetSpeakIndex (查询当前使用的扬声器)
- setMicVol(设置麦克风音量)
- getMicVol(查询麦克风当前音量)
- setSpkVol(设置扬声器音量)
- getSpkVol(查询扬声器当前音量)
- setVideoWindowParam(设置视频窗口位置和宽高)
- setVideoLayoutMode(设置视频窗口画面排列模式)
- setVideoDisplayMode(设置视频窗口画面裁剪模式)
- openCamera(打开摄像头)
- closeCamera(关闭摄像头)
- 屏幕共享
- 截屏
- 录屏
- 错误码列表
- 运营管理——座席工作台集成第三方Web页面
-
API参考
- 接口概述
- 相关术语
- 修改记录
- 接口鉴权方式
-
呼叫中心配置类
-
座席管理
- 单个创建座席业务账号(agentAccount/create)
- 单个删除指定座席业务账号(agentAccount/delete)
- 单个修改座席业务账号信息(agentAccount/update)
- 查询座席业务账号信息(agentAccount/query)
- 绑定座席和技能队列(addSkillsToAgent)
- 解绑座席某技能队列(releaseAgentBySkillId)
- 通过技能队列ID查询座席信息(queryAgentInfoBySkillId)
- 修改座席软电话号码登录密码(updateSipPhonePassword)
- 查询所有座席的软电话信息 (不包含业务账号) (querySysInfo)
- 查询所有座席的软电话信息 (包含业务账号) (queryAgentInfo)
- 查询账号登录结果 (queryAgentLoginParams)
- 根据登录账号查询座席信息 (queryAgentInfoByAccount)
- 按客户号码清理数据 (cleancustpersonaldata)
- 技能队列管理
- 号码管理
- IVR流程管理
-
座席管理
-
座席工作台
- 座席控制
-
座席双呼
- 创建双呼呼叫 (V1.0.0) (createCall)
- 创建双呼呼叫 (V3.0.0) (createCall)
- 查询呼叫历史记录 (queryCallDetailRecord)
- 查询呼叫状态 (queryCallState)
- 获取录音文件地址 (getRecordingAddress)
- 查询分配的软电话号码 (V1.0.0) (queryPhone)
- 查询分配的软电话号码 (V2.0.0) (queryPhone)
- 获取呼叫目的设备信息 (getCalledInfo)
- 创建语音外呼(V1.0.0)(createVoiceNotification)
- 创建语音外呼(V2.0.0)(createVoiceNotification)
- 查询当前会话客户的最近历史接触记录(queryUserContactLimit)
- 查询通话信息(queryCallInfoByCallId)
- ITA双呼结果通知(statusnotify)
- 回调接口
- 订阅语音识别结果接口
- App个人设置
- 附录
- 电销外呼
- 调查问卷
- 知识库管理
- 机器人管理
-
网页客户端接入
- 接口调用流程
- 第三方请求鉴权 (applyToken)
- 查询排队信息 (queryQueueInfo)
- 主动轮询座席侧发送的信息 (poll)
- 保存客户提交的满意度评价结果 (saveSatisfaction)
- 发送消息 (send)
- 客户发送文件 (uploadFileStream)
- 客户接收文件 (downloadFileStream)
- 根据客户输入联想常用语 (queryPhraseByKeyword)
- 检查当前租间是否支持点击通话 (checkClickToCallSupport)
- 创建点击通话 (createClickToCall)
- 获取点击通话事件 (getClickToCallEvents)
- 释放点击通话 (dropClickToCall)
- 创建匿名通话 (createcall)
- 客户提交留言 (doLeaveMessage)
- 提交客户对机器人满意度评价结果 (feedbacksatisfaction)
- 查询历史消息 (queryHistoryChatMessage)
- 丢弃邮件(chat_dropMail)
- 提供whatsapp发送下行消息(sendWhatsappMessage)
- 查询在线交谈工作台当前交谈的消息(getUserInfoBycallId)
- 查询满意度调查配置(getSatisfactionSurveyMode)
-
质检/监控/统计类
- 实时质检:qualitycontrol
-
智能质检
- 质检评分接口 (scoresetting)
- 句子管理接口 (sentencemanagement)
- 敏感词管理接口 (sensitiveWordManage)
- 话术接口 (conversationspecific)
- 句子、敏感词训练接口 (SemanticKeywordTraining)
- 对话逻辑接口 (conversationflow)
- 对话规则接口 (conversationrules)
- 抢插话规则接口 (interposalrules)
- 静默规则接口 (silencerule)
- 语速规则接口 (speedrule)
- 质检场景管理接口 (scenariomanage)
- 通话质检接口 (qualitycheckmanage)
- 人工抽检任务接口 (regularQualityTask)
- 质检任务接口 (qualitytask)
- 质检任务详情接口 (qualitytaskdetail)
- 质检申诉接口 (qualityitem)
- 第三方录音质检接口 (asrtrans)
-
监控/统计
-
实时数据查询类接口
-
VDN维度实时接口
- 查询指定VDN下的系统接入码信息
- 查询指定VDN下的座席休息情况
- 查询指定VDN下的座席电话号码
- 查询指定VDN下的所有座席信息
- 查询指定VDN下的所有座席的当前状态信息
- 查询指定VDN下的所有座席的静态配置信息
- 查询指定VDN下的IVR详细状态信息
- 查询指定VDN下的IVR流程接入码信息
- 查询指定VDN下的各技能队列相关信息
- 查询指定VDN所有休息原因码
- 查询指定接入码编号的呼叫信息
- 查询指定VDN下的呼叫信息
- 查询指定VDN下的呼叫信息(v2)
- 查询指定VDN下的通话轨迹数据
- 查询指定VDN下的所有座席的静态配置信息(CTI3.6版本不支持)
- 查询指定VDN下的所有座席信息(CTI3.6版本不支持)
- 获取VDN实时监控指标
- 技能队列维度实时接口
- 座席维度实时接口
- 呼叫明细维度实时接口
-
VDN维度实时接口
- 历史数据查询类接口
- 配置数据查询类接口
- 质检关系维护接口
- 外呼任务列表查询接口
- 系统指标查询接口
- 健康检查接口
- 附录
-
实时数据查询类接口
- 录音/话单类
- 语音通知
- OMA接口参考
- Case2.0接口参考
- DataProcess接口参考
- 其他类接口参考
- 常见问题
- 文档下载
- 通用参考
链接复制成功!
配置WhatsApp渠道
前提条件
本功能仅适用于除中国大陆以外的海外区域,中国大陆不适用。
已从WhatsApp服务路径供应商获取如下信息:
- 供应商为infobip:
- 注册WhatsApp服务路径提供商用户的电话号码
- 注册WhatsApp服务路径提供商的用户名称
- 注册WhatsApp服务路径提供商的用户密码
- WhatsApp服务路径提供商提供接口的url前缀,并向系统管理员提出申请且通过,将其加入地址白名单
- WhatsApp服务路径提供商提供认证的AccountKey
- Webhook密码为渠道接受消息的认证密码,由渠道配置人员自定义。渠道配置后需要通知infobip侧配置,对应infobip侧的webhook接口的acountkey
- 已获取认证证书,认证证书获取方法:
- 访问网址:
- https://api.infobip.com/
- infobip供应商提供接口的url前缀,如:https://***.api-us.infobip.com/。
- 导出浏览器中的证书。以导出https://api.infobip.com/的证书为例。
- 重复上述操作,导出https://***.api-us.infobip.com/的证书。
- 将获得的两个证书合成一个新的JKS证书。可通过证书合成工具Portecle合成。
下载地址:https://sourceforge.net/projects/portecle/。
操作方法:需要具备Java运行环境。
- 打开CMD命令行,进入portecle.jar所在目录。
- 执行:java -jar portecle.jar,运行Portecle。
- 单击“File > New Keystory Type ”,选择“JKS”,单击“OK”。
- 单击
,选择已获取的浏览器证书上传至Portecle。
需要执行两次。
- 单击
,输入新的证书密码,单击“OK”。
- 设置新的证书名称,可自定义,单击“保存”。
- 参考管理证书,上传认证证书。
- 访问网址:
- 供应商为other:other为客户自实现bsp对接whatsApp,目前版本只支持ITAU。
说明:
当WhatsApp服务路径供应商为other时,存在两种认证方式:
- basic:直接与WhatsApp服务路径提供商鉴权
- oAuth:通过API接口与WhatsApp服务路径提供商鉴权
认证方式不同,需要获取的参数也不同。
- 注册WhatsApp服务路径提供商用户的电话号码。
- 注册WhatsApp服务路径提供商的用户名称。
当WhatsApp服务路径提供商为other,且认证方式为oAuth时,请联系系统管理员在“配置中心 > 扩展与集成 > 接口管理 > APP服务 > APP管理”,找到订阅了sendWhatsappMessage接口并绑定了待配置WhatsApp渠道租间的APP,获取APP标识填到用户名称中。
- 注册WhatsApp服务路径提供商的用户密码。
当WhatsApp服务路径提供商为other,且认证方式为oAuth时,请联系系统管理员在“配置中心 > 扩展与集成 > 接口管理 > APP服务 > APP管理”,找到订阅了sendWhatsappMessage接口并绑定了待配置WhatsApp渠道租间的APP,获取APP密钥填到密码中。
- WhatsApp服务路径提供商提供接口的url前缀。
当WhatsApp服务路径提供商为other,且认证方式为oAuth时,须配置为:https://IP:PORT/apiaccess/rest/ccmessaging,其中IP:PORT为AICC前台登录IP和端口,可替换成域名。
- WhatsApp服务路径提供商提供认证的key。
- 渠道接受消息的认证密码。
- 已获取WhatsApp服务路径提供商提供的信任证书并在管理证书中上传。
- 当前系统的身份证书并在管理证书中上传。
与WhatsApp服务路径提供商的认证方式为oAuth时,不需要获取。
- 供应商为cloud-api:目前只支持演示,不能商用
- 需要先在Facebook开发者页面创建应用。
- 使用开发者账号登录Facebook,访问https://developers.facebook.com/apps,创建应用。
用例类型选择其他,应用类型选择商务,自定义应用名称,其他的保持默认。
- 返回https://developers.facebook.com/apps,找到刚刚创建的应用,复制应用编号,并访问https://developers.facebook.com/apps/应用编号/settings/basic可查看应用信息。应用编号替换成复制的应用编号。
图1 获取应用信息
应用编号对应客户服务云侧渠道配置的APP标识
应用密钥对应客户服务云侧渠道配置的应用密钥
- 为应用添加产品:WhatsApp。
图2 添加产品
- 选择“WhatsApp > 快速入门”,配置快速入门。
如果Facebook账号被限制了广告投放功能,请自行申请解封。
- 选择“WhatsApp > 新手入门”,获取电话号码和BaseUrl。
- 测试号码对应客户服务云侧的电话号码
- 红框中的URL对应客户服务云侧的BaseUrl
- 接收者为WhatsApp渠道服务的对象,为手机号码,需要手动添加,客户才能接入WhatsApp渠道。
图3 获取电话号码和BaseUrl - 继续访问https://business.facebook.com/settings/system-users,选择应用所在业务实体,在“用户 > 系统用户”中添加管理员。
“系统用户姓名”可自定义,“系统用户身份”请选择“管理员”。图4 添加和管理员
- 添加资产后,生成新口令。
图5 添加资产图6 生成新口令
生成的口令权限必须包含whatsapp_business_messaging、whatsapp_business_management。
生成的口令对应客户服务云侧渠道配置的access token
生成新口令会设置有效期,客户服务云侧与Facebook侧的有效期需要保持一致。
- 使用开发者账号登录Facebook,访问https://developers.facebook.com/apps,创建应用。
- 已获取信任证书并在管理证书中上传
- 国内环境:直接访问https://graph.facebook.com/v8.0网站受限,需要先配置代理服务器,再获取代理服务器的信任证书,证书格式要求.der。
- 国外环境:访问https://graph.facebook.com/v8.0网站,以浏览器方式导出证书,证书格式要求.der。
- 当前系统的身份证书并在管理证书中上传。
访问当前系统,以浏览器方式导出证书。
- 需要先在Facebook开发者页面创建应用。
背景信息
当WhatsApp服务路径提供商提供的信息发生变化时,涉及的WHATSAPP渠道需要同步修改,修改方式:租户管理员进入“配置中心 > 接入配置 > 渠道配置”,单击涉及渠道操作列的“编辑”,更新用户名称、密码、BaseUrl、AccountKey。
操作步骤
- 以租户管理员角色登录AICC,选择“配置中心 > 接入配置 > 渠道配置”。
- 单击“新建”,打开社交媒体开通配置页面。
- 配置渠道信息。
表1 渠道信息参数说明 参数
说明
渠道选择
选择WhatsApp
服务路径提供商
取值范围:
- infobip
- other
- cloud-api
其他信息请根据前提条件中获得的信息配置。
- 配置基础配置。
表2 基础配置参数说明 参数
说明
渠道名称
渠道名称必须是唯一的,输入值只能由字母,数字或下划线组成(首字符只能用字母和下划线),最大长度为64个字符。
组织配置
为渠道资源分配组织机构,从配置组织机构中选择一个创建好的组织机构。
技能队列
会查询当前租间的所有多媒体被叫配置,配置方法请参见配置被叫。
转人工关键字
用户在客户端输入该关键字后会由机器人服务转为人工座席服务。
说明:
开启智能机器人,转人工关键字必须设置。
座席工作时间
非工作时间提醒信息
非工作时间内,客户呼叫接入后,提示已配置的消息内容,提醒客户当前座席休息。
更多配置
熟客模式
配置方法请参见如何开启熟客模式
客户超时结束会话
配置方法请参见如何设置客户超时结束会话
座席超时转移会话
配置方法请参见如何设置座席超时转移会话
会话转移设置
配置方法请参见如何设置会话转移设置
外呼离线消息配置
配置方法请参见如何设置外呼离线消息配置
- 配置机器人配置。
- 单击“下一步”,进入到集成说明页面。
- 若scenario key提示不存在,单击“生成”。
WhatsApp服务提供商为cloud-api时,无需操作。
后续操作
导出渠道配置。
- 导出范围:基础配置、机器人配置下所有配置。密码密钥不支持导出。
- 单次导出渠道配置记录最多100000条,单个导出文件限制2000条。
- 不勾选渠道,默认导出全部渠道配置。
- 返回在渠道配置列表。
- 勾选已创建的渠道配置,单击
,导出渠道配置。
- 单击
,当“导出任务状态”为“成功”。
- 单击“下载”,即可获得导出的渠道配置。