触发器概述

触发器是 Genesys Cloud 中的一种资源，它允许客户配置对 Genesys Cloud 中发生的特定事件的反应。 这些操作是您可以通过 Architect 创建的工作流程。 有关如何创建工作流程的更多信息，请参阅 Genesys 云资源中心</span></span>中的架构师</span>简介。

触发器包括三个主要组件：

• 话题名称： 您要为其调用操作的主题或事件。
• 工作流程目标： 要对匹配的事件执行的操作。
• 条件：: 必须满足的标准才能对事件采取行动。

话题名称

以下列表是您在 Genesys Cloud 中创建触发器时可用的一些通知主题的示例。 新主题会定期更新，并且主题可能会有所不同，具体取决于您的组织。

• v2.users.{id}.activity
• v2.detail.events.conversation.{id}.acd.end
• v2.detail.events.conversation.{id}.acd.start
• v2.detail.events.conversation.{id}.acw
• v2.detail.events.conversation.{id}.wrapup
• v2.detail.events.conversation.{id}.attributes
• v2.detail.events.conversation.{id}.customer.end
• v2.detail.events.conversation.{id}.customer.start
• v2.detail.events.conversation.{id}.outbound
• v2.detail.events.conversation.{id}.user.end
• v2.detail.events.conversation.{id}.user.start
• v2.detail.events.conversation.{id}.voicemail.end
• v2.detail.events.conversation.{id}.voicemail.start
• v2.outbound.email.campaigns.contact.preContact
• v2.outbound.email.campaigns.contact.postContact
• v2.outbound.messaging.campaigns.contact.preContact
• v2.outbound.messaging.campaigns.contact.postContact
• v2.quality.evaluations
• v2.operations.events.{id}
• v2.detail.events.collaboratechat.adhoc.{id}.messages
• v2.detail.events.collaboratechat.group.{id}.messages
• v2.workforcemanagement.managementunits.{id}.adherence
• v2.workforcemanagement.teams.{id}.adherence
• v2.users.{id}.workforcemanagement.adherence
• v2.users.{id}.workforcemanagement.schedules
• v2.users.{id}.workforcemanagement.notifications
• v2.users.{id}.workforcemanagement.timeoffrequests
• v2.users.{id}.integrationpresence

当您在触发器视图中选择主题时，将显示该主题的事件模式以供参考。您可以通过使用 GET 请求获取您的组织可用的主题列表。有关详细信息，请参阅For more information, see流程自动化 API和可用主题。

工作流程目标

触发器支持 Architect 工作流程类型。 管理员在 Architect 中创建工作流程。 在触发器视图中，您只能选择活动和已发布的工作流作为工作流目标。 发送到工作流的输入参数的数据格式可以是顶级原始字段或 JSON。

• 顶级原语（例如字符串、枚举、数字和布尔值）将发送到工作流程。
• For JSON data format, the entire event is sent to the workflow as a JSON object. The workflow must be configured to have an input variable named jsonData of type JSON.

有关工作流程的更多信息，请参阅使用工作流程。

条件

条件是触发器调用工作流目标所依据的条件列表。 条件表达式包括三个部分：

• JSON 路径: 定义事件中要比较的部分。 使用 JSONPath 表达条件，这是一种用于遍历和解析 JSON 文档以查找特定元素的语言。 您还可以使用 Jayway JsonPath Evaluator 或 JSONPath 测试实用工具来检查 JSON 负载和 JSONPath 语句的响应。
• 操作员: 定义用于将 JSON 路径输出与值进行比较的比较类型。 字符串比较区分大小写。在触发器视图中，要查看运算符列表的说明，请单击查看有关过滤器运算符的帮助。
• 价值：用户定义的值或取单个值或值列表的操作的值。输入值可以是字符串、数字或布尔值。根据操作员的选择，值的输入类型会相应改变。 值的输入类型确保了比较的准确性。

  运算符	输入类型
  GreaterThanor Equal	号码
  小于或等于	号码
  等于	对象
  noteQual	对象
  小于	号码
  大于	号码
  在	对象数组
  notIn	对象数组
  包含	对象
  全部	对象数组
  存在	布尔值
  大小	号码

  笔记：触发器最多可以有 10 个条件，必须满足所有条件才能启动工作流程。要在多个条件中的任何一个为真（或逻辑）时调用工作流，您必须创建多个触发器，每个触发器都有自己的一组条件。

定时配置

当触发器调用工作流时，工作流立即开始或根据配置的时间延迟开始。 您还可以为触发器配置生存时间 (TTL)，以便工作流在配置的时间之后不会执行。 例如，如果状态更改工作流的触发处理存在延迟，则在设定时间之后执行工作流并不相关。

接下来，学习如何创建触发器。