将Webex Contact Center与Salesforce集成(版本1 -旧版)
必要条件
目前,此功能仅适用于代理。
在将 Webex Center 与 Salesforce CRM 控制台集成之前,请确保您的档案具有以下访问权限:
-
访问 Webex Contact Center。
-
管理员访问 https://admin.webex.com 的Control Hub和Webex联系中心管理门户。管理门户的 URL 特定于地区。
-
代理对桌面 的访问。桌面的 URL 特定于地区。
-
代理对以下域的访问,这些域已添加到内容安全策略允许列表:
-
*.force.com
-
*.salesforce.com
-
*.lightning.force.com
-
*.lightning.salesforce.com
有关如何定义允许列表的信息 ,请参阅文章 Contact Center Webex设置。
-
-
Salesforce 开发者或沙盒帐户(最低要求)。要创建帐户,请转至 Salesforce 开发者门户(在 https://developer.salesforce.com/ 上)并单击 注册。
-
访问 Salesforce 的桌面布局 (JSON) ( https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/Salesforce)。
目前,CRM连接器应用程序不支持打开多个选项卡。在新标签页中打开案例可能会导致WxCC代理桌面上的多登录 警报,或导致代理出现不可预测的行为。
要Webex Contact Center 与 Salesforce CRM 控制台集成,请完成以下任务:
准备工作
如果您有旧版本的 Webex Contact Center for Salesforce,请先卸载旧版本,然后安装最新版本。有关详细信息,请参阅卸载 salesforce Webex Contact Center。
1 |
转至 Salesforce AppExchange(在 上 https://appexchange.salesforce.com/)。 |
2 |
在 Salesforce AppExchange 页面上,搜索 salesforce Webex Contact Center。 |
3 |
单击 立即获取。 |
4 |
输入要安装软件包的Salesforce组织用户名和密码,然后单击登录。 |
5 |
选择以下选项之一:
|
6 |
安装完成后,单击 完成。 Webex Contact Center for Salesforce在App Launcher中可用。
|
下载最新的呼叫中心定义文件:
更新呼叫中心定义文件
转至
单击导入 导入文件。
将文件分配给使用Webex Contact Center的用户。使用管理呼叫中心用户进行此操作。
导入后,呼叫中心定义文件将显示如下所示:
1 |
在 Salesforce 中,单击右上角的齿轮图标并选择 设置。 |
2 |
在 |
3 |
单击与要授予访问权限的用户对应的编辑链接。 |
4 |
搜索 Call Center 参数 ,在搜索查找中,选择 Webex Contact Center。 |
5 |
单击保存。 |
1 |
在 Salesforce 中,单击右上角的齿轮图标并选择 设置。 |
2 |
在 |
3 |
单击“新建”。 |
4 |
在名称字段中,输入布局的名称并选中缺省布局复选框。 |
5 |
在选择 呼叫类型 下拉列表,选择呼叫类型以指示何时启动软电话布局:
|
6 |
根据要求设置屏幕弹出设置。 |
7 |
单击保存。 |
1 |
在 Salesforce 中,单击右上角的齿轮图标并选择 设置。 |
2 |
在 |
3 |
选择 。 |
4 |
从档案列中的列表中选择一个档案。 |
5 |
在“要使用 页面布局下拉列表 ,选择Webex Contact Center 任务布局。 |
6 |
单击保存。 |
您可以下载 桌面布局 JSON 文件 for Salesforce 从 https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/Salesforce。
有关Webex Contact Center Management Portal桌面布局的详细信息,请参阅Cisco Webex Contact Center设置和管理指南 的配置章节。
1 |
转至 Webex Contact Center Management Portal。 |
2 |
从“管理门户”导航栏选择 |
3 |
单击 新布局 ,然后输入桌面布局的详细信息。 |
4 |
上传 Salesforce 桌面布局 JSON 文件。 |
5 |
单击保存以保存配置。 现在您可以在 Salesforce CRM 控制台Webex Contact Center 桌面。 |
1 |
在 Salesforce 中,单击右上角的齿轮图标并选择 设置。 |
2 |
在 |
3 |
选择 。 |
4 |
选择与 Contact Center 任务布局Webex关联的档案。 |
5 |
从页面 布局要使用下拉列表 ,选择任何其他页面布局。 确保没有与联系人中心任务Webex 关联的 配置文件。 |
6 |
单击保存。 |
7 |
导航至 设置。 |
8 |
在 |
9 |
单击 Salesforce Webex Contact Center 软件包名称的 卸载。 |
10 |
在卸载软件包 页面上,选择 “是,我要卸载此软件包并永久删除所有相关的组件”。 |
11 |
单击卸载。 |
设置计算机电话集成 (CTI) 系统以启用 Webex Contact Center。
1 |
登录 Salesforce。 |
2 |
单击右上角的齿轮图标,然后选择 安装。 |
3 |
在 |
4 |
单击与联系人中心对应的编辑Webex链接。 |
5 |
在 常规信息 区域中,更新以下字段:
|
6 |
单击保存。 |
当您登录到桌面时,CRM应用程序需要几秒钟才能成功完成初始化。通常,此过程可能需要5至15秒,具体取决于从CRM应用程序收到的响应。只有在初始化完成之后,您才可以处理呼叫。
我们目前不支持使用WebRTC登录代理桌面。
拨出电话之前
在拨打电话前,请确保执行以下操作:
-
创建外拨入点并设置外拨入点策略。
-
为代理档案启用外拨 ANI。
-
将外拨 ANI 设置为“拨号号码到入口点”映射。
有关详细信息,请参阅Cisco Webex Contact Center设置和管理指南 的配置章节。
有关如何使用桌面的信息,请参阅 Cisco Webex Contact Center Agent桌面用户指南。
-
如果找到录制文件并配置了屏幕弹出窗口,将显示客户详细信息。
-
如果没有找到记录,则会显示“新联系人”档案屏幕,您可以在其中输入详细信息。
要设置屏幕弹出窗口,请参阅本文集成部分中的创建缺省软电话布局。
1 |
在 Salesforce 中,单击 应用程序启动器 菜单,然后选择Webex Contact Center。 | ||||||||||||||||||||||||||||||||||||||
2 |
单击电话按钮并登录应用程序。 | ||||||||||||||||||||||||||||||||||||||
3 |
将状态更改为“ 可 接收呼叫”。 | ||||||||||||||||||||||||||||||||||||||
4 |
断开呼叫后,从呼叫列表中选择总结原因下拉列表。 活动将针对相应的 Salesforce 联系人进行记录。 要查看活动日志,请单击活动列表中的任何条目。将显示以下详细信息:
|
1 |
在 Salesforce 中,单击 应用程序启动器 菜单,然后选择Webex Contact Center。 |
2 |
在搜索Salesforce 文本框中输入联系人姓名,然后单击联系人姓名,然后单击要拨号的电话号码。或者,单击>拨号程序,然后输入电话号码并单击电话图标进行拨打。 |
3 |
(可选) 从选择外拨 ANI 下拉列表,选择要用作主叫号码的外拨 ANI。会议下拉列表按字母顺序显示。 管理员将外拨 ANI 列表添加到您的档案中。 要删除所选的外拨 ANI,请从 “标签”选择外拨 ANI “下拉列表。 |
Salesforce Actions 小部件提供用户界面控制,用于通过Webex Contact Center代理桌面应用程序与Salesforce CRM直接通信。
使用案例 |
SFDC呼叫中心定义配置 |
---|---|
当代理接听呼叫时,屏幕上会显示新的Salesforce操作小部件 |
在Salesforce Dot Com (SFDC)上不需要配置。
|
在编辑模式下打开活动记录 |
该功能在缺省情况下已启用。SFDC侧不需要任何特定配置。 |
联系CRM反对电话呼叫活动 |
该功能在缺省情况下已启用。SFDC侧不需要任何特定配置。 |
创建案例对象并在编辑模式下打开 |
该功能在缺省情况下已启用。SFDC侧不需要任何特定配置。 |
实时呼叫备注:
|
呼叫中心定义文件中有一个特定配置可启用或禁用此功能。 SFDC管理员必须指定任务对象中的SFDC字段以更新捕获的呼叫说明。 编辑呼叫中心定义文件的呼叫活动记录创建 部分中的字段,以在Salesforce应用程序中启用和更新“活动记录”。
|
1 |
在 Salesforce 中,单击 应用程序启动器 菜单,然后选择Webex Contact Center。 |
2 |
在导航 应用程序下拉列表 ,选择 报告。 如果列表中没有报告,单击 并添加报告。 |
3 |
要查看现有报告,单击所有 报告。 缺省呼叫活动报告通过 Webex Contact Center for Salesforce 安装。您可以修改日期,添加或删除字段和过滤器。 |
4 |
要创建新报告,单击报告> |
5 |
在报告 生成器标签 页中,选择所需的报告类型并单击 保存并运行。 |
6 |
输入报告 Webex Contact Center for Salesforce 使用 Salesforce 数据生成此报告。 |
以下部分描述了呼叫中心定义文件的每个部分的自定义及其可能的值、描述和注释。
这有助于管理员根据所需的用例自定义行为。
字段 |
可能值 |
描述 |
---|---|---|
内部名称 |
WebexCCAgentDesktopV202209019 |
此值没有变化。 |
显示名称 |
Webex Contact Center Agent Desktop 2.0(2022年9月) |
此值没有变化。 |
CTI适配器URL |
默认值为US数据中心。您可以根据数据中心位置更改值。 北美: https://desktop.wxcc-us1.cisco.com 英国: https://desktop.wxcc-eu1.cisco.com | |
使用CTI API |
true |
此值没有变化。 |
软电话高度 |
550 |
此值没有变化。 |
Salesforce兼容模式 |
闪电 |
此值没有变化。 |
字段 |
可能值 |
描述 |
---|---|---|
已启用高级屏幕弹出窗口 |
对或错 |
功能标志用于基于CAD变量启用屏幕弹出式搜索。 |
CAD变量名称 |
CAD变量的名称 |
保存屏幕弹出搜索参数的CAD变量的名称。 |
删除ANI前缀字符串 |
国家代码 |
以逗号分隔指定国家代码,并将从传入呼叫ANI前缀中删除。 |
字段 |
可能值 |
描述 |
---|---|---|
为无匹配记录启用屏幕弹出窗口 |
对或错 |
这是启用无记录匹配屏幕弹出场景的特征标志。确保禁用软件电话布局配置中的记录匹配场景。 |
Salesforce对象名称 |
任何标准或自定义Salesforce对象 |
在编辑模式下打开的任何标准或自定义Salesforce对象。 |
对象字段映射 |
这是Salesforce对象和WebexCC CAD变量之间的映射 |
此设置将WebexCC CAD变量映射到在编辑模式下打开时在Salesforce表单中预先填充的Salesforce字段值。例如,映射应以以下JSON格式完成,并且是JSON对象的数组。 JSON对象具有以下属性:
例如: 如果要用常量覆盖字段,可以使用isDefaulValueEnabled设置为true。 这会在Salesforce上设置变量的值。 示例: 配置: |
对象条件映射 |
这是对象映射的条件规则 |
条件映射有助于绑定WebexCC CAD变量和SFDC字段之间的一对多字段值。此条件有助于绑定基于不同的WebexCC CAD变量值的SFDC字段值。例如:WebexCC CAD变量 条件映射主要有三个属性- WxCCFieldName,即CAD变量、wxccFieldValue和sfdcFieldValue。 例如: 如果您在WebexCC上有一个变量queueName,并且希望将这些变量有条件映射到Salesforce字段,称为“客户类型”。 您可以根据对象条件映射 将队列名称设置为其他值,如下所示。 对象字段映射的配置 wxccFieldName:队列名称 Salesforce:客户类型 已启用DefaultValue:false isConditional启用:true 对象共轭映射配置
|
字段 |
可能值 |
描述 |
---|---|---|
Salesforce包命名空间 |
西斯科奇斯 |
默认值。不要更改值。 |
已启用自动刷新 |
对或错 |
这是功能标志变量。此功能可在创建活动记录后立即自动刷新Salesforce屏幕。 |
在连接状态下创建活动记录 |
对或错 |
默认情况下,该值为false。如果启用活动所有权更改功能,将值设置为true。这确保活动记录在呼叫开始时创建,并且当代理将呼叫转移到其他代理时,活动记录的所有权可以更改。 |
在连接状态上打开活动记录 |
对或错 |
此功能在缺省情况下是禁用的。启用在连接状态创建活动记录 功能标志使用此功能。此功能允许在代理状态移动到“已连接”状态时自动打开编辑模式下的活动记录。 |
在汇总状态下打开活动记录 |
对或错 |
此功能在缺省情况下是禁用的。启用此功能可在代理的状态移动到“Wrap-Up”状态时在编辑模式中打开活动记录。 |
要更改已转接呼叫的活动记录所有权 |
对或错 |
默认情况下,该值为false。这是需要启用的特征标志变量。此功能可在代理将呼叫转至其他代理时更改活动记录的所有权。这确保仅为交互创建一次活动记录。 |
持有活动ID的cad变量的名称 |
CAD变量的名称 |
持有活动ID的CAD变量的名称,用于更改已转移呼叫的活动记录的所有权。 |
录制呼叫现场备注 |
对或错 |
此字段是功能标志,用于启用操作 小部件中的呼叫说明功能。此功能在缺省情况下是禁用的。 |
实时呼叫备注字段映射 |
SFDC文件用于呼叫笔记映射。 |
使用呼叫说明更新的SFDC字段。默认情况下,它会更新Salesforce活动记录的描述 字段。 |
受验者中的日期格式 |
这是要设置活动受验者的日期和时间 |
默认格式为MM-dd-yyyy hh:mm a。 |
受试者模板 |
设置活动记录的主题字段,帮助更新活动记录的动态设置主题。 |
此字段可以是变量和静态字符串的组合。 例如: {direction}呼叫{activityDatetime}。 在示例中,短语 |
已启用自定义字段更新 |
对或错 |
此功能在缺省情况下是禁用的。如果您想使用在IVR或Flow中捕获的更多数据更新呼叫活动记录,请启用此功能。 |
对象字段映射 |
JSON属性的数组。默认值为[] |
此字段映射WebexCC CAD变量和SFDC字段。启用自定义字段更新功能以使用此映射。JSON主要有四种特性: CadFieldName: WebexCC CAD变量名称 SalesforceFieldName: SFDC字段名称 已启用DefaultValue: 标记以检查是否使用静态值与SFDC字段绑定 defaultFieldValue: 默认字段值 示例: 在第一个JSON代码中,CAD变量名称 在第二个JSON CADFieldName为空,因为要绑定的默认字段值是SFDC字段。在此示例中,SalesforceField 状态与默认值 已完成绑定。 |
字段 |
可能值 |
描述 |
---|---|---|
用于入站呼叫的自动案例创建 |
对或错 |
为所有入站呼叫启用自动分支创建功能标志。此功能在缺省情况下是禁用的。 |
用于呼出呼叫的自动分机创建 |
对或错 |
为所有出站呼叫启用自动分支创建功能标志。此功能在缺省情况下是禁用的。 |
在编辑模式中打开案例对象 |
对或错 |
用于确定是否在编辑模式下打开案例对象的特征标志。此功能在缺省情况下是禁用的。 |
对象字段映射 |
JSON属性的数组 |
映射WebexCC CAD变量和SFDC案例对象字段。JSON主要有四种特性: CadFieldName: WebexCC CAD变量名称 SalesforceFieldName: SFDC案例对象字段名称 已启用DefaultValue: 标记用于检查是否使用静态值绑定SFDC条件对象字段。 defaultFieldValue: 默认字段值 |
对象条件映射 |
对象映射的条件规则 |
条件映射有助于绑定WebexCC CAD变量和SFDC字段之间的一对多字段值映射。条件映射有助于绑定基于不同的WebexCC CAD变量值的SFDC字段值。 |
字段 |
可能值 |
描述 |
---|---|---|
全渠道状态同步已启用 |
对或错 |
功能标志仅在已启用全渠道的Salesforce实例上启用。 |
语音呼叫时默认空闲代码 |
全渠道未准备原因代码 |
在SFDC全渠道中使代理未准备的SFDC全渠道中未准备的原因代码的名称。 |
在CRM全渠道上的默认空闲代码 |
Webex联系中心闲置原因代码 |
Webex Contact Center的名称闲置了原因代码,使代理未在Webex Contact Center中准备就绪。 |
创建以下apex类,并向SFDC实例中所有代理配置文件授予执行权限,以使用全渠道状态同步功能。
要创建Apex类:
-
转至
-
导航至
-
粘贴以下内容并将其保存为sfdcOmniChannel
public class sfdcOmniChannel { public static String fetchOmniPresenceStatusCodes(){ ServicePresenceStatus[] omniStatus; omniStatus = [SELECT ID, MasterLabel from ServicePresenceStatus]; String OmniPresenceStatusCodes = JSON.serialize(omniStatus); System.debug(OmniPresenceStatusCodes);返回OmniPresenceStatusCodes; } }
缺点
需要特定的用户配置文件和许可证才能访问和播放录制文件。
-
用户配置文件—自定义主管配置文件
-
许可证—高级许可证
要配置回放录制,您需要在“用户配置文件”级别访问录制管理 模块。
用户配置文件中的强制设置
录制管理 模块中的视图访问权限允许您从Webex Contact Center查看呼叫录制文件 。这是所有管理员和主管配置文件的默认安全设置。
Salesforce Lightning设置
布局选择-
转至
。 -
单击页面右上角的页面布局分配 。
-
编辑页面布局分配
-
从下拉列表中选择 Webex Contact Center任务布局 。
Cisco Webex Contact Center任务布局是旧版布局。
要选择所需的数据中心:
-
转至
。 -
单击
。 -
将值 从US1更改为所需的Webex Contact Center数据中心。
示例: 将值从US1更改为EU1,然后选择EU1数据中心。
要选择所需的API URL:
-
转至
。 -
单击
。 -
将值 更改为所需的Webex Contact Center API URL。
示例: 将值更改为 https://audioconnector.produs1.ciscoccservice.com 以选择API URL。
-
转至
。 -
单击
。 -
将值 更改为所需的Webex Contact Center重定向uri。
示例: 将值更改为 https://audioconnector.produs1.ciscoccservice.com/auth 以选择重定向URI。
功能演示
演示将托管在内部Salesforce应用程序中心。
-
单击播放录制2.0 在Salesforce应用程序中打开“呼叫录制”。
-
如果您未登录Webex Contact Center桌面小部件,应用程序将提示输入凭据。
-
如果您拥有权限并已登录Salesforce的Webex Contact Center桌面小部件,则登录弹出窗口将消失。
-
如果您以代理或其他没有访问呼叫录制管理模块的用户身份登录,则将显示未经授权的消息。管理员可以修改用户配置文件设置以查看录制内容。