

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

# 使用事件触发器创建出站活动
<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)

   有两种通知类型可供选择：**查看**和**操作**。  
**视图**  
**查看**通知在通信小部件按钮上方显示可视消息或提示。它向最终用户提供信息，例如问候、优惠或上下文消息。该通知邀请最终用户与代理或机器人进行对话。  
如果您想**在最终用户开始对话之前向他们显示消息、促销或情境推送，请选择 “**查看”。这使最终用户有时间阅读并决定是否参与。  
示例：  
   + 一面主动的横幅上写着 “嗨！我们注意到你在这个页面上已经有一段时间了。需要帮助找到正确的计划吗？”
   + 促销信息：“限时优惠——与我们聊天即可获得20％的升级折扣。”
   + 上下文推介：“在完成订单时遇到问题？ 我们是来帮忙的。”  
**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`获购买的物品 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>

**连接客户客户档案事件触发器 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 用于在收到事件后触发活动，也是发起语音通话、电子邮件或短信的机制。