在 Salesforce 中进行编辑

有关更多信息，请参阅 Genesys 云嵌入式框架文档中的每种订阅类型的 事件 （Genesys Cloud 开发人员中心）。

管理员配置呼叫中心设置，以便集成触发并监听事件。

1. 在 Salesforce 中，单击 设置。
2. 搜索 已安装的软件包。
3. 在 构建下，单击 已安装的软件包。
4. 在 “ 已安装的软件包” 页面上，单击 Genesys Cloud 适用于 Salesforce 软件包 旁边的 配置。
5. 在 客户端事件设置下，为 客户端事件消息配置以下项目：
6. 对于 客户端事件消息类型，请选择 Window.PostMessage API。

   此设置会导致集成在客户端加载时引发握手事件。 

7. （可选）对于 客户端事件类型，选择要订阅的其他事件（交互、通知和 UserAction）。 单击 箭头 将它们添加到 “ 已选” 下。
8. （可选）选择 展开聊天通知 以接收聊天通知事件的扩展负载。
9. 单击 “ 保存”。

有关详细信息，请参阅 配置客户端事件。

Genesys 适用于 Salesforce 的云端客户端公开了通过 PostMessage Web API 引发的以下操作。

• 添加关联
• 交互。添加自定义属性
• 互动。创建会议
• 互动 .updatState
• 用户。更新状态
• 订阅

添加关联

在互动日志中添加新的联系人或关系关联。

参数

数据对象

定义操作。

参数

示例

在此示例中，集成在交互中添加了一个新联系人关联，ID 为 1234，显示的姓名为 John Smith。

{ 
  "type": "PureCloud.addAssociation",  
  "data": { 
      "type": "contact", 
      "id": "1234", 
      "text": "John Smith"
   } 
}

交互。添加自定义属性

向交互添加自定义属性。

参数

数据对象

定义操作。

参数

示例

{
    "type": "PureCloud.Interaction.addCustomAttributes", 
    "data": {
        "id": "1234-1234-1234-1234",
        "attributes": {
            "record_url": "/0000413456"
        }
    }
}

互动。创建会议

通过多次互动创建会议。

参数

数据对象

定义操作。

参数

示例

{
    "type": "PureCloud.Interaction.createConference", 
    "data": {
        "interactionIds": [
            "9641cedc-4cc2-48e1-84f7-fc4xxxx513e8",
            "5eafbfc4-6ff4-40e4-a2d7-dxxxxxxxx809", 
            "363ba2ca-xxxx-405e-bebe-fc59b1ae517b"
         ]
    }
}

互动 .updatState

更新交互的状态。

参数

数据对象

定义操作。

参数

参与者上下文对象

定义接收转移的实体。

参数

SecureSessionContext 对象

定义接收转移的实体。

参数

示例

以下示例显示了在没有咨询的情况下转移到座席或队列的交互。

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "blindTransfer",
        "id": "1234-1234-1234-1234",
        "participantContext": {
            "transferTarget": "3175550123",
            "transferTargetType": "address"
        }
    }
}

以下示例显示了传输到安全 IVR 流的交互。

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "secureSession",
        "id": "1234-1234-1234-1234",
        "secureSessionContext": {
            "flowId": "741f4f39-7a94-470d-a1dd-dd68d01e0dd8",
            "userData": "hello",
            "disconnect": false,
        }
    }
}

用户。更新状态

更新用户状态。

参数

数据对象

定义操作。

参数

示例

{
    "type": "PureCloud.User.updateStatus", 
    "data": {
        "id": "1234-1234-1234-1234"
    }
} 

订阅

订阅客户端事件。

参数

数据对象

定义操作。

参数

每种订阅类型的事件

示例

{
 "type": "PureCloud.subscribe",
 "data": {
     "type": "Notification",
     "categories": ["interactionSelection", "chatUpdate", "interactionWindow", "conversationTranscription"]
  }
}

创建一个 Lighting 组件，以便 Salesforce 可以监听和触发在呼叫中心设置中选择的事件。 

1. 将 Apex、组件和 JavaScript 文件添加到 Salesforce 中的开发者控制台。

   有关更多信息，请参阅 Salesforce 文档 中的 开发人员控制台文件菜单。

