本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用事件觸發條件建立傳出行銷活動
在 Amazon Connect 管理網站中設定事件觸發條件
使用 APIs傳出行銷活動
Amazon Connect Customer Profiles 事件觸發 APIs
-
會發出兩次 API 呼叫來建立正常運作的事件觸發:
-
CreateEventTrigger:定義要根據指定條件執行的動作。
-
PutIntegration:定義要使用的動作。
-
事件觸發請求的範例:
{
"DomainName": "string",
"EventTriggerName": "string",
"ObjectTypeName": "string",
"SegmentFilter": "string"
"EventTriggerConditions":
# Conditions have default OR relationship, allow max of 5 items
{
"LogicalOperator": "ALL|ANY|NONE",
"Dimensions": [
# Attributes within the dimension have default AND relationship,
# Allow max of 10 items
{
"ObjectAttributes": [
{
"Source": "string",
"FieldName": "string",
"ComparisonOperator": "enum
", # See table below
"Values": ["string"] # Allow max of 10 items
}
]
}
]
},
"EventTriggerLimits": {
"EventExpiration": Long,
"Periods": [
{
"MaxInvocationsPerProfile": Integer,
"Unlimited": false
"Unit": "DAY", // HOUR/DAY/WEEK/MONTH
"Value": Integer // The amount of time of the specified unit
}
]
}
}
ComparisonOperator
支援下列值:
ComparisonOperator | 註解 | 支援的類型 |
---|---|---|
INCLUSIVE | 檢查目標是否包含所有指定的值。 | 字串 |
專屬 | 檢查目標是否不包含所有指定的值。 | 字串 |
CONTAINS | 檢查目標是否包含任何指定的值。 | 字串 |
BEGINS_WITH | 檢查目標是否以指定的值開頭。 | 字串 |
ENDS_WITH | 檢查目標是否以指定的值結束。 | 字串 |
GREATER_THAN | 如果目標大於指定的值,則為 True。 | Number |
LESS_THAN | 如果目標小於指定的值,則為 True。 | Number |
GREATER_THAN_OR_EQUAL | 如果目標大於或等於指定的值,則為 True。 | Number |
LESS_THAN_OR_EQUAL | 如果目標小於或等於指定的值,則為 True。 | Number |
EQUAL | 如果目標等於指定的值,則為 True。 | Number |
往返 | 如果目標位於特定值範圍或時間戳記內,則為 True。 | 數字/日期* |
NOT_BETWEEN | 如果目標不在特定值範圍或時間戳記內,則為 True。 | 數字/日期* |
之前 | 如果目標在指定的時間戳記之前,則為 True。 | 日期 |
之後 | 如果目標在指定的時間戳記之後,則為 True。 | 日期 |
開啟 | 如果目標位於指定的時間戳記上,則為 True。 | 日期 |
-
來源:用於定義 物件中的屬性。
-
單一
ObjectAttribute
項目中只允許一個屬性。
-
-
FieldName:用於指向資料映射中的映射屬性。
-
單一
ObjectAttribute
項目中只允許一個屬性。
-
-
ObjectTypeName:支援所有預設和自訂物件類型名稱,但不支援標準物件類型,例如
_profile
、_asset
、_order
和其他。 -
EventTriggerLimits:
-
根據預設,每個客戶網域最多允許 20 個並行事件觸發。
-
預設限制為每天 10 次叫用,每個設定檔,每個觸發。您可以在 中指定 來覆寫此項目
UNLIMITED
MaxInvocationPerProfile
。 -
MaxInvocationPerProfile:
-
有效範圍:最小值為 1。最大值為 1000。(或
UNLIMITED
)
-
-
單位:
-
有效值:HOURS、DAYS、WEKS、MONTHS
-
-
值:
-
有效範圍:最小值為 1。最大值為 24
-
-
-
時間範圍比較
-
Customer Profiles 使用標準程式庫來剖析時間值。對於全球服務,請務必考慮時區轉換,以確保準確處理。
-
-
EventExpiration
值以毫秒為單位指定。用於觸發行銷活動時,最大過期時間上限為 15 分鐘。
傳出行銷活動事件觸發 APIs
-
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 的機制。