As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Criar uma campanha externa usando gatilhos de eventos
**Configurar acionadores de eventos no site de administração Connect Customer**
1. Na página **Configuração da campanha**, selecione **Evento para clientes** em **Destinatários.**
1. Selecione uma **fonte de eventos** para especificar a fonte dos dados e configure as condições do atributo que ativarão o gatilho do evento.
As fontes de eventos são baseadas em integrações em seu domínio Perfis de clientes. Para conhecer os detalhes sobre como configurar sua aplicação externa, consulte [Integrar a aplicações externas](integrate-external-apps-customer-profiles.md#setup-integrations-title-menu). Você também pode fazer a integração ao [Kinesis](customer-profiles-kinesis-integration.md) ou ao [S3](customer-profiles-object-type-mappings.md).
1. Selecione o **modo de entrega** e as configurações adicionais de comunicação.
1. (Opcional) Configure a seção **Recomendações** para integrar o Predictive Insights à sua campanha acionada por eventos. Isso permite que você forneça conteúdo de modelo personalizado por meio de canais de e-mail e SMS.
Configure as seguintes opções:
+ **Nome do recomendador** — Selecione o nome do recomendador que você deseja usar para gerar recomendações para os perfis associados à campanha. Você só pode usar recomendadores ativos para gerar recomendações.
O Predictive Insights oferece vários tipos de recomendações. Para obter mais informações, consulte [Etapa 3: Criação de insights preditivos](predictive-insights-get-started.md#create-predictive-insights).
+ **Atributo calculado para o recomendador** — Essa configuração só é necessária ao usar um tipo de recomendador de *itens semelhantes* ou *itens frequentemente emparelhados*. Esse contexto ajuda o mecanismo de recomendação a entender em qual produto basear as sugestões, permitindo recomendações mais relevantes e direcionadas para seus clientes.
Por exemplo, você pode usar um atributo calculado como `_last_interacted_item_id` aquele que captura a ID do item comprado.
+ **Número de recomendações** — O número máximo de recomendações a serem geradas para um perfil. Isso pode variar de 1 a 3 recomendações.
+ **Atributos de recomendação** — defina quais atributos da resposta das recomendações são usados em seu modelo de mensagem.
Para obter mais informações sobre o Predictive Insights, consulte[Comece a usar o Predictive Insights](predictive-insights-get-started.md).
1. Verifique suas configurações e escolha **Publicar**.
## Crie campanhas externas com acionadores de eventos usando APIs
**Acionador do evento Amazon Connect Customer Profiles APIs**
+ Duas chamadas de API são feitas para criar um gatilho de eventos funcional:
+ [CreateEventTrigger](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_CreateEventTrigger.html): define qual ação executar com base em uma condição especificada.
+ [PutIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_PutIntegration.html): define a ação a ser usada.
**Exemplo de uma solicitação de gatilho de evento:**
```
{
"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"
}
}
```
**O `ComparisonOperator` comporta os seguintes valores:**
| ComparisonOperator | Comment | Tipos aceitos |
| --- | --- | --- |
| INCLUSIVE | Confere se o destino inclui todos os valores especificados. | String |
| EXCLUSIVO | Confere se o destino não contém todos os valores especificados. | String |
| CONTAINS | Confere se o destino contém algum dos valores especificados. | String |
| BEGINS\_WITH | Confere se o destino começa com o valor especificado. | String |
| ENDS\_WITH | Confere se o destino termina com o valor especificado. | String |
| MAIOR\_QUE | Verdadeiro se o destino for maior que o valor especificado. | Número |
| MENOS\_QUE | Verdadeiro se o destino for menor que o valor especificado. | Número |
| GREATER\_THAN\_OR\_EQUAL | Verdadeiro se o destino for maior ou igual ao valor especificado. | Número |
| LESS\_THAN\_OR\_EQUAL | Verdadeiro se o destino for menor ou igual ao valor especificado. | Número |
| EQUAL | Verdadeiro se o destino for igual ao valor especificado. | Número |
| ENTRE | Verdadeiro se o destino estiver dentro de um intervalo de valores ou carimbo de data/hora específicos. | Número/Data\* |
| NOT\_BETWEEN | Verdadeiro se o destino não estiver dentro de um intervalo de valores ou carimbo de data/hora específicos. | Número/Data\* |
| ANTES | Verdadeiro se o destino for anterior ao carimbo de data/hora especificado. | Data |
| DEPOIS | Verdadeiro se o destino for após o carimbo de data/hora especificado. | Data |
| LIGADO | Verdadeiro se o destino estiver no carimbo de data/hora especificado. | Data |
+ **Fonte**: usada para definir um atributo no objeto.
+ Somente um atributo é permitido em uma única entrada `ObjectAttribute`.
+ **FieldName**: usado para apontar para o atributo mapeado no mapeamento de dados.
+ Somente um atributo é permitido em uma única entrada `ObjectAttribute`.
+ **ObjectTypeName**: oferece suporte a todos os nomes de tipos de objetos padrão e personalizados, mas não aos tipos de objetos padrão`_profile`, como `_asset``_order`,, e outros.
+ **EventTriggerLimits**:
+ Por padrão, permite no máximo vinte gatilhos de eventos simultâneos por domínio do cliente.
+ Limite padrão de dez invocações por dia, por perfil, por gatilho. Você pode substituir isso especificando `UNLIMITED` em `MaxInvocationPerProfile`.
+ **MaxInvocationPerProfile**:
+ Faixa válida: valor mínimo de 1. Valor máximo de 1.000 (ou `UNLIMITED`).
+ Unidade:
+ Valores válidos: HOURS, DAYS, WEEKS, MONTHS
+ Value (Valor):
+ Faixa válida: valor mínimo de 1. Valor máximo de 24
+ Comparação de intervalo de tempo
+ O Customer Profiles usa bibliotecas padrão para analisar valores de tempo. Para serviços globais, é importante considerar as conversões de fuso horário para garantir um processamento preciso.
+ O valor `EventExpiration` é especificado em milissegundos. Quando usado para acionar uma campanha, o tempo máximo de expiração é limitado a 15 minutos.
**Acionador de eventos de campanhas externas APIs**
+ **CreateCampaignV2**
As únicas mudanças necessárias para criar uma campanha acionada por eventos são os campos destacados. Os demais campos são os mesmos que aparecem em Campanhas agendadas.
```
{
"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": {{}},
"schedule": {
"endTime": "2024-12-11T21:22:00Z",
"startTime": "2024-10-31T20:14:49Z",
"timeZone": "America/Los_Angeles"
},
"source": {
"eventTrigger": {
"customerProfilesDomainArn": {{}}
}
```
+ **PutProfileOutboundRequestBatch**
Você não pode invocar diretamente essa API, mas ela será registrada nos seus logs do Cloudtrail. Essa API é usada para acionar uma campanha após o recebimento de um evento e é o mecanismo que inicia uma chamada de voz, e-mail ou SMS.