

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用事件触发器创建出站活动
<a name="how-to-create-campaigns-using-event-triggers"></a>

**在中设置事件触发器 Connect Customer 管理员网站**

1. 在**活动设置**页面上的**收件人**下选择**客户事件**。  
![事件触发的活动的“活动设置”页面，在“收件人”部分下选择了“客户事件”。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-1.png)

1. 选择**事件源**指定数据的来源，并配置将激活事件触发器的属性条件。

   事件源基于您 Customer Profiles 域中的集成。有关设置外部应用程序的详细信息，请参阅[与外部应用程序集成](integrate-external-apps-customer-profiles.md#setup-integrations-title-menu)。您还可以与 [Kinesis](customer-profiles-kinesis-integration.md) 或 [S3](customer-profiles-object-type-mappings.md) 集成。  
![事件源选择面板，显示了集成选项和属性条件配置。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-2.png)

1. 选择**投放模式**和其他通信设置。  
![事件触发的活动的投放模式选择和其他通信设置。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-3.png)
**重要**  
要创建沟通小部件活动，您必须在您的客户档案域和您的实例之间集成客户档案。所需的对象类型名称是`Campaign-WebNotification`。为此，您可以在 Connect Customer 管理网站控制台中选择升级按钮，选择您的实例，然后转到出**站广告系列**子页面。  
![“通信” 部分显示了 “传送模式” 下拉列表，其中选择了 “通信”](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/shows_channel_option.png)  
![“通信” 部分显示了带有 My-custom-widget 选定和通知类型的 “通信” 小部件下拉列表。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/shows_channel_option_after_a_widget_is_selected.png)

   有两种通知类型可供选择：“**查看**” 和 “**操作”**。  
**视图**  
“**查看**” 通知会在通信小部件按钮上方显示一条可视消息或提示。它向最终用户提供信息，例如问候语、报价或情境消息。该通知邀请最终用户与代理或机器人进行对话。  
如果您想在最终用户开始对话之前向他们显示消息、促销或情境相关信息，请选择 “**查看**”。这让最终用户有时间阅读并决定是否参与。  
示例：  
   + 一面积极主动的横幅，上面写着 “嗨！我们注意到您访问此页面已有一段时间了。需要帮助寻找合适的计划吗？”
   + 促销信息：“限时优惠 — 联系我们，即可享受升级八折优惠。”
   + 上下文推动：“在完成订单时遇到问题？ 我们随时为您提供帮助。”  
**Action**  
**操作**通知会绕过任何视觉消息，立即触发通信小部件打开，并直接与机器人或人工代理开始对话。  
如果您想完全跳过通知步骤并让最终用户直接进入实时对话，请选择 “**操作**”。不显示任何中间消息。  
示例：  
   + 该系统会立即将结账页面上有意向的客户与支持代理联系起来。
   + 系统会将持有未解决案例的回头客户直接路由到机器人流程中以检查状态。
   + VIP 客户在访问帮助页面时触发与专门代理的即时连接。  
![查看选定的通知类型，选择了 Web 通知服务集成的视图。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/shows_view_notification_type_recommender.png)

   只有当您选择**查看通知类型并且所选视图**具有 **Web 通知服务**集成类型时，推荐人才可用。如果您选择**操作**通知类型，或者所选视图没有此集成，则不会显示推荐选项。

1. （可选）配置 “**推荐**” 部分，将预测见解与您的事件触发的活动集成。这使您能够通过电子邮件和短信渠道提供个性化的模板内容。  
![Amazon Connect 控制台中的 “推荐” 部分显示了 “推荐者” 下拉列表，其中选择了经常配对的商品。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-create-campaigns-recommendations.png)

   配置以下设置：
   + **推荐人姓名**-选择您要用来为与活动关联的个人资料生成推荐的推荐人的姓名。您只能使用活跃的推荐人来生成推荐。

     预测见解提供了几种类型的建议。有关更多信息，请参阅 [第 3 步：创建预测性见解](predictive-insights-get-started.md#create-predictive-insights)。
   + **推荐人的计算属性**-只有在使用 “*相似项目” 或 “*经常配对*的项目*” 推荐类型时，才需要此设置。此上下文可帮助推荐引擎了解推荐所依据的产品，从而为您的客户提供更具相关性和针对性的推荐。

     例如，您可以使用计算属性来捕获`_last_interacted_item_id`已购买的商品编码。
   + **推荐数量**-为个人资料生成的最大推荐数量。这可以介于 1 到 3 个建议之间。
   + **推荐属性**-定义您的消息模板中使用推荐回复的哪些属性。

   有关预测见解的更多信息，请参阅[开始使用预测性见解](predictive-insights-get-started.md)。

1. 确认您的配置并选择**发布**。  
![配置事件触发的活动的最终审核屏幕，其中有“发布”按钮。](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-4.png)

## 使用 API 通过事件触发器创建出站活动
<a name="how-to-create-campaigns-using-event-triggers-api"></a>

**Connect 客户档案事件触发 API**
+ 要创建功能正常的事件触发器，需要进行两次 API 调用：
  +  [CreateEventTrigger](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_CreateEventTrigger.html)：根据指定条件定义要执行的操作。
  +  [PutIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_PutIntegration.html)：定义要使用的操作。

**事件触发请求示例：**

```
{
"Description": "string",
"EventTriggerConditions": [
{
"EventTriggerDimensions": [
{
"ObjectAttributes": [
{
"ComparisonOperator": "string",
"FieldName": "string",
"Source": "string",
"Values": [ "string" ]
}
]
}
],
"LogicalOperator": "string"
}
],
"EventTriggerLimits": {
"EventExpiration": number,
"Periods": [
{
"MaxInvocationsPerProfile": number,
"Unit": "string",
"Unlimited": boolean,
"Value": number
}
]
},
"ObjectTypeName": "string",
"SegmentFilter": "string",
"Tags": {
"string" : "string"
}
}
```

**`ComparisonOperator` 支持以下值：**


|  ComparisonOperator  |  Comment  |  支持的类型  | 
| --- | --- | --- | 
|  INCLUSIVE  |  检查目标是否包含所有指定值。 |  字符串  | 
|  独家  |  检查目标是否不包含所有指定值。 |  字符串  | 
|  CONTAINS  |  检查目标是否包含任意指定值。 |  字符串  | 
|  BEGINS\_WITH  |  检查目标是否以指定值开头。 |  字符串  | 
|  ENDS\_WITH  |  检查目标是否以指定值结尾。 |  字符串  | 
|  大于  |  如果目标大于指定值，则为 True。 |  数字  | 
|  小于  |  如果目标小于指定值，则为 True。 |  数字  | 
|  GREATER\_THAN\_OR\_EQUAL  |  如果目标大于或等于指定值，则为 True。 |  数字  | 
|  LESS\_THAN\_OR\_EQUAL  |  如果目标小于或等于指定值，则为 True。 |  数字  | 
|  EQUAL  |  如果目标等于指定值，则为 True。 |  数字  | 
|  之间  |  如果目标在特定的值范围或时间戳内，则为 True。 |  Number/Date\*  | 
|  NOT\_BETWEEN  |  如果目标不在特定的值范围或时间戳内，则为 True。 |  Number/Date\*  | 
|  之前  |  如果目标早于指定时间戳，则为 True。 |  日期  | 
|  之后  |  如果目标晚于指定时间戳，则为 True。 |  日期  | 
|  ON  |  如果目标位于指定的时间戳，则为 True。 |  日期  | 
+ **Source**：用于定义对象中的属性。
  + 单个 `ObjectAttribute` 条目中只能使用一个属性。
+ **FieldName**：用于指向 “数据映射” 中的映射属性。
  + 单个 `ObjectAttribute` 条目中只能使用一个属性。
+ **ObjectTypeName**：支持所有默认和自定义对象类型名称，但不支持标准对象类型，例如`_profile`、`_asset``_order`、和其他。
+ **EventTriggerLimits**:
  +  默认情况下，每个客户域最多支持 20 个并发事件触发器。
  +  默认限制为每个触发器、每个配置文件、每天 10 次调用。您可以通过在 `MaxInvocationPerProfile` 中指定 `UNLIMITED` 来覆盖此设置。
  +  **MaxInvocationPerProfile**:
    + 有效范围：最小值为 1。最大值为 1000。（或 `UNLIMITED`）
  +  单位：
    + 有效值：HOURS、DAYS、WEEKS、MONTHS
  +  值：
    + 有效范围：最小值为 1。最大值为 24
+  时间范围比较 
  +  Customer Profiles 使用标准库来解析时间值。对于全球服务，重要的是要考虑时区转换，以确保准确处理。
+ `EventExpiration` 值以毫秒为单位指定。用于触发活动时，最长过期时间上限为 15 分钟。

**出站活动事件触发器 API**
+ **CreateCampaignV2**

  创建事件触发的活动时仅突出显示的字段需要进行更改。其余字段与计划活动相同。

  ```
  {
      "name": "string",
      "connectInstanceId": "string",
      "channelSubtypeConfig": { 
      // or other channel parameters 
          "email": {
              "outboundMode": {
                  "agentless":{
                  }
              },
              "defaultOutboundConfig":{
                  "connectSourceEmailAddress":"example@example.com",
                  "wisdomTemplateArn":"arn:aws:wisdom:us-west-2:123456789012:message-template/dXXXXX0Pc8-195a-776f-0000-EXAMPLE/51219d5c-b1f4-4bad-b8d3-000673332",
                  "sourceEmailAddressDisplayName": "testEmailDisplayName"
              }
          }
      },
      "connectCampaignFlowArn": {{<Flow ARN>}},
      "schedule": {
              "endTime": "2024-12-11T21:22:00Z",
              "startTime": "2024-10-31T20:14:49Z",
              "timeZone": "America/Los_Angeles"
      },
      "source": {
          "eventTrigger": {
              "customerProfilesDomainArn": {{<Domain ARN>}}
  }
  ```
+ **PutProfileOutboundRequestBatch**

  您无法直接调用此 API，但它会记录在您的 Cloudtrail 日志中。此 API 用于在收到事件后触发活动，也是发起语音通话、电子邮件或短信的机制。