

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creare una campagna in uscita utilizzando i trigger di eventi
<a name="how-to-create-campaigns-using-event-triggers"></a>

**Imposta i trigger degli eventi nel sito Web di Connect Customer amministrazione**

1. Nella pagina **Impostazione della campagna**, seleziona **Evento cliente** in **Destinatari**.  
![Pagina di configurazione della campagna con Evento del cliente selezionato nella sezione Destinatari per le campagne attivate da eventi.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-1.png)

1. Seleziona un’**Origine evento** per specificare da dove provengono i dati e configura le condizioni degli attributi che attiveranno il trigger di eventi.

   Le origini degli eventi si basano sulle integrazioni nel dominio Customer Profiles. Per informazioni dettagliate sulla configurazione di un’applicazione esterna, consulta [Integrazione con applicazioni esterne](integrate-external-apps-customer-profiles.md#setup-integrations-title-menu). Puoi anche eseguire integrazioni con [Kinesis](customer-profiles-kinesis-integration.md) o [S3](customer-profiles-object-type-mappings.md).  
![Pannello di selezione dell’origine dell’evento che mostra le opzioni di integrazione e la configurazione delle condizioni degli attributi.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-2.png)

1. Seleziona **Modalità di consegna** e le impostazioni di comunicazione aggiuntive.  
![Selezione della modalità di consegna e impostazioni di comunicazione aggiuntive per le campagne attivate da eventi.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-3.png)

1. (Facoltativo) Configura la sezione **Consigli** per integrare Predictive Insights con la tua campagna attivata da eventi. Ciò consente di fornire contenuti modello personalizzati tramite canali e-mail e SMS.  
![Sezione dei consigli nella console Amazon Connect che mostra il menu a discesa Recommender con frequently_paired_items selezionati, l'attributo calcolato per il consigliere con _last_interacted_item_id, il numero di consigli impostato su 3 e gli attributi di raccomandazione con nome, prezzo, descrizione e categoria selezionati. ImageLink](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/how-to-create-campaigns-recommendations.png)

   Configura le impostazioni seguenti:
   + Nome del **segnalatore: seleziona il nome del consulente che desideri utilizzare per generare consigli** per i profili associati alla campagna. Puoi utilizzare solo i consiglieri attivi per generare consigli.

     Predictive Insights offre diversi tipi di consigli. Per ulteriori informazioni, consulta [Fase 3: Creazione di informazioni predittive](predictive-insights-get-started.md#create-predictive-insights).
   + **Attributo calcolato per il consulente: questa impostazione è richiesta solo quando si utilizza un tipo di raccomandazione** *per articoli simili* o *Articoli associati frequentemente*. Questo contesto aiuta il motore di raccomandazione a capire su quale prodotto basare i suggerimenti, offrendo consigli più pertinenti e mirati per i clienti.

     Ad esempio, potresti utilizzare un attributo calcolato come `_last_interacted_item_id` quello che acquisisce l'ID dell'articolo acquistato.
   + **Numero di consigli**: il numero massimo di consigli da generare per un profilo. Questo valore può variare da 1 a 3 consigli.
   + **Attributi dei consigli**: definisci quali attributi della risposta ai consigli vengono utilizzati nel modello di messaggio.

   Per ulteriori informazioni su Predictive Insights, consulta[Inizia a usare Predictive Insights](predictive-insights-get-started.md).

1. Verifica le configurazioni e scegli **Pubblica**.  
![Schermata di revisione finale per la configurazione di una campagna attivata da eventi con il pulsante Pubblica.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-4.png)

## Crea campagne in uscita con attivatori di eventi utilizzando APIs
<a name="how-to-create-campaigns-using-event-triggers-api"></a>

**Attivazione dell'evento Amazon Connect Customer Profiles APIs**
+ Vengono effettuate due chiamate API per creare un trigger di evento funzionante: 
  +  [CreateEventTrigger](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_CreateEventTrigger.html): definisce l'azione da eseguire in base a una condizione specificata.
  +  [PutIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_PutIntegration.html): definisce l'azione da utilizzare.

**Esempio di richiesta di un trigger di eventi:**

```
{
"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` supporta i seguenti valori:**


|  ComparisonOperator  |  Comment  |  Tipo supportato  | 
| --- | --- | --- | 
|  INCLUSIVE  |  Verifica se la destinazione include tutti i valori specificati.  |  Stringa  | 
|  ESCLUSIVO  |  Verifica se la destinazione non contiene tutti i valori specificati.  |  Stringa  | 
|  CONTAINS  |  Verifica se la destinazione contiene uno o più dei valori specificati.  |  Stringa  | 
|  BEGINS\_WITH  |  Verifica se la destinazione inizia con il valore specificato.  |  Stringa  | 
|  ENDS\_WITH  |  Verifica se la destinazione finisce con il valore specificato.  |  Stringa  | 
|  MAGGIORE DI  |  True se la destinazione è maggiore del valore specificato.  |  Numero  | 
|  MINORE\_DI  |  True se la destinazione è minore del valore specificato.  |  Numero  | 
|  GREATER\_THAN\_OR\_EQUAL  |  True se la destinazione è maggiore o uguale al valore specificato.  |  Numero  | 
|  LESS\_THAN\_OR\_EQUAL  |  True se la destinazione è minore o uguale al valore specificato.  |  Numero  | 
|  EQUAL  |  True se la destinazione è uguale al valore specificato.  |  Numero  | 
|  TRA  |  True se la destinazione è compresa in un determinato intervallo di valori o timestamp.  |  Numero/data\*  | 
|  NOT\_BETWEEN  |  True se la destinazione non è compresa in un determinato intervallo di valori o timestamp.  |  Numero/data\*  | 
|  PRIMA  |  True se la destinazione è precedente al timestamp specificato.  |  Data  | 
|  DOPO  |  True se la destinazione è successiva al timestamp specificato.  |  Data  | 
|  SU  |  True se la destinazione corrisponde al timestamp specificato.  |  Data  | 
+ **Source**: consente di definire un attributo nell’oggetto.
  + È consentito un solo attributo in una singola voce `ObjectAttribute`. 
+ **FieldName**: utilizzato per indicare l'attributo mappato nella mappatura dei dati.
  + È consentito un solo attributo in una singola voce `ObjectAttribute`. 
+ **ObjectTypeName**: supporta tutti i nomi dei tipi di oggetto predefiniti e personalizzati, ma non i tipi di oggetto standard, come`_profile`, `_asset``_order`, e altri. 
+ **EventTriggerLimits**:
  +  Per impostazione predefinita, consente un massimo di 20 trigger di eventi simultanei per dominio del cliente. 
  +  Limite predefinito di 10 invocazioni al giorno, per profilo, per trigger. È possibile ignorare questa impostazione specificando `UNLIMITED` in `MaxInvocationPerProfile`. 
  +  **MaxInvocationPerProfile**:
    + Intervallo valido: valore minimo di 1. Valore massimo pari a 1000 (o `UNLIMITED`).
  +  Unità:
    + Valori validi: HOURS, DAYS, WEEKS, MONTHS
  +  Valore:
    + Intervallo valido: valore minimo di 1. Valore massimo di 24
+  Confronto tra intervalli di tempo 
  +  Customer Profiles utilizza librerie standard per analizzare i valori temporali. Per i servizi globali, è importante tenere conto delle conversioni di fuso orario per assicurare un’elaborazione accurata. 
+ Il valore `EventExpiration` è specificato in millisecondi. Quando viene utilizzato per attivare una campagna, il tempo di scadenza massimo è limitato a 15 minuti.

**Attivazione di un evento per le campagne in uscita APIs**
+ **CreateCampaignV2**

  Per creare una campagna attivata da eventi occorre modificare solo i campi evidenziati. Gli altri campi sono gli stessi delle campagne pianificate.

  ```
  {
      "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**

  Non è possibile invocare direttamente questa API, ma verrà registrata nei log di Cloudtrail. Questa API viene utilizzata per attivare una campagna dopo la ricezione di un evento ed è il meccanismo che avvia una chiamata vocale, un’e-mail o un SMS. 