2. 在 JavaScript 文件中设置源 的 类型 和 ID。

   此设置允许您更改客户端中的状态。

   source.postMessage({
       type: 'PureCloud.User.updateStatus',
       data: { id: status },
   }

3. 如果管理员将集成配置为触发 “交互”、“通知” 或 “UserActions” 事件，请在 JavaScript 文件中订阅这些事件。

   有关更多信息，请参 阅 Genesys 云嵌入式框架 文档（Genesys Cloud 开发人员中心）中的订阅 方法。

有关更多信息，请参阅 Genesys 云嵌入式框架文档中的每种订阅类型的 事件 （Genesys Cloud 开发人员中心）。

管理员配置呼叫中心设置，以便集成触发并监听事件。

1. 在 Salesforce 中，单击 设置。
2. 搜索 已安装的软件包。
3. 在 构建下，单击 已安装的软件包。
4. 在 “ 已安装的软件包” 页面上，单击 Genesys Cloud 适用于 Salesforce 软件包 旁边的 配置。
5. 在 客户端事件设置下，为 客户端事件消息配置以下项目：
6. 对于 客户端事件消息类型，选择 Lightning 消息频道。 
   

   此设置会导致集成在消息频道上发送消息。 

7. （可选）对于 客户端事件类型，选择要订阅的其他事件（交互、通知和 UserAction）。 单击 箭头 将它们添加到 “ 已选” 下。
8. （可选）选择 展开聊天通知 以接收聊天通知事件的扩展负载。
9. 单击 “ 保存”。

有关详细信息，请参阅 配置客户端事件。

Genesys Cloud 适用于 Salesforce 的客户端暴露了通过闪电消息服务引发的以下操作。

• 添加关联
• 交互。添加自定义属性
• 互动。创建会议
• 互动 .updatState
• 用户。更新状态
• 订阅

添加关联

在互动日志中添加新的联系人或关系关联。

参数

数据对象

定义操作。

参数

示例

在此示例中，集成在交互中添加了一个新联系人关联，ID 为 1234，显示的姓名为 John Smith。

{ 
  "type": "PureCloud.addAssociation",  
  "data": { 
      "type": "contact", 
      "id": "1234", 
      "text": "John Smith"
   } 
}

交互。添加自定义属性

向交互添加自定义属性。

参数

数据对象

定义操作。

参数

示例

{
    "type": "PureCloud.Interaction.addCustomAttributes",
    "data": {
        "id": "1234-1234-1234-1234",
        "attributes": {
            "record_url": "/0000413456"
        }
    }
}

互动。创建会议

通过多次互动创建会议。

参数

数据对象

定义操作。

参数

示例

{
    "type": "PureCloud.Interaction.createConference", 
    "data": {
        "interactionIds": [
            "9641xxxx-4bb2-xxxx-84f7-xxxxxx8513e8",
            "5eafbfc4-6ff4-xxxx-a2d7-d23c1abbd809", 
            "363ba2ca-xxxx-405e-bebe-fc59xxxxx17b"
         ]
    }
}

互动 .updatState

更新交互的状态。

参数

数据对象

定义操作。

参数

参与者上下文对象

定义接收转移的实体。

参数

SecureSessionContext 对象

定义接收转移的实体。

参数

示例

以下示例显示了在没有咨询的情况下转移到座席或队列的交互。

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "blindTransfer",
        "id": "1234-1234-1234-1234",
        "participantContext": {
            "transferTarget": "3175550123",
            "transferTargetType": "address"
        }
    }
}

以下示例显示了传输到安全 IVR 流的交互。

{
    "type": "PureCloud.interaction.updateState", 
    "data": {
        "action": "secureSession",
        "id": "1234-1234-1234-1234",
        "secureSessionContext": {
            "flowId": "741f4f39-7a94-470d-a1dd-dd68d01e0dd8",
            "userData": "hello",
            "disconnect": false,
        }
    }
}

用户。更新状态

更新用户状态。

参数

数据对象

定义操作。

参数

示例

{
    "type": "PureCloud.User.updateStatus",
    "data": {
        "id": "1234-1234-1234-1234"
    }
} 

订阅

订阅客户端事件。

参数

数据对象

定义操作。

参数

每种订阅类型的事件

示例

{
 "type": "PureCloud.subscribe",
 "data": {
     "type": "Notification",
     "categories": ["interactionSelection", "chatUpdate", "interactionWindow", "conversationTranscription"]
  }
}

要订阅消息频道，请安装适用于 Salesforce 的 PureCloud 托管软件包的 3.12 版 或更高版本。 这些版本 的托管软件包包括接收所有消息的 PureCloud__ClientEvent__C 通道。 订阅 PureCloud__ClientEvent__C 后，Salesforce 可以监听并触发在呼叫中心设置中选择的事件。 

实现方法因您使用的组件而异。 以下示例代码演示了如何将 LMS 与闪电光环组件结合使用。

在 PureCloud__ClientEvent__C 频道上订阅闪电消息以获取 Aura 组件。

<lightning:messageChannel type="purecloud__ClientEvent__c" aura:id="clientEventMessageChannel" onMessage="{!c.onClientEvent}" scope="APPLICATION"/>

要接收闪电消息，请创建一个 onClientEvent。

({
    onClientEvent: function (component, message, helper) {
        var eventData = message.getParams();
        if (eventData) {
            if(eventData.type === 'Interaction' && eventData.data.id) {
		console.log(‘Interaction ID: ‘ + eventData.data.id);
            }
        }
    }
})

要发送闪电消息，请发布 Genesys Cloud 适用于 Salesforce 的客户端监听的事件。 有关事件的列表，请参阅 与 Genesys Cloud 进行 Salesforce 通信 部分。

component.find('clientEventMessageChannel').publish({
    type: 'PureCloud.User.updateStatus',
    data: { id: status }
});

有关其他示例，请参阅 Salesforce 开发人员博客 中的 闪电消息服务 [开发人员预览版]。