

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 in Connect Customer sito web di 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)
**Importante**  
Per creare una campagna con widget di comunicazione, devi disporre di un'integrazione dei profili dei clienti tra il dominio Customer Profiles e la tua istanza. Il nome del tipo di oggetto richiesto è`Campaign-WebNotification`. Puoi farlo scegliendo il pulsante di aggiornamento nella console del sito Web di Connect Customer amministrazione, selezionando l'istanza e quindi andando alla sottopagina **Campagne in uscita**.  
![Sezione Comunicazione che mostra il menu a discesa Modalità di consegna con il widget Comunicazione selezionato.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/shows_channel_option.png)  
![Sezione Comunicazione che mostra il menu a discesa del widget Comunicazione con My-custom-widget selezionato e Tipo di notifica.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/shows_channel_option_after_a_widget_is_selected.png)

   È possibile scegliere tra due tipi di notifica: **Visualizza** e **Azione**.  
**Visualizzazione**  
Una notifica di **visualizzazione** mostra un messaggio visivo o un prompt sopra il pulsante del widget di comunicazione. Presenta informazioni all'utente finale, come un saluto, un'offerta o un messaggio contestuale. La notifica invita l'utente finale a impegnarsi in una conversazione con un agente o un bot.  
Seleziona **Visualizza** se desideri mostrare un messaggio, una promozione o un suggerimento contestuale all'utente finale prima che inizi una conversazione. In questo modo l'utente finale ha un momento per leggere e decidere se impegnarsi o meno.  
Esempi:  
   + Un banner proattivo che dice «Ciao\! Abbiamo notato che sei su questa pagina da un po' di tempo. Hai bisogno di aiuto per trovare il piano giusto?»
   + Un messaggio promozionale: «Offerta limitata nel tempo: chatta con noi per ottenere il 20% di sconto sul tuo upgrade».
   + Un suggerimento contestuale: «Hai problemi a completare l'ordine? Siamo qui per aiutarti».  
**Azione**  
Una notifica di **azione** ignora qualsiasi messaggio visivo e attiva immediatamente l'apertura del widget di comunicazione e avvia una conversazione direttamente con un bot o un agente umano.  
Seleziona **Azione** se desideri saltare completamente la fase di notifica e avviare l'utente finale direttamente in una conversazione dal vivo. Non viene visualizzato alcun messaggio intermedio.  
Esempi:  
   + Il sistema collega immediatamente un cliente con intenzioni elevate su una pagina di pagamento a un agente dell'assistenza.
   + Il sistema indirizza un cliente abituale con un caso aperto direttamente in un flusso di bot per verificarne lo stato.
   + Un cliente VIP attiva una connessione istantanea a un agente dedicato quando visita la pagina di aiuto.  
![Visualizza il tipo di notifica selezionato, una visualizzazione con l'integrazione del servizio di notifica Web scelta.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/shows_view_notification_type_recommender.png)

   I suggerimenti sono disponibili solo quando si seleziona il tipo di notifica **Visualizza** e la visualizzazione selezionata ha un tipo di integrazione con **Web Notification Service**. Se si seleziona il tipo di notifica **Azione** o se la visualizzazione selezionata non dispone di questa integrazione, l'opzione di raccomandazione non viene visualizzata.

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 Consigli nella console Amazon Connect che mostra il menu a discesa Recommender con frequently_paired_items selezionato.](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)

## Creare campagne in uscita con trigger di eventi utilizzando le API
<a name="how-to-create-campaigns-using-event-triggers-api"></a>

**API di attivazione degli eventi Connect Customer Customer Profiles**
+ 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.  |  Number/Date\*  | 
|  NOT\_BETWEEN  |  True se la destinazione non è compresa in un determinato intervallo di valori o timestamp.  |  Number/Date\*  | 
|  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.

**API di trigger di eventi di Outbound Campaigns**
+ **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. 