

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 이벤트 트리거를 사용하여 아웃바운드 캠페인 생성
<a name="how-to-create-campaigns-using-event-triggers"></a>

**Amazon Connect 관리자 웹 사이트에서 이벤트 트리거 설정**

1. **캠페인 설정** 페이지의 **수신자**에서 **고객 이벤트**를 선택합니다.  
![\[이벤트 트리거 캠페인의 수신자 섹션에서 고객 이벤트가 선택된 캠페인 설정 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/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/ko_kr/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-2.png)

1. **전송 모드** 및 추가 커뮤니케이션 설정을 선택합니다.  
![\[이벤트 트리거 캠페인에 대한 전송 모드 선택 및 추가 통신 설정입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-3.png)

1. (선택 사항) 예측 인사이트를 이벤트 트리거 캠페인과 통합하도록 **권장 사항** 섹션을 구성합니다. 이를 통해 이메일 및 SMS 채널을 통해 개인화된 템플릿 콘텐츠를 제공할 수 있습니다.  
![\[Amazon Connect 콘솔의 권장 사항 섹션에는 frequently_paired_items가 선택된 추천 드롭다운, _last_interacted_item_id가 포함된 추천자의 계산된 속성, 3으로 설정된 추천 수, 이름, 가격, 설명, ImageLink 및 범주가 선택된 추천 속성이 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/how-to-create-campaigns-recommendations.png)

   다음 설정을 구성합니다.
   + **추천자 이름** - 캠페인과 연결된 프로필에 대한 추천을 생성하는 데 사용할 추천자의 이름을 선택합니다. 활성 상태인 추천만 사용하여 추천을 생성할 수 있습니다.

     예측 인사이트는 몇 가지 유형의 권장 사항을 제공합니다. 자세한 내용은 [3단계: 예측 인사이트 생성](predictive-insights-get-started.md#create-predictive-insights) 단원을 참조하십시오.
   + **추천자에 대해 계산된 속성 **-이 설정은 *유사 항목* 또는 *자주 페어링되는 항목* 추천자 유형을 사용할 때만 필요합니다. 이 컨텍스트는 추천 엔진이 제안의 기반이 될 제품을 이해하는 데 도움이 되므로 고객에게 보다 관련성이 높고 타겟팅된 추천을 제공할 수 있습니다.

     예를 들어 구매한 항목 ID를 캡처`_last_interacted_item_id`하는와 같은 계산된 속성을 사용할 수 있습니다.
   + **권장 사항 수** - 프로필에 대해 생성할 최대 권장 사항 수입니다. 권장 사항의 범위는 1\$13개입니다.
   + **권장 사항 속성** - 메시지 템플릿에 사용할 권장 사항 응답의 속성을 정의합니다.

   예측 인사이트에 대한 자세한 내용은 섹션을 참조하세요[예측 인사이트 시작하기](predictive-insights-get-started.md).

1. 구성을 확인하고 **게시**를 선택합니다.  
![\[게시 버튼이 있는 이벤트 트리거 캠페인 구성에 대한 최종 검토 화면입니다.\]](http://docs.aws.amazon.com/ko_kr/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>

**Amazon Connect Customer Profiles 이벤트 트리거 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  |  설명  |  지원되는 유형  | 
| --- | --- | --- | 
|  INCLUSIVE  |  대상에 지정된 모든 값이 포함되어 있는지 확인합니다. |  문자열  | 
|  배타적  |  대상에 지정된 값이 모두 포함되어 있지 않은지 확인합니다. |  문자열  | 
|  CONTAINS  |  대상에 지정된 값이 포함되어 있는지 확인합니다. |  문자열  | 
|  BEGINS\$1WITH  |  대상이 지정된 값으로 시작하는지 확인합니다. |  문자열  | 
|  ENDS\$1WITH  |  대상이 지정된 값으로 끝나는지 확인합니다. |  문자열  | 
|  GREATER\$1THAN  |  대상이 지정된 값보다 큰 경우 true입니다. |  숫자  | 
|  LESS\$1THAN  |  대상이 지정된 값보다 작은 경우 true입니다. |  숫자  | 
|  GREATER\$1THAN\$1OR\$1EQUAL  |  대상이 지정된 값보다 크거나 같은 경우 true입니다. |  숫자  | 
|  LESS\$1THAN\$1OR\$1EQUAL  |  대상이 지정된 값보다 작거나 같은 경우 true입니다. |  숫자  | 
|  EQUAL  |  대상이 지정된 값과 같은 경우 true입니다. |  숫자  | 
|  사이  |  대상이 특정 값 범위 또는 타임스탬프 내에 있는 경우 true입니다. |  숫자/날짜\$1  | 
|  NOT\$1BETWEEN  |  대상이 특정 값 범위 또는 타임스탬프 내에 있지 않은 경우 true입니다. |  숫자/날짜\$1  | 
|  이전  |  대상이 지정된 타임스탬프보다 이전인 경우 true입니다. |  Date  | 
|  이후  |  대상이 지정된 타임스탬프보다 이후인 경우 true입니다. |  Date  | 
|  ON  |  대상이 지정된 타임스탬프에 있는 경우 true입니다. |  Date  | 
+ **소스**: 객체에서 속성을 정의하는 데 사용됩니다.
  + 단일 `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는 이벤트를 수신한 후 캠페인을 트리거하는 데 사용되며 음성 통화, 이메일 또는 SMS를 시작하는 메커니즘입니다.