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à. # Configurazione dell’e-mail in Amazon Connect Di seguito è riportata una panoramica dei passaggi per configurare il canale e-mail per il contact center. + [Abilitazione di e-mail per l’istanza Amazon Connect](enable-email1.md). Durante questo processo si ottiene un indirizzo e-mail generato automaticamente. Hai anche la possibilità di aggiungere cinque indirizzi personalizzati. + [Creazione di indirizzi e-mail](create-email-address1.md). + [Crea o aggiorna le code](create-queue.md) per le e-mail: nella sezione Configurazione della **posta elettronica in uscita**: + **Indirizzo e-mail predefinito: specifica l'indirizzo** e-mail in uscita preselezionato per gli agenti quando rispondono o avviano le e-mail. + Deve essere un indirizzo e-mail verificato all'interno di Amazon Connect (un indirizzo e-mail creato in Amazon Connect con un dominio verificato Amazon SES). + Questo deve essere l'indirizzo e-mail più usato per questa coda. + Per le e-mail in uscita avviate da un agente, gli agenti possono inviare e-mail utilizzando l'indirizzo e-mail predefinito dalla coda in uscita predefinita configurata nel loro profilo di routing. Gli agenti possono anche scegliere tra gli **indirizzi e-mail aggiuntivi** configurati nella coda, offrendoti la flessibilità di controllare quali indirizzi e-mail gli agenti possono utilizzare in base al loro ruolo o al loro team. + Questo modello è simile ai contatti vocali in uscita, in cui si specificano l'ID del chiamante in uscita e il flusso per coda e gli agenti utilizzano la coda in uscita predefinita dal loro profilo di routing. + Flusso di **posta elettronica in uscita: seleziona un flusso** da eseguire per le e-mail in uscita inviate da questa coda. Puoi selezionare il [Flusso in uscita predefinito in Amazon Connect: "Questa chiamata non viene registrata"](default-outbound.md) o un altro flusso di tipo In uscita. + Il flusso di posta elettronica in uscita che configuri qui si applica alle risposte dell'agente ai contatti e-mail in entrata ricevuti su questa coda e alle e-mail in uscita avviate dall'agente quando questa coda è selezionata come coda in uscita predefinita nel profilo di routing dell'agente. + Se non si specifica un flusso di posta elettronica in uscita, viene utilizzato automaticamente per tutte le e-mail in uscita da questa coda. [Flusso in uscita predefinito in Amazon Connect: "Questa chiamata non viene registrata"](default-outbound.md) + Analogamente ai contatti vocali in uscita, la configurazione di diversi flussi di posta elettronica in uscita per coda offre la flessibilità necessaria per eseguire flussi di contatti diversi in base alla coda. Ciò consente di personalizzare l'esperienza di posta elettronica in uscita per diversi team, marchi o unità aziendali. Nella sezione **Indirizzi e-mail aggiuntivi**: + **Cerca indirizzi e-mail**: seleziona fino a 49 indirizzi e-mail aggiuntivi che gli agenti possono utilizzare per rispondere o avviare le e-mail. Gli agenti possono scegliere tra tutti gli indirizzi e-mail configurati (predefiniti e aggiuntivi) utilizzando un elenco a discesa nel loro spazio di lavoro (vedi). [Seleziona un indirizzo e-mail da](agent-select-from-email.md) È possibile configurare fino a 50 indirizzi e-mail totali per coda (1 predefinito \$1 49 aggiuntivi). L'elenco di indirizzi e-mail disponibili rispetta il [controllo degli accessi basato su tag (](https://docs.aws.amazon.com/connect/latest/adminguide/tag-based-access-control.html)TBAC). Gli agenti vedono solo gli indirizzi e-mail che hanno il permesso di utilizzare in base ai tag loro assegnati. + [Creazione o aggiornamento dei profili di routing](routing-profiles.md) per specificare che gli agenti possono gestire i contatti e-mail. **Importante** Il profilo di routing: La **coda in uscita predefinita** definisce l'elenco di indirizzi e-mail disponibili per gli agenti per tutte le e-mail in uscita che inviano. Gli agenti possono scegliere tra gli indirizzi e-mail configurati in questa coda. **Numero massimo di contatti per agente** definisce il numero di e-mail che gli agenti possono ricevere e il doppio di tale numero indica il numero di e-mail in uscita che gli agenti possono avviare. Ad esempio, se imposti **Numero massimo di contatti per agente** su 5, ogni agente può ricevere fino a 5 e-mail e creare fino a 10 e-mail in uscita avviate dall’agente. + [Creare i modelli di messaggio](create-message-templates1.md). I modelli di e-mail possono definire la struttura dell’e-mail per l’agente, ad esempio per una firma o un disclaimer, oppure possono essere una risposta completa. + Configura i flussi con il blocco [invia messaggio](send-message.md). Utilizza questo blocco per inviare un messaggio al cliente sulla base di un modello o di un messaggio personalizzato. Inoltre, puoi specificare: + Gli indirizzi e-mail e i nomi visualizzati di destinatari e mittenti. È possibile specificarli manualmente o dinamicamente utilizzando [Attributi di sistema](connect-attrib-list.md#attribs-system-table), ad esempio: + **Indirizzo endpoint cliente**: è l’indirizzo e-mail del cliente che ha avviato il contatto. + **Indirizzo e-mail del sistema**: è l’indirizzo a cui il cliente ha inviato l’e-mail. + **Nome visualizzato del cliente**: viene acquisito dall’e-mail che il cliente ti ha inviato. + **Nome visualizzato del sistema**: il nome visualizzato dell’e-mail a cui il cliente ha eseguito l’invio. + **Elenco di indirizzi e-mail "Cc"**: l’elenco completo degli indirizzi e-mail in copia nell’e-mail del cliente. + **Elenco di indirizzi e-mail "A"**: l’elenco completo degli indirizzi e-mail dei destinatari presenti nell’e-mail del cliente. Ad esempio, per inviare una risposta automatica quando un cliente ti invia un’e-mail, imposta **Indirizzo e-mail** dinamicamente sull’**indirizzo dell’endpoint del cliente** e **Nome visualizzato** dinamicamente su **Nome visualizzato del cliente**. + **Messaggio**: specifica un modello o immetti un testo semplice. + Puoi specificare l’**Oggetto** in modo dinamico utilizzando l’**attributo del segmento** - **Oggetto dell’e-mail**. + Puoi specificare il **Messaggio** dinamicamente scegliendo un attributo **definito dall’utente**. + **Link al contatto**: scegli se desideri collegare l’e-mail di contatto in entrata a quella di contatto in uscita. Potresti non voler scegliere questa opzione per le e-mail di risposta automatica. + Utilizza gli attributi nel blocco [Verifica attributi contatto](check-contact-attributes.md) per controllare il canale di contatto. Se si tratta di un’e-mail, puoi utilizzare il seguente [Attributi di segmento](connect-attrib-list.md#attribs-segment-attributes) per controllare: + **Oggetto dell’e-mail**: ad esempio, puoi controllare l’oggetto per determinate parole chiave. + **Amazon SES Spam Verdict** **sui virus di Amazon SES**: quando arriva l’e-mail del cliente, Amazon SES la analizza alla ricerca di spam e virus. Ad esempio, se la condizione è uguale a FAILED (ovvero, l’e-mail non ha superato il controllo), puoi disconnettere il contatto o inviarlo a una coda speciale per consentire ai responsabili di esaminarlo. + Assegna la seguente autorizzazione al profilo di sicurezza agli agenti che devono inviare e-mail in uscita. + **Pannello di controllo contatti (CCP)** - **Avvia una conversazione via e-mail** # Funzionamento dell’e-mail Amazon Connect Amazon Connect Email offre funzionalità integrate che semplificano la definizione delle priorità, l’assegnazione e l’automazione della risoluzione delle e-mail del servizio clienti, migliorando la soddisfazione dei clienti e la produttività degli agenti. Puoi ricevere e rispondere alle e-mail inviate dai clienti agli [indirizzi e-mail configurati](create-email-address1.md) o inviate utilizzando i moduli Web sul tuo sito Web o sull'app mobile utilizzando l'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API. Amazon Connect Email si integra con [Amazon Simple Email Service (SES)](https://docs.aws.amazon.com/ses/latest/dg/Welcome.html) per inviare, ricevere e monitorare le e-mail per individuare [contenuti contrassegnati come spam o contenenti virus](https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-auth-and-scan), [percentuali di successo della consegna](https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) e [risultati sulla reputazione del mittente](https://docs.aws.amazon.com/ses/latest/dg/monitor-sender-reputation.html). Questo argomento spiega come funzionano Amazon Connect Email e Amazon SES, per offrire un’esperienza clienti perfetta. **Topics** + [Ricezione delle e-mail](#email-capabilities-howreceived) + [Contatti e-mail](#email-capabilities-howtranslated) + [Ogni messaggio e-mail è un contatto e-mail unico](#email-capabilities-howmanaged) + [Thread di e-mail](#email-capabilities-howthreadsmanaged) + [Invio di e-mail](#email-capabilities-howemailssent) ## Ricezione delle e-mail Esistono tre modi principali in cui Amazon Connect può ricevere e-mail: + **Metodo 1**: tramite un [indirizzo e-mail](create-email-address1.md) definito in Amazon Connect (ad esempio, support@ *customer-domain* .com) utilizzando un [dominio e-mail verificato di Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc), ad esempio il dominio e-mail fornito con l'istanza Amazon Connect (ad esempio, @ *instance-alias* .email.connect.aws) o un dominio verificato personalizzato di tua proprietà o fornito dalla tua azienda (ad esempio, @ .com). *customer-domain* Per informazioni dettagliate sull’onboarding di domini e-mail personalizzati, consulta [Fase 3: utilizzare domini e-mail personalizzati](enable-email1.md#use-custom-email) in [Abilitazione di e-mail per l’istanza](enable-email1.md). + **Metodo 2**: utilizzando una regola di routing sul tuo server di posta elettronica (ad esempio, [Microsoft 365 Connectors](https://learn.microsoft.com/en-us/exchange/mail-flow-best-practices/use-connectors-to-configure-mail-flow/set-up-connectors-to-route-mail), [Google Workspace Mail Routes](https://support.google.com/a/answer/2614757?hl=en&ref_topic=2921034&sjid=9077065025577504786-NC)) per inviare l'e-mail in arrivo a uno degli [endpoint SMTP di Amazon SES](https://docs.aws.amazon.com/general/latest/gr/ses.html) utilizzando un dominio e-mail verificato inserito in Amazon SES (ad esempio, @ .com). *customer-domain* + **Metodo 3**: utilizzando l'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API per avviare un contatto e-mail utilizzando un modulo web sul tuo sito Web o nell'app per dispositivi mobili. Ciò avvia i contatti e-mail in entrata in modo simile ai clienti che inviano e-mail agli indirizzi e-mail. Il diagramma seguente illustra come le e-mail inviate dai tuoi clienti vengono ricevute da Amazon Connect utilizzando l'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API per ciascuno dei metodi sopra menzionati. ![\[Un diagramma che mostra come un messaggio viene inviato come modulo web o e-mail all'API. StartEmailContact\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-ses-diagram.png) Per integrare i metodi 1 o 2, è necessario verificare un dominio e-mail su Amazon SES prima di poterlo utilizzare in Amazon Connect. Per istruzioni, consulta [Verifica dell’identità di un dominio DKIM con il provider DNS](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc). Per integrare il Metodo 3, si utilizza l'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API. Questa è l’API primaria di tutti i metodi di integrazione per i contatti e-mail in entrata. Funziona in modo simile a [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html). È necessario eseguire una delle seguenti fasi: + Includere almeno un indirizzo e-mail dell’istanza Amazon Connect negli attributi A o Cc del contatto e-mail in entrata. - OPPURE - + Definire un flusso in entrata dall’istanza Amazon Connect per instradare il contatto e-mail in entrata creato. Se entrambi sono definiti, il comportamento predefinito dà la priorità al flusso in entrata dall’istanza Amazon Connect per gestire il contatto e-mail in entrata creato. Se più indirizzi e-mail dell’istanza Amazon Connect sono inclusi negli attributi degli indirizzi e-mail A o Cc, nell’istanza Amazon Connect verranno creati più contatti e-mail in entrata. ## In che modo i messaggi e-mail diventano contatti e-mail Per la ricezione generica di e-mail in Amazon Connect, incluse le e-mail basate su moduli Web, l'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API espone i campi e-mail di base sull'oggetto della richiesta. Questo oggetto viene utilizzato per inserire informazioni sull’e-mail e avviare un contatto e-mail in Amazon Connect. Sono inclusi i seguenti campi: + Un indirizzo e-mail Da. + Indirizzo/i e-mail A + Indirizzo/i e-mail Cc + Un oggetto + Un corpo del messaggio semplice o HTML + Allegato/i Per ulteriori informazioni su come le informazioni di contatto e-mail vengono inserite nel contatto e-mail, consulta il modello di dati di contatto e-mail di Amazon Connect. Dopo che l'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API ha eseguito la convalida dei parametri di richiesta e si è assicurata che almeno un indirizzo e-mail To o CC sia valido ed esista nell'istanza Amazon Connect, ecco cosa succede: 1. Un ID contatto viene generato e restituito come parte del corpo di risposta dell’API. 1. Viene attivato un flusso di lavoro asincrono per eseguire un’ulteriore elaborazione dei messaggi e-mail. 1. Il flusso viene avviato. Questo è il flusso associato all’indirizzo e-mail trovato nell’istanza Amazon Connect. Come parte di ciò, è necessario configurare l’archiviazione dei messaggi e-mail e degli allegati per l’istanza Amazon Connect. + Sia i messaggi e-mail sia gli allegati vengono archiviati e vi si accede nel bucket Amazon SES S3. + I restanti attributi del contatto e-mail come A, Cc, Oggetto e altri sono memorizzati nel contatto e-mail; consulta l’argomento [Modello di dati per i record di contatto di Amazon Connect](ctr-data-model.md). Il diagramma seguente illustra il flusso del messaggio e-mail dal cliente ad Amazon SES e quindi ad Amazon Connect. Mostra il contenuto del messaggio e-mail memorizzato nel bucket S3, quindi recupera i dati da quel bucket per mostrarli all’agente. ![\[Diagramma che mostra il contenuto dei messaggi e-mail archiviati nel bucket S3.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-concepts-translated.png) ## Ogni messaggio e-mail è un contatto e-mail unico L’e-mail Amazon Connect è diversa da messaggi vocali, chat e attività. + Ogni messaggio e-mail, in entrata o in uscita da Amazon Connect, è un contatto e-mail unico. + Ogni contatto e-mail contiene dettagli specifici di quel messaggio e-mail come indirizzo mittente, indirizzo/i di destinazione, indirizzo/i CC, oggetto relatedContactId, collegamenti al corpo dell'e-mail e alle posizioni di archiviazione degli allegati e altri dettagli relativi al singolo contatto e-mail. Tuttavia, come altri canali di Amazon Connect, un contatto e-mail ha metodi di avvio simili come `INBOUND`, `OUTBOUND`, `TRANSFER`, `API`, `QUEUE_TRANSFER` e `END/DISCONNECT`. Ha anche stati simili, come `CREATED`, `QUEUED`, `CONNECTING`, `CONNECTED`, `MISSED`, `TRANSFERRED`, `ERROR`, `ENDED/DISCONNECTED`, `REJECTED`. Per informazioni su come le informazioni di contatto e-mail vengono inserite nel contatto e-mail, consulta [Modello di dati per i record di contatto di Amazon Connect](ctr-data-model.md). ## Thread di e-mail Tale thread garantisce che le e-mail in uscita e le risposte in entrata relative alla richiesta di un cliente siano associate tra loro in modo cronologico e organizzato. Per mantenere l'intera conversazione e-mail, Amazon Connect collega i contatti e-mail utilizzando alcuni campi del contatto e-mail come relatedContactId e un elenco di intestazioni di e-mail che seguono gli standard convenzionali dei client di posta elettronica (RFC 5256). La maggior parte dei client di posta elettronica come Gmail, Apple Mail e Outlook supporta il threading delle e-mail. Tuttavia, tieni presente che ce ne sono alcuni che non lo supportano. Se il cliente risponde all’ultimo messaggio di posta elettronica del thread, il thread segue uno schema semplice, come mostrato nell’immagine seguente: ![\[Il thread di e-mail in uno schema semplice.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-threading.png) Se il cliente risponde a un messaggio precedente nel thread di e-mail, viene formato un albero di thread di e-mail e il suo schema è simile all’esempio nell’immagine seguente: ![\[Il thread di e-mail in uno schema ad albero.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-threading-tree.png) In entrambi gli scenari Amazon Connect registra un record di ogni messaggio e-mail correlato a un thread. È possibile accedere a ciascuna e-mail tramite l’e-mail successiva. ## Invio di e-mail Tutti i messaggi e-mail di Amazon Connect vengono inviati da Amazon SES direttamente al cliente. Che tu stia utilizzando il dominio e-mail fornito con la tua istanza Amazon Connect (ad esempio, @ *instance-alias* .email.connect.aws) o un dominio verificato personalizzato (ad esempio @ .com)*customer*, Amazon SES è autorizzato verificando l'identità di un dominio a inviare e-mail direttamente ai tuoi clienti. Il diagramma seguente mostra che l'[StartOutboundEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundEmailContact.html)API invia e-mail ad Amazon SES e Amazon SES le invia al cliente. ![\[Diagramma che mostra il flusso di e-mail dall' StartOutboundEmailContact API al cliente tramite SES.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-concepts-sent.png) L'[StartOutboundEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundEmailContact.html)API è l'API principale di tutti i metodi di integrazione per i contatti e-mail in uscita, comprese le risposte degli agenti ai contatti in entrata e i contatti e-mail in uscita avviati dall'agente. + Funziona in modo simile all'[StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API, tuttavia è l'inverso poiché è in uscita. + Richiede almeno un indirizzo e-mail negli attributi dell’indirizzo e-mail A o Cc e richiede un flusso di messaggi in uscita per la gestione del contatto in uscita. # Abilitazione di e-mail per l’istanza Amazon Connect Questo argomento è destinato agli amministratori che hanno accesso alla console Amazon Connect. Spiega come abilitare la posta elettronica per la tua istanza utilizzando il sito Web di Amazon Connect amministrazione. Per un elenco delle opzioni per abilitare la posta elettronica APIs a livello di codice, consulta. [APIs per abilitare la posta elettronica](#apis-email-setup2) Quando abiliti l’e-mail, ottieni un dominio e-mail generato automaticamente. Facoltativamente, puoi anche utilizzare domini personalizzati. + **Dominio e-mail Amazon Connect**. *Il dominio di posta elettronica è .email.connect.aws*instance-alias*.* + Puoi utilizzare questo dominio per i test. + In alternativa, puoi utilizzare questo dominio e-mail per eseguire l’integrazione con Amazon Connect e iniziare a ricevere e-mail in Amazon Connect. Ad esempio, se disponi di un indirizzo e-mail come *support@example.com*, puoi inoltrare e-mail in Amazon Connect utilizzando *support@example.email.connect.aws*. + **Domini personalizzati**. Puoi specificare fino a 5 domini personalizzati di cui è stato [eseguito l’onboarding in Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc). ## Fase 1: mettere Amazon SES in modalità di produzione Amazon Connect utilizza Amazon SES per l’invio e la ricezione di e-mail. Se hai una nuova istanza Amazon SES, devi prima farla uscire dalla modalità sandbox. Per istruzioni, consulta [Richiedere l’accesso in produzione (uscita dalla sandbox Amazon SES)](https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html) nella *Guida per gli sviluppatori di Amazon SES*. Dopo aver messo Amazon SES in modalità di produzione, se hai già abilitato l’e-mail quando hai creato l’istanza Amazon Connect, passa a questi argomenti: + [(Facoltativo) Fase 3: utilizzare domini e-mail personalizzati](#use-custom-email) + [Passaggio 5: configura una policy CORS sul bucket degli allegati](#config-email-attachments-cors1) ## Fase 2: ottenere un dominio e-mail Amazon Connect predefinito Queste fasi si applicano solo se hai già creato un’istanza Amazon Connect, ma non hai abilitato l’e-mail. Completa la procedura seguente per ottenere un dominio e-mail predefinito da Amazon Connect. 1. Nella console Amazon Connect, nel menu di navigazione a sinistra, scegli **E-mail**, quindi scegli **Crea ruolo di servizio**. Questo ruolo deve essere creato solo una volta per ogni account. Consente ad Amazon SES di instradare le e-mail verso Amazon Connect. 1. Scegli **Aggiungi un dominio**, come mostrato nell’immagine seguente. ![\[Pagina Gestisci e-mail, pulsante Aggiungi un dominio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-aws-console1.png) 1. Nella casella **Aggiungi dominio e-mail**, scegli **Dominio e-mail Amazon Connect**, come mostrato nell’immagine seguente. Quando scegli questa opzione, il nome del dominio viene generato automaticamente: **instance-alias*.email.connect.aws.* Non puoi modificare questo indirizzo e-mail. ![\[Casella Aggiungi dominio e-mail, opzione Dominio e-mail Amazon Connect.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-add-email-domain.png) ## (Facoltativo) Fase 3: utilizzare domini e-mail personalizzati Puoi importare fino a cinque domini personalizzati di cui è stato eseguito l’[onboarding in Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc). 1. Nella console Amazon Connect, nel menu di navigazione a sinistra, scegli **E-mail**, quindi scegli **Aggiungi dominio**, come mostrato nell’immagine seguente. ![\[Canale E-mail nella console di Amazon Connect.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-aws-console.png) 1. Scegli **Usa un dominio e-mail personalizzato**. Utilizza il menu a discesa per scegliere domini personalizzati che sono stati [verificati da Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc). ![\[Opzione Usa un dominio e-mail personalizzato.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-add-custom-domain.png) ## Fase 4: abilitare l’e-mail e creare un bucket Amazon S3 per archiviare messaggi e-mail e allegati Queste fasi si applicano solo se hai già creato un’istanza Amazon Connect, ma non hai abilitato l’e-mail. È necessario aggiornare le impostazioni di **Archiviazione dei dati** per abilitare il canale e-mail e specificare il bucket Amazon S3 in cui archiviare i messaggi e-mail e gli allegati. L’e-mail richiede due puntatori a bucket Amazon S3. Possono puntare allo stesso bucket Amazon S3 o a due bucket diversi. **Importante** Se scegli **Abilita condivisione degli allegati** per la tua istanza, devi creare un bucket Amazon S3 e [configurare una policy CORS nel bucket per allegati](#config-email-attachments-cors1), come descritto in questo argomento. In caso contrario, **il canale e-mail non funziona per la tua istanza**. 1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza. ![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l’alias dell’istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png) 1. Nel menu di navigazione a sinistra, scegli **Archiviazione dei dati**, **Messaggi e-mail**, **Modifica**, **Abilita l’esportazione dei messaggi e-mail su S3**, quindi scegli **Salva**. 1. Completa la pagina **Messaggi e-mail** per creare o selezionare un bucket S3 in cui vengono archiviati i messaggi e-mail. La seguente immagina mostra un esempio di pagina completata. ![\[Opzione del menu Archiviazione dei dati, pagina Messaggi e-mail.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-messages-export-to-s3.png) 1. Se desideri consentire gli allegati e-mail, scegli anche **Allegati**. L’immagine seguente mostra entrambe le opzioni. L’immagine seguente della pagina **Archiviazione dei dati** mostra il bucket Amazon S3 per i messaggi e-mail e gli allegati. ![\[Il bucket Amazon S3 per archiviare messaggi e-mail e allegati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/email-s3-bucket.png) ## Passaggio 5: configura una policy CORS sul bucket degli allegati Per consentire a clienti e agenti di caricare e scaricare file, aggiorna la policy di condivisione di risorse di origine incrociata (CORS) per consentire `PUT` e `GET` richiedere il bucket Amazon S3 che stai utilizzando per gli allegati. Si tratta di una soluzione più sicura rispetto all'attivazione pubblica read/write sul bucket Amazon S3, che non consigliamo. **Per configurare CORS nel bucket degli allegati** 1. Trova il nome del bucket Amazon S3 per la conservazione degli allegati: 1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/). 1. Nella console Amazon Connect, scegli **Archiviazione dei dati** e individua il nome del bucket Amazon S3. 1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 1. Seleziona un bucket Amazon S3 sulla console Amazon S3. 1. Scegli la scheda **Autorizzazioni**, quindi scorri verso il basso fino alla sezione **Condivisione di risorse di origine incrociata (CORS)**. 1. Aggiungi una policy CORS che abbia una delle seguenti regole per il bucket degli allegati. Ad esempio, policy CORS, consulta [Condivisione di risorse di origine incrociata: scenari di casi d'uso](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html#example-scenarios-cors) nella *Guida per gli sviluppatori di Amazon S3*. + Opzione 1: elencare gli endpoint da cui verranno inviati e ricevuti gli allegati, ad esempio il nome del sito web aziendale. Questa regola consente richieste PUT e GET provenienti da più origini dal sito web (ad esempio, http://www.example1.com). La policy CORS potrebbe essere simile all'esempio seguente: ``` [ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "PUT", "GET" ], "AllowedOrigins": [ "*.my.connect.aws", "*.awsapps.com" ], "ExposeHeaders": [] } ] ``` + Opzione 2: aggiungere il carattere jolly `*` a `AllowedOrigin`. Questa regola consente richieste PUT e GET di origine incrociata da tutte le origini, quindi non è necessario elencare gli endpoint. La policy CORS potrebbe essere simile all'esempio seguente: ``` [ { "AllowedMethods": [ "PUT", "GET" ], "AllowedOrigins": [ "*" ], "AllowedHeaders": [ "*" ] } ] ``` ## Fasi successive + [Impostare la scansione degli allegati in Amazon Connect](setup-attachment-scanning.md): questo argomento è rivolto agli sviluppatori che hanno familiarità con Lambda. Puoi configurare Amazon Connect per scansionare gli allegati delle e-mail utilizzando la tua applicazione di scansione preferita. ## APIs per abilitare la posta elettronica Usa quanto segue APIs per abilitare la posta elettronica a livello di codice: + [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html) + [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html) + [DescribeInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeInstanceStorageConfig.html) # Creazione di indirizzi e-mail Questo argomento spiega come creare indirizzi e-mail utilizzando il sito Web di Amazon Connect amministrazione. Puoi creare indirizzi e-mail a cui i clienti possono rispondere, ma anche indirizzi e-mail solo in uscita (senza risposta). Per un elenco degli indirizzi e-mail APIs utilizzati per creare e gestire indirizzi e-mail a livello di codice, vedere. [APIs per creare e gestire indirizzi e-mail](#apis-manage-email-addresses1) Puoi specificare fino a 100 indirizzi e-mail. **Come creare gli indirizzi e-mail** 1. Accedi al sito web di Amazon Connect amministrazione all'indirizzo https://*instance name*.my.connect.aws/. Utilizza un account amministratore o un account con l’autorizzazione **Canali e flussi** - **Indirizzi e-mail** - **Crea** nel profilo di sicurezza. 1. Nel menu di navigazione, scegli **Canali**, **Indirizzi e-mail**. 1. Scegli un dominio nell’elenco a discesa. L’elenco contiene il dominio generato automaticamente che è stato creato quando hai abilitato il canale e-mail per l’istanza. Può anche visualizzare fino a cinque domini personalizzati se li hai aggiunti. 1. In **Informazioni aggiuntive**, puoi facoltativamente aggiungere quanto segue: + **Nome del mittente descrittivo** + **Descrizione**: è destinato all’utilizzo personale, non è un campo rivolto ai clienti. + **Flusso**: scegli un flusso pubblicato per l’invio di e-mail. Lascia vuoto questo campo per l’indirizzo e-mail da utilizzare solo per le comunicazioni in uscita. I clienti non saranno in grado di rispondere. **Suggerimento** Per creare indirizzi e-mail **senza risposta**, ovvero indirizzi utilizzati solo per la posta in uscita e che non possono accettare una risposta, non selezionare un flusso da utilizzare per l’indirizzo e-mail. 1. In **Tag**, aggiungi facoltativamente [tag](tagging.md) per gestire chi può visualizzare e accedere agli indirizzi e-mail in Amazon Connect e nello spazio di lavoro degli agenti. 1. Scegli **Create** (Crea). ## APIs per creare e gestire indirizzi e-mail Per un elenco di tutti gli indirizzi e-mail APIs, consulta [Email actions](https://docs.aws.amazon.com/connect/latest/APIReference/email-api.html) nella *Amazon Connect API Reference Guide*. Utilizza quanto segue APIs per creare indirizzi a livello di codice: + [CreateEmailAddress](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateEmailAddress.html) + [DescribeEmailAddress](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeEmailAddress.html) + [UpdateEmailAddressMetadata](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateEmailAddressMetadata.html) # Creare modelli di messaggio Se crei e invii frequentemente un certo tipo di messaggio, ad esempio un’e-mail settimanale o un promemoria di un appuntamento, puoi crearlo e salvarlo come modello di messaggio. Puoi quindi utilizzare il modello come punto di partenza ogni volta che è necessario inviare quel tipo di messaggio, invece di creare e scrivere nuovamente il messaggio. Questo argomento è destinato agli amministratori e ai responsabili dei contact center che desiderano creare modelli di messaggi utilizzando il sito Web di Amazon Connect amministrazione. **Suggerimento** Anche se i modelli di messaggio utilizzano gli agenti Connect AI APIs, i modelli di messaggio non comportano una fatturazione aggiuntiva. Paghi solo il prezzo del messaggio di chat o dell’e-mail. Per ulteriori informazioni, consulta [Prezzi di Amazon Connect](https://aws.amazon.com/connect/pricing/). ## Cosa sono i modelli di messaggio? Un *modello di messaggio* è un insieme di contenuti e impostazioni che è possibile creare, salvare e quindi riutilizzare nei messaggi. In alcune aziende vengono denominati *modelli di e-mail* e *modelli di SMS*. Quando crei un modello di messaggio, specifichi il contenuto che desideri riutilizzare nei vari componenti dei messaggi basati sul modello. Quando si crea un messaggio, è possibile scegliere un modello da utilizzare per il messaggio. in questo caso, Amazon Connect popola il messaggio con il contenuto e le impostazioni definite nel modello. Puoi progettare i seguenti tipi di modelli di messaggio in Amazon Connect: + **Modelli di e-mail** per i messaggi e-mail che invii in risposta alle e-mail dei clienti spedite al tuo contatto o che gli agenti possono utilizzare per le domande frequenti. I modelli di e-mail possono definire la struttura dell’e-mail per l’agente, ad esempio per una firma, oppure possono essere una risposta completa. + **Modelli SMS** per gli SMS inviati dalle campagne o a un pubblico ristretto come messaggi diretti o di prova. + **WhatsApp modelli** per WhatsApp i messaggi che invii dalle campagne o a un pubblico limitato come messaggi diretti o di prova. Puoi creare modelli con le seguenti caratteristiche: + Formattazione RTF (grassetto, corsivo, sottolineato, barrato, apice, pedice), stile del carattere RTF (colore, evidenziazione, dimensione, titolo, famiglia, citazione in blocco, blocco di codice), caratteri speciali, emoji, elenchi (puntati, numerati), allineamento e rientri, tabelle, collegamenti ipertestuali e immagini incorporate. + Attributi all’interno del modello di e-mail per definire dettagli personalizzati come il nome del cliente, l’e-mail del cliente, il numero di account del cliente, il numero di telefono del cliente, l’indirizzo del cliente e il nome dell’agente. + Allegati fino a 1 MB. Per un elenco di tipi di allegato supportati, consulta [Amazon Connect specifiche delle funzionalità](feature-limits.md). Quando crei un messaggio e-mail basato sul modello, Amazon Connect compila il messaggio con i contenuti e le impostazioni che hai definito nel modello. ## Come creare modelli di messaggio 1. Accedi al sito web di Amazon Connect amministrazione con un account amministratore o un account utente con **Gestione dei contenuti** - **Modelli di messaggi** - **Crea** nel suo profilo di sicurezza. 1. Nel riquadro di navigazione scegliere **Message templates (Modelli di messaggio)**. 1. Se è la prima volta che crei dei modelli, ti viene richiesto di creare una knowledge base, in cui sono archiviati i modelli. La tua azienda può avere diverse knowledge base, ma solo una di esse può essere associata ai modelli. 1. Scegli **Crea modello**. 1. In **Canale**, scegli un canale. 1. Immetti un nome per il modello in **Nome**. Il nome deve iniziare con una lettera o un numero. Può contenere fino a 128 caratteri. 1. Per **Descrizione - *facoltativo***, immetti una breve descrizione del modello. La descrizione può contenere fino a 255 caratteri. 1. Per **Profili di routing - *facoltativo***, immetti i profili di routing affinché gli agenti possano utilizzare questo modello da Agent Workspace. 1. A seconda che stiate creando un'**e-mail**, un **SMS** o un **WhatsApp**modello, effettuate una delle seguenti operazioni: Per i modelli di e-mail: 1. In **Email details (Dettagli e-mail)**, utilizzare le seguenti opzioni per specificare il contenuto dei messaggi che utilizzano il modello: + Per **Subject (Oggetto)**, immettere il testo che si desidera visualizzare nella riga dell'oggetto del messaggio. + Per **Corpo**, immetti il contenuto che desideri visualizzare nel corpo del messaggio. + **Editor**: utilizza l’editor RTF per immettere il contenuto. Utilizza la barra degli strumenti di formattazione per applicare elementi di formattazione, aggiungere link e altri contenuti al messaggio. Per aggiungere allegati, l’amministratore IT deve abilitare l’apposita funzionalità per questa opzione. + **Codice**: inserisci manualmente contenuti HTML, tra cui la formattazione, i link e altre caratteristiche che desideri includere nel messaggio. Puoi anche includere contenuti personalizzati nell’oggetto e nel corpo del modello utilizzando alcuni attributi. Per fare questo, aggiungi variabili di messaggio che fanno riferimento ad attributi specifici creati da te o da Amazon Connect, ad esempio un attributo che archivia il nome dell’utente. Con le variabili di messaggio, puoi visualizzare contenuti diversi per ciascun destinatario di un messaggio che utilizza il modello. Per utilizzare una variabile di messaggio, scegli il nome di un attributo esistente in **Localizzatore di attributi**. Amazon Connect lo inserisce nel messaggio. Puoi copiarlo e incollarlo nella posizione desiderata. Per ulteriori informazioni, consulta [Aggiungere contenuti personalizzati ai modelli di messaggio](personalize-templates.md). ![\[Strumento di ricerca degli attributi nella pagina dei modelli di messaggio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/message-template-attribute-finder.png) 1. In **Intestazioni - *facoltativo***, puoi aggiungere due intestazioni statiche al messaggio e-mail. Ad esempio, per aggiungere un link per l’annullamento dell’iscrizione con un clic a un’e-mail promozionale, aggiungi le due intestazioni seguenti: + **List-Unsubscribe**: imposta il link per l’annullamento dell’iscrizione della tua organizzazione. Il link deve supportare le richieste HTTP POST per elaborare la richiesta di annullamento dell’iscrizione del destinatario. + **List-Unsubscribe-Post**: imposta questo valore su `List-Unsubscribe=One-Click`. L'inclusione di un link di annullamento dell'iscrizione nell'e-mail rappresenta una best practice e in alcuni paesi è un requisito legale. Se il modello include un link con questo attributo, devi aver attuato un sistema per la gestione delle richieste di annullamento dell’adesione. 1. Al termine dell’immissione del contenuto e delle impostazioni per il modello, scegli **Salva**. 1. Prima di rendere disponibile il modello agli utenti, ti consigliamo di inviare un messaggio e-mail di prova per assicurarti che il modello funzioni come previsto. 1. Quando è tutto pronto per rendere disponibile il modello nei flussi, nelle campagne e per gli agenti che utilizzano Agent Workspace, completa i passaggi per [attivare il modello](#create-message-templates1). **Per i modelli SMS:** 1. Nella sezione **Dettagli SMS** nel **Corpo**, scrivi il messaggio. Utilizza le istruzioni riportate sopra per personalizzare il messaggio aggiungendo gli attributi necessari. 1. Al termine dell'immissione del contenuto e delle impostazioni per il modello, scegliere **Create (Crea)**. 1. Prima di rendere disponibile il modello agli utenti, ti consigliamo di inviare un messaggio di prova per assicurarti che il modello funzioni come previsto. 1. Quando è tutto pronto per rendere disponibile il modello di SMS nel blocco **Invia messaggio** oppure per rendere disponibile il modello di e-mail per le campagne e-mail, completa i passaggi per [attivare il modello](#create-message-templates1). **Per i WhatsApp modelli:** 1. In **WhatsApp dettagli**, seleziona il modello dal menu a discesa. Tieni presente che solo i modelli approvati da Meta possono essere utilizzati per creare modelli di messaggi. Assicurati che i modelli importati siano approvati in Meta Business WhatsApp Manager prima di procedere. 1. Definite un nome per il modello e aggiungete le descrizioni se necessario. 1. Dopo aver selezionato il modello approvato da Meta, vedrai i dettagli visualizzati in formato **Body** and **Template Metadata (JSON)**. 1. **Mappatura degli attributi:** per abilitare la consegna personalizzata dei messaggi in Amazon Connect, dovrai mappare i meta attributi importati su testo personalizzato. Combinando gli attributi Connect esistenti con testo semplice, puoi creare messaggi personalizzati per i tuoi clienti. Ad esempio, potresti vedere Hello \$1\$11\$1\$1 nel **corpo** e puoi scegliere di abbinarlo `Attributes.Customer.FirstName` dall'elenco degli attributi Connect. 1. Esistono diversi tipi di pulsanti che possono essere aggiunti a un modello di contenuto. Se il modello selezionato include pulsanti, come l'URL di un sito Web che include attributi, puoi selezionare Connetti gli attributi alla mappa o digitare testo statico. 1. Una volta completata la mappatura degli attributi, scegli **Salva**. 1. Prima di rendere disponibile il modello agli utenti, ti consigliamo di inviare un messaggio di prova per assicurarti che il modello funzioni come previsto. # Attivare un modello di messaggio Per facilitare la gestione dello sviluppo e dell’utilizzo di singoli modelli di messaggio, Amazon Connect supporta il controllo delle versioni per tutti i tipi di modello di messaggio. Il controllo delle versioni consente di creare una cronologia delle modifiche a un modello: ogni versione è uno snapshot a di un modello in un determinato momento. Consente inoltre di controllare i contenuti e le impostazioni dei messaggi che utilizzano un modello. Puoi attivare solo i modelli di messaggio che sono stati **salvati come nuova versione**. Questo serve per evitare l’attivazione accidentale di modelli che sono bozze. Quando una versione del modello è **attivata**, è disponibile per essere aggiunta a [Blocco di flusso in Amazon Connect: Invia messaggio](send-message.md) e può essere disponibile per gli agenti tramite Agent Workspace. **Come attivare un modello di messaggio** Accedi al sito web di Amazon Connect amministrazione con un account amministratore o un account utente con **Gestione dei contenuti** - **Modelli di messaggi** - **Crea** nel suo profilo di sicurezza. 1. Dal menu di navigazione a sinistra scegli **Modelli di messaggio**. 1. Nella pagina **Modelli di messaggio**, salva il modello utilizzando l’opzione **Salva come nuova versione**. 1. Nella pagina **Modelli di messaggio**, riapri il modello che hai appena salvato. 1. Utilizza il menu a discesa per scegliere la versione del modello da attivare. ![\[Numero di versione di un modello.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/message-template-version.png) 1. Selezionare **Attiva**. ![\[Pulsante Attiva nella pagina del modello di messaggio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/message-template-version-activate.png) # Informazioni sui modelli di messaggio con controllo delle versioni Ogni volta che modifichi un modello, puoi specificare se salvare le modifiche come nuova bozza del modello o come aggiornamento della bozza esistente più recente del modello. Durante la progettazione, lo sviluppo e il perfezionamento di un modello, ciascuna di queste versioni funge da snapshot che consente di tenere traccia dell'avanzamento e dello stato del modello. In altri termini, puoi utilizzare questa funzione per archiviare, tenere traccia e gestire un modello man mano che cambia nel tempo. Puoi: + Tenere traccia della cronologia di un modello: per ogni modello, Amazon Connect fornisce l’elenco delle relative versioni. Tale elenco mostra il nome di ogni versione. L'elenco è disposto in ordine cronologico decrescente con la versione più recente elencata per prima. + Visualizzare e confrontare le versioni di un modello: con l'elenco delle versioni, è possibile esaminare le versioni precedenti di un modello. Se scegli una versione nell’elenco, Amazon Connect visualizza i contenuti e le impostazioni archiviati in tale versione. + Ripristinare una versione precedente di un modello: in caso di problemi con la versione più recente di un modello, puoi ripristinare una versione precedente in cui tali problemi non sono presenti. La versione precedente può quindi essere salvata come nuova versione del modello. La nuova versione diventerà la versione più recente del modello. Con la funzione Versioni multiple è anche possibile stabilire quale versione di un modello può essere utilizzata nei messaggi. A questo scopo, occorre designare una versione specifica come versione attiva di un modello. La versione attiva è in genere quella che è stata esaminata e approvata più di recente per l'utilizzo nei messaggi, a seconda del flusso di lavoro dell'organizzazione per lo sviluppo e la gestione dei modelli. Quando si designa una versione come versione attiva, se ne abilita l'utilizzo nei messaggi. Man mano che un modello cambia nel tempo, è possibile designare una versione diversa come versione attiva e modificare più volte tale designazione. # Aggiungere contenuti personalizzati ai modelli di messaggio Per offrire contenuti dinamici e personalizzati nei messaggi che utilizzano un modello, aggiungi *variabili di messaggio* al modello di messaggio. Una *variabile di messaggio* è un segnaposto che fa riferimento a un attributo specifico creato da te o da Amazon Connect per archiviare le informazioni sugli utenti. Ogni attributo corrisponde in genere a una caratteristica di un utente, ad esempio il nome o la città in cui vive. Aggiungendo variabili di messaggio ai modelli, è possibile utilizzare questi attributi per offrire contenuti personalizzati a ciascun destinatario di un messaggio che usa un modello. Se un modello contiene variabili di messaggio, Amazon Connect sostituisce ogni variabile con il valore corrente corrispondente dell’attributo per ciascun destinatario. Esegue questa operazione ogni volta che invia un messaggio che utilizza il modello. Ciò significa che puoi inviare contenuti personalizzati a ciascun destinatario senza creare più versioni personalizzate di un messaggio o di un modello di messaggio. Puoi anche avere la certezza che il messaggio contiene le informazioni più recenti disponibili su un destinatario. Ad esempio, se il progetto è un'applicazione di fitness per chi corre e include attributi su nome, attività preferita e record personale di ciascun utente, potresti utilizzare le seguenti variabili di testo e messaggio in un modello: `Hi {{Attributes.Customer.FirstName}}, attached is information about the insurance plans we discussed.` Quando invii un messaggio che utilizza il modello, Amazon Connect sostituisce le variabili con il valore corrente di ciascun attributo per ogni destinatario, come mostrato negli esempi seguenti. **Esempio 1** `Hi Sofia, attached is information about the insurance plans we discussed.` **Esempio 2** `Hi Alejandro, attached is information about the insurance plans we discussed.` ## Aggiungere variabili di messaggio Puoi aggiungere attributi di messaggio a un nuovo modello o a un modello esistente. Se aggiungi variabili a un modello esistente, Amazon Connect non applica necessariamente le modifiche ai messaggi che utilizzano il modello e che non sono ancora stati inviati. Questo dipende dalla versione del modello a cui aggiungi le variabili e dal modo in cui sono stati configurati i messaggi che utilizzano il modello. **Per aggiungere una variabile di messaggio a un modello di messaggio** 1. Nel riquadro di navigazione scegliere **Message templates (Modelli di messaggio)**. 1. Nella pagina **Message templates (Modelli di messaggio)**, eseguire una delle seguenti operazioni: + Per creare un nuovo modello e aggiungervi una variabile di messaggio, scegliere **Create template (Crea modello)**. Quindi, nella pagina del modello, immettere un nome per il modello e, facoltativamente, una descrizione del modello. + Per aggiungere una variabile di messaggio a un modello esistente, selezionare il modello a cui si desidera aggiungere una variabile. Quindi, nella pagina del modello, selezionare **Edit (Modifica)**. In **Template details (Dettagli modello)** utilizzare il selettore di versione per scegliere la versione da utilizzare come punto di partenza. Se si sceglie la versione più recente, è possibile salvare le modifiche direttamente in quella versione del modello. In caso contrario, è possibile salvare le modifiche come nuova versione del modello. 1. Nella sezione dei dettagli del messaggio, determinare la posizione dove si desidera aggiungere una variabile di messaggio. Per i modelli di e-mail, puoi aggiungere variabili all’oggetto o al corpo del messaggio. Per i modelli di SMS, puoi aggiungere variabili al corpo. 1. Posiziona il cursore nel punto in cui desideri inserire l’attributo nel messaggio. Tocca o fai clic su **Cercatore di attributi**, quindi scorri fino al tipo di attributo per cui desideri aggiungere una variabile di messaggio. ![\[Strumento di ricerca degli attributi nella pagina dei modelli di messaggio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/message-template-attribute-finder.png) È possibile scegliere tra i seguenti tipi di attributi: + **Attributi di sistema**: + **CustomerEndpointAddress**: l'indirizzo email del cliente che ha avviato il contatto. + **SystemEmailAddress**: L'indirizzo e-mail a cui il cliente ha inviato l'e-mail. + **Name**: il nome visualizzato nell’e-mail inviata dal cliente al contact center. + **Attributi dell’agente**: + **FirstName** + **LastName** + **Attributi del profilo utente**. Per un elenco completo e per le descrizioni, consulta [Attributi Customer Profiles](connect-attrib-list.md#customer-profiles-attributes). + **Attributi dei consigli**: quando utilizzi Predictive Insights con campagne in uscita, puoi includere consigli personalizzati sui prodotti nei tuoi modelli di messaggio. Questi attributi sono disponibili quando configuri i consigli in una campagna attivata da eventi. Si accede a ogni consiglio utilizzando un indice, ad esempio `{{Attributes.Customer.Recommendations.[0].CatalogItem.Name}}` per il primo consiglio, `{{Attributes.Customer.Recommendations.[1].CatalogItem.Name}}` per il secondo e così via. ![\[Editor di modelli di e-mail che mostra gli attributi dei consigli nel Finder degli attributi e i consigli personalizzati sui prodotti nel corpo del messaggio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/RecommendationAttributesInTemplate.png) Per ulteriori informazioni sulla configurazione dei consigli nelle campagne, consulta. [Creare una campagna in uscita utilizzando i trigger di eventi](how-to-create-campaigns-using-event-triggers.md) 1. Quando fai clic su un attributo nello strumento di ricerca degli attributi, questo viene automaticamente inserito nel messaggio. Puoi copiare e incollare l’attributo in un’altra posizione. Dopo aver incollato un attributo, Amazon Connect lo visualizza racchiuso tra due serie di parentesi graffe, ad esempio `{{Attributes.Agent.FirstName}}`. L’immagine seguente mostra un messaggio e-mail con tre attributi: nome e cognome del cliente e nome dell’agente. ![\[Un messaggio e-mail con gli attributi del messaggio.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/message-template-email-attributes.png) 1. Al termine, effettuare una delle seguenti operazioni: + Se hai aggiunto variabili di messaggio a un nuovo modello, scegli **Salva**. + Se sono state aggiunte variabili di messaggio a un modello esistente e si vuole salvare le modifiche come nuova versione del modello, scegliere **Save as new version (Salva come nuova versione)**. + Se hai aggiunto variabili di messaggio a un modello esistente e desideri salvare le modifiche come aggiornamento della bozza più recente del modello, scegli **Salva**. Se desideri aggiornare la bozza e creare una nuova versione a partire dalla bozza, scegli **Salva come nuova versione**. # Utilizzare gli helper modello di messaggio Con i modelli di messaggio di Amazon Connect, i clienti possono creare modelli di messaggio riutilizzabili basati sul linguaggio Handlebars.js. Gli helper offrono una varietà di funzionalità come la formattazione di un prezzo nella valuta di una regione specifica o l'aggiunta di una località in base al fuso orario. Un helper può utilizzare una stringa o un numero intero specifico per il valore o una variabile di messaggio Amazon Connect specifica. Di seguito sono elencate le categorie di helper, descritte nelle sezioni seguenti. ## Helper predefiniti Questa sezione descrive gli helper **integrati** forniti da Handlebars. **Importante** L’helper `with` integrato fornito da Handlebars non è supportato. Tuttavia, tutti gli altri helper di Handlebars sono completamente supportati. Per un elenco completo, consulta la sezione relativa agli [helper integrati](https://handlebarsjs.com/guide/builtin-helpers.html) nel sito [handlebarsjs.com](https://handlebarsjs.com). Di seguito sono descritti gli helper integrati: + `each`: itera un elenco. **Nota** La dimensione massima dell'elenco è di 15 elementi. + `if`: valuta un'istruzione. *each* Itera un elenco. Questo helper utilizza solo un blocco di istruzioni. Facoltativamente puoi: + Passare `@index` nella richiesta per fare riferimento all'indice del loop corrente. + Usare l'helper `this` per fare riferimento all'elemento iterato corrente. + Restituire la risposta dell'helper in un elenco mediante il tag `
  • `. **Utilizzo** `{{#each value}}` Il valore alla posizione `{{@index}}` è `{{this}}`. `{{else}}` La condizione è false. `{{/each}}` `each` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/each}}` nel blocco di istruzioni. **Esempio** In questo esempio, `each` viene utilizzato per restituire l'elenco dei colori preferiti di un utente. Per `false`, viene restituita un'istruzione `else`. Se la richiesta è simile alla seguente: `{{#each User.UserAttributes.FavoriteColors}}` `
  • {{this}}
    • ` `{{else}}` *You have no favorite colors.* `{{/each}}` restituisce + *red* + *blue* + *yellow* per un'istruzione true. *if* Valuta se un'istruzione è vera (true) e restituisce una risposta basata sulla valutazione. **Utilizzo** `{{#if value}}` Il valore non è indefinito `{{else}}` Il valore è indefinito `{{/if}}` `if` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/if}}` nel blocco di istruzioni. **Esempio** In questo esempio, l'helper `if` viene utilizzato per valutare se si tratta del nome di un utente. Se viene trovato il nome, viene restituito un messaggio di saluto che riporta il nome dell'utente nella risposta. In caso contrario, l'istruzione `else` restituisce un saluto alternativo. `{{#if User.UserAttributes.FirstName.[0]}}` `Hello {{User.UserAttributes.FirstName.[0]}},` `{{else}}` *Hello,* `{{/if}}` restituisce *Hello, Jane* se l'`if`helper è vero. ## Helper condizionali Questa sezione descrive gli helper **condizionali**. Gli helper condizionali possono essere usati su un'unica riga o in un blocco di istruzioni. È possibile personalizzare la risposta indipendentemente dal metodo helper utilizzato. È possibile passare helper condizionali aggiuntivi sia all'interno di istruzioni a riga singola che a blocchi di istruzioni. I seguenti helper condizionali mostrano l'utilizzo prima per una singola riga e poi per un blocco di istruzioni utilizzando una clausola `else` facoltativa. Di seguito sono descritti gli helper condizionali: + `and`: confronta tutti gli elementi passati per verificare se sono uguali. + `eq`: verifica se due elementi sono uguali. + `gt`: verifica se un elemento è maggiore di un altro. + `gte`: verifica se un elemento è maggiore o uguale a un altro. + `if`: valuta se un elemento è vero. + `lt`: verifica se un elemento è inferiore a un altro. + `lte`: verifica se un elemento è minore o uguale a un altro. + `neq`: valuta se due elementi non sono uguali. + `not`: inverte la risposta di un’operazione booleana. + `or`: confronta se alcuni degli elementi dell'argomento sono uguali. *and* Confronta se *tutti* gli elementi passati in un argomento sono uguali e quindi restituisce la risposta in base al risultato. Questo helper può essere utilizzato per valori non booleani. È necessario passare almeno due elementi per la condizione. **Utilizzo** + `{{and valuea valueb valuec valued yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#and valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/and}}` `and` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/and}}` nel blocco di istruzioni. **Esempio** In questo esempio, `eq` viene utilizzato all'interno del blocco di istruzioni `and` per determinare se entrambe le stringhe passate per gli attributi `Location.City ` e `Location.Country` sono true. Se entrambe le condizioni sono uguali, viene restituita un'istruzione true. Se uno di questi attributi è false, viene restituita un'istruzione `else`. `{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}` *You live in Los Angeles and the US.* `{{else}}` *You don’t live in Los Angeles and the US.* `{{/and}}` *eq* Verifica se due elementi sono uguali o se il valore di un elemento è uguale a una stringa passata. **Utilizzo** + `{{eq valuea valueb yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#eq valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/eq}}` `eq` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/eq}}` nel blocco di istruzioni. **Esempio** In questo esempio, `eq` viene utilizzato per valutare se il valore di `User.UserAttributes.FavoriteColors.[0]` è*Red*. Se la risposta è `true`, viene restituita un'istruzione true. Se la risposta è `false`, viene restituita un'istruzione `else`. `{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}` *Your favorite color is red.* `{{else}}` *You don't like red.* `{{/eq}}` *gt* Verifica se il valore di un elemento è maggiore di un altro. **Utilizzo** + `{{gt valuea valueb yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, come *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#gt valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/gt}}` `gt` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/gt}}` nel blocco di istruzioni. **Esempio** In questo esempio, l'helper confronta il valore dell'`User.UserAttributes.UserAge.[0]`attributo con una stringa*17*, per verificare se l'età dell'utente è maggiore di 17 anni. Se la risposta è `true`, viene restituita un'istruzione true. Se la risposta è `false`, viene restituita un'istruzione `else`. `{{#gt User.UserAttributes.UserAge.[0] "17"}}` *You are old enough to rent a car.* `{{else}}` *You are not old enough to rent a car.* `{{/gt}}` *gte* Verifica se il valore di un elemento è maggiore o uguale a un altro. `Usage` + `{{gte valuea valueb yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#gte valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/gte}}` `get` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/gte}}` nel blocco di istruzioni. **Esempio** In questo esempio, l'helper confronta l'`User.UserAttributes.UserAge.[0]`attributo con una stringa*18*, per verificare se l'età dell'utente è maggiore o uguale a 18 anni. Se la risposta è `true`, viene restituita un'istruzione true. Se la risposta è `false`, viene restituita un'istruzione `else`. `{{#gte User.UserAttributes.UserAge.[0] "18"}}` *You are old enough to rent a car.* `{{else}}` *You are not old enough to rent a car.* `{{/gte}}` *if* Valuta se un'istruzione è vera (true) e restituisce una risposta basata sulla valutazione. **Utilizzo** + `{{#if value}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#if value}}` La condizione è true. `{{else}}` La condizione è false. `{{/if}}` `if` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/if}}` nel blocco di istruzioni. **Esempio** In questo esempio, l'helper viene utilizzato per valutare se si tratta del nome di un utente. Se viene trovato il nome, viene restituito un messaggio di saluto che riporta il nome dell'utente nella risposta. In caso contrario, l'istruzione else restituisce un saluto alternativo. `{{#if User.UserAttributes.FirstName.[0]}}` *Hello* `{{User.UserAttributes.FirstName.[0]}}`*,* `{{else}}` *Hello,* `{{/if}}` restituisce *Hello Jane,* se l'helper è vero. *lt* Verifica se il valore di un elemento è minore del valore di un altro. **Utilizzo** + `{{lt valuea valueb yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#lt valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/lt}}` `lt` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/lt}}` nel blocco di istruzioni. **Esempio** In questo esempio, l'helper confronta l'`User.UserAttributes.UserAge.[0]`attributo con una stringa*18*, per verificare se l'età dell'utente è inferiore a 18 anni. Se la risposta è `true`, viene restituita un'istruzione true. Se la risposta è `false`, viene restituita un'istruzione `else`. `{{#lt User.UserAttributes.UserAge.[0] "18"}}` *You are not old enough to rent a car.* `{{else}}` *You are old enough to rent a car.* `{{/lt}}` *lte* Verifica se il valore di un elemento è minore o uguale a un altro. **Utilizzo** + `{{lte valuea valueb yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#lte valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/lte}}` `lte` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/lte}}` nel blocco di istruzioni. **Esempio** In questa istruzione di blocco, l'helper confronta l'`User.UserAttributes.UserAge.[0]`attributo con una stringa*17*, per verificare se l'età dell'utente è pari o inferiore a 17 anni. Se la risposta è `true`, viene restituita un'istruzione true. Se la risposta è `false`, viene restituita un'istruzione `else`. `{{#lte User.UserAttributes.Age.[0] "17"}}` *You are not old enough to rent a car.* `{{else}}` *You are old enough to rent a car.* `{{/lte}}` *neq* Verifica se due elementi *non* sono uguali. **Utilizzo** + `{{neq valuea valueb yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#neq valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/neq}}` `neq` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/neq}}` nel blocco di istruzioni. **Esempio** In questo blocco di istruzioni, l’attributo `User.UserAttributes.FavoriteColors.[0]` viene confrontato con una stringa (`Red`). Se la risposta è `true`, viene restituita un'istruzione true. Se la risposta è `false`, viene restituita un'istruzione `else`. `{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}` *You do not like red.* `{{else}}` *You like red.* `{{/neq}}` *not* Inverte la risposta di un'operazione booleana, in modo che se `not` è un confronto positivo, viene restituita un'istruzione `true`. Se la risposta è false, viene restituita un'istruzione else. **Utilizzo** + `{{not value yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. + `{{#not value}}` La condizione è true. `{{else}}` La condizione è false. `{{/not}}` `not` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/not}}` nel blocco di istruzioni. **Esempio** In questa istruzione di blocco, l'`User.UerAttributes.FavoriteColors.[0]`attributo viene confrontato con una stringa *red* utilizzando l'`eq`helper. L'helper `not` restituisce quindi l'opposto dell'helper `eq`. Se la risposta restituisce un colore diverso da quello*red*, viene restituita `true` un'istruzione. Se la risposta viene restituita*red*, viene restituita un'`else`istruzione che indica una dichiarazione falsa. `{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}` *You do not like red.* `{{else}}` *You like red.* `{{/not}}` **Esempio** In questo esempio: `{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}` restituisce falso se lo `User.UserAttributes.FavoriteColors.[0]` è*red*. *or* Confronta se *uno qualsiasi* degli elementi dell'argomento è uguale e quindi restituisce una risposta in base al risultato. Questo helper può essere utilizzato per valori non booleani. **Utilizzo** + `{{or valuea valueb valuec valued yes='y' no='n'}}` È possibile sostituire *y* e *n* con altri valori, ad esempio *yes* and*no*, o qualsiasi altra stringa che si desidera restituire, a seconda della condizione. È necessario passare almeno due elementi per la condizione. + `{{#or valuea valueb}}` La condizione è true. `{{else}}` La condizione è false. `{{/or}}` `or` deve essere preceduto dal simbolo di sterlina (`#`) e seguito dal simbolo di chiusura `{{/or}}` nel blocco di istruzioni. **Esempio** In questo blocco di istruzioni `or`, vengono confrontate due stringhe per l'attributo `Location.City` utilizzando l'helper `eq`. Se uno degli attributi è `true`, viene restituita un'istruzione true. Se una o più risposte sono `false`, viene restituita un'istruzione `else`. `{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}` *You live on the West Coast of the United States.* `{{else}}` *You do not live on the West Coast of the United States.* `{{/or}}` ## Helper stringa Questa sezione descrive i seguenti helper **stringa**: + `abbreviate`: tronca un valore. + `capitalize`: converte in maiuscolo ogni parola tra spazi. + `capitalizeFirst`: converte in maiuscolo il primo carattere di un valore. + `center`: centra un valore. + `cut`: taglia un valore. + `dateFormat`: imposta lo stile della data. + `inflect`: restituisce una stringa singolare o plurale in base al conteggio. + `join`: unisce un array, un iteratore o un oggetto iterabile. + `ljust`: giustifica un valore al margine sinistro. + `lower`: converte un valore in lettere minuscole. + `now`: stampa la data corrente. + `ordinalize`: ordina un valore numerico. + `replace`: sostituisce una stringa con un'altra. + `rjust`: giustifica un valore al margine destro. + `slugify`: converte un valore in minuscolo e rimuove i caratteri non verbali, converte gli spazi in trattini e rimuove gli spazi finali. + `stripTags`: elimina i tag [X]HTML da un valore. + `substring`: restituisce una nuova stringa come sottostringa di un valore passato. + `upper`: converte il valore passato in lettere maiuscole. + `yesno`: sostituisce true, false e no con Yes, No e Maybe. *abbreviate* Tronca un valore se supera il numero specificato. Gli spazi sono inclusi nel conteggio della lunghezza. Nella risposta vengono visualizzati i puntini di sospensione per indicare un valore troncato. I puntini di sospensione contano ai fini del valore troncato nella risposta. Questo tipo di helper è utile in presenza di una tabella di grandi dimensioni, ma di uno spazio minimo. Il troncamento dei valori in una cella fa sì che la tabella abbia un aspetto più uniforme. **Utilizzo** `{{abbreviate value X}}`, sostituendo *X* con un valore numerico che indica il numero di caratteri da conservare. I numeri negativi non sono supportati. **Esempio** In questo esempio, `abbreviate` viene utilizzato per troncare `User.UserAttributes.LastName.[0]` a sei (6) caratteri. La risposta include i puntini di sospensione, che vengono considerati ai fini del conteggio del totale di sei caratteri. `{{abbreviate User.UserAttributes.LastName.[0] 6}}` restituisce *Ale...*if *Alejandro* è il valore di. `[0]` *capitalize* Converte in maiuscolo ogni parola tra spazi. **Utilizzo** `{{capitalize value}}` **Esempio** In questo esempio, a ogni parola dell'istruzione `Attributes.description.[0]` viene applicata la maiuscola iniziale. `{{capitalize Attributes.description.[0]}}` Se `Attributes.description.[0]` restituisce *My First Post*, se il valore di `Attributes.description.[0]` è*my first post*. *capitalizeFirst* Converte in maiuscolo il primo carattere di un valore. **Utilizzo** `{{capitalizeFirst value}}` **Esempio** In questo esempio, la maiuscola viene applicata al primo carattere della prima parola dell'istruzione `Attributes.description.[0]`. `{{capitalizeFirst Attributes.description.[0]}}` restituisce *My first post*, se il valore di `Attributes.description.[0]` è*my first post*. **Esempio** *center* Centra il valore in un campo di una data larghezza per il numero specificato. Facoltativamente, puoi passare un carattere da visualizzare come carattere di riempimento o lasciare vuoto il campo. Se non viene passato alcun carattere, viene utilizzato uno spazio. **Utilizzo** `{{center value size=X [pad=" "}}`, sostituendo *X* con un valore numerico. Se `pad` viene lasciato vuoto, nella risposta viene utilizzato uno spazio come carattere di riempimento. Se passi un carattere, il carattere specificato viene visualizzato in ogni spazio da riempire. I numeri negativi non sono supportati. **Esempio** In questo esempio, il valore di `Location.City ` è centrato con una dimensione di. *19* `{{center Location.City size=19}}` restituisce *"    Los Angeles    "*Se lo `Location.City` è*Los Angeles*. Si noti che le virgolette visualizzate nell'output di esempio sono fornite solo per evidenziare il concetto trattato. *cut* Rimuove il valore specificato da una stringa. **Utilizzo** `{{cut value [" "]}}`, sostituendo lo spazio all'interno del parametro " " con il valore da tagliare. Se per il parametro non viene passato alcun valore, viene utilizzato uno spazio. **Esempio** Questo esempio rimuove la lettera *e* dall'`Location.City`attributo. `{{cut Location.City "e"}}` restituisce *Los Angls*se `[Location.City` è*Los Angeles*. *dateFormat* Imposta lo stile di data predefinito per la data in qualsiasi risposta. Per un elenco del fuso orario IDs, vedere[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). **Utilizzo** `{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}` Il parametro `format` deve avere una delle seguenti impostazioni. + "`full`": formato di data completo. Ad esempio: *Tuesday, September 19, 2020* + "`long`": formato di data esteso. Ad esempio: *September 19, 2020* + "`medium`": formato di data medio. Ad esempio: *Sept 19, 2020* + "`short`": formato di data breve. Ad esempio: *9/19/20* + "`pattern`": utilizza un formato di modello di data personalizzato. Per ulteriori informazioni sui modelli di data, consulta [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html). "`locale`": utilizza un formato di data basato su una determinata impostazione locale. Per ulteriori informazioni sulle impostazioni locali, consulta [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-). Se un formato non viene passato, viene utilizzato `medium` per impostazione predefinita. **Esempio** In questo esempio, la `[0]` voce per `User.UserAttributes.StartDate.[0]` è **09/19/2020** e un messaggio viene inviato a un utente utilizzando il formato della `full` data basato sul fuso *America/Los\$1Angeles* orario. `We can meet with you any time on ``{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.` restituisce *We can meet with you any time on Tuesday, September 19, 2020.* *inflect* Restituisce una stringa singolare o plurale in base al valore del conteggio. **Utilizzo** `{{inflect count singular plural [includeCount=false]}}` + Immetti le forme singolare e plurale della stringa che desideri passare all'argomento. + Se `includeCount` è impostato su `false`, nella risposta non viene restituito alcun conteggio. Se invece è impostato su `true`, `count` viene incluso nella risposta. **Esempio** Gli esempi seguenti mostrano l'inflessione dell'acquisto di mele, con e senza `includeCount`. `Thank you for your purchase of {{inflect 3 apple apples includeCount=false}}.` restituisce: *Thank you for your purchase of apples.* Se `includeCount` è impostato su `true`, la risposta è *Thank you for your purchase of 3 apples.* *join* Unisce un array, un iteratore o un oggetto iterabile. La risposta restituisce un elenco, con ogni valore dell'elenco concatenato dal carattere passato in `join`. Ad esempio, è possibile separare i valori utilizzando una virgola (`,`). Il valore di questo helper deve essere un elenco senza un indice di posizione dell'attributo, ad esempio `Attributes.custom_attribute`. **Utilizzo** `{{join value " // " [prefix=""] [suffix=""]}}` **Esempio** In questo esempio, viene restituito un elenco di colori separati da una virgola e uno spazio (`", "`): `{{join Attributes.favorite_colors ", "}}` restituisce *blue, red, green*if `Attributes.favorite_colors` è l'elenco*blue,red,green*. *ljust* Giustifica il valore al margine sinistro e aggiunge spazio a destra in modo che la lunghezza del valore corrisponda al numero. I numeri negativi non sono supportati. Facoltativamente, puoi passare un carattere da visualizzare per `pad` o lasciare vuoto il campo. Se lasci vuoto il valore `pad`, il valore predefinito è uno spazio. **Utilizzo** `{{ljust value size=X [pad=" "]}}`, dove *X* è la lunghezza totale del valore, compreso lo spazio bianco. **Esempio** In questo esempio, un valore di giustificazione sinistra di *15 * viene applicato a Location.City. `{{ljust Location.City size=15}}` restituisce *"Los Angeles    "*se il valore di è. `Location.City` *Los Angeles* Si noti che le virgolette visualizzate nell'output di esempio sono fornite solo per evidenziare il concetto trattato. *lower* Converte un valore in formato tutto minuscolo. **Utilizzo** `{{lower value}}` **Esempio** In questo esempio, la voce `[0]` per `User.UserAttributes.LastName.[0]` viene modificata nel formato minuscolo. `{{lower User.UserAttributes.LastName.[0]}}` restituisce *santos*if *Santos* è il valore di`[0]`. *ora* Stampa la data corrente in base all'ID del fuso orario passato. Per un elenco del fuso orario IDs, vedere[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). **Utilizzo** `{{now ["format"] [tz=timeZoneId] [locale=localeID]}}` Il parametro `format` deve avere una delle seguenti impostazioni. + "`full`": formato di data completo. Ad esempio: *Tuesday, September 19, 2020* + "`long`": formato di data esteso. Ad esempio: *September 19, 2020* + "`medium`": formato di data medio. Ad esempio: 19 settembre 2020 + "`short`": formato di data breve. Ad esempio, 19/9/20 + "`pattern`": modello di data. Per ulteriori informazioni sui modelli di data, consulta [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html). "`locale`": utilizza un formato di data basato su una determinata impostazione locale. Per ulteriori informazioni sulle impostazioni locali, consulta [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-). Se un formato non viene passato, viene utilizzato `medium` per impostazione predefinita. **Esempio** In questo esempio, la data corrente di Los Angeles viene restituita con nel formato `medium`. `{{now "medium" tz=America/Los_Angeles}}` restituisce *Sept 19, 2020*. *ordinalize* Converte in ordinale il valore numerico passato nell'argomento. Ad esempio, *1* è ordinalizzato come *1st* e *2* come*2nd*. Sono supportati solo valori numerici. **Utilizzo** `{{ordinalize [number]}} ` **Esempio** In questo esempio, la voce `[0]` di `User.UserAttributes.UserAge` viene convertita in ordinale e restituita assieme a un messaggio. `Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!`restituisce *22* ordinalizzato come. *22nd* *Congratulations on your 22nd birthday\$1* *replace* Sostituisce una stringa con un'altra. Una stringa o un valore numerico deve essere letterale. I caratteri jolly non sono supportati. **Utilizzo** `{{replace stringToReplace replacementValue}}` **Esempio** In questo esempio, un carattere di sottolineatura (\$1) sostituisce uno spazio. `{{replace Location.City " " "_"}}` restituisce *Los\$1Angeles*se lo `Location.City ` è*Los Angeles*. *rjust* Giustifica il valore al margine destro e aggiunge spazio a sinistra in modo che la lunghezza del valore corrisponda al numero. I numeri negativi non sono supportati. Facoltativamente, puoi passare un carattere da visualizzare per `pad` o lasciare vuoto il campo. Se lasci vuoto il valore `pad`, il valore predefinito è uno spazio. **Utilizzo** `{{rjust value size=X [pad=" "]}}`, dove *X* è la lunghezza totale del valore, compreso lo spazio bianco. **Esempio** In questo esempio, all'`Location.City`attributo *15* viene applicato un valore di giustificazione corretto di. `{{rjust Location.City size=15}}` restituisce *"    Los Angeles" *. se lo `Location.City` è*Los Angeles*. Si noti che le virgolette visualizzate nell'output sono fornite solo per evidenziare il concetto trattato. *slugify* Converte il valore passato in minuscolo, rimuove i caratteri non letterali (alfanumerici e trattini bassi), converte gli spazi in trattini e rimuove gli spazi iniziali o finali. **Utilizzo** `{{slugify value}}` **Esempio** In questo esempio, viene eseguito slugify per l'attributo `Location.City`. `{{slugify Location.City}}` restituisce *los-angeles*se `Location.City` è*Los Angeles*. *stripTags* Elimina i tag [X]HTML da un valore. **Utilizzo** `{{stripTags value}}` **Esempio** In questo esempio, i tag HTML per l'utente. UserAttributes.interest. [0] vengono rimossi. `{{stripTags User.UserAttributes.interests.[0]}}` restituisce *Art*, se lo `User.UserAttributes.interests.[0]` è`

    Art

    `. *substring* Restituisce una nuova stringa come sottostringa del valore passato. La lunghezza e la posizione sono determinate dai parametri `startOffset` e `endOffset`, che devono essere numeri interi. I numeri negativi non sono supportati. Se `endOffset` viene passato, la sottostringa utilizza il valore finale originale della stringa. **Utilizzo** `{{substring value startOffset [endOffset]}}` **Esempio** In questo esempio, all'attributo Location.City vengono applicati offset impostato su 4 e endOffset impostato su 9. `{{substring Location.City 4 9}} ` restituisce `Angel`se Los Angeles è il nostro `Location.City` valore*Los Angeles*. *upper* Converte il valore passato in lettere maiuscole. **Utilizzo** `{{upper value}}` **Esempio** In questo esempio, la voce `[0] ` relativa all'attributo `User.UserAttributes.LastName` viene convertita interamente in lettere maiuscole. `{{upper User.UserAttributes.LastName.[0]}}` restituisce *ROE*se il `User.UserAttributes.LastName.[0]` valore è*Roe*. *yesno* Sostituisce `true`, `false` e `NULL` con `Yes`, `No` e `Maybe`. **Utilizzo** `{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}` **Esempio** In questo esempio, l'attributo `IsUserSubscribed` restituisce un valore indicante se un utente è iscritto a un elenco particolare. `{{yesno Attributes.IsUserSubscribed}}` restituisce *yes*se `Attributes.IsUserSubscribed` è*true*. ## Helper matematici e di codifica Questa sezione descrive gli helper **matematici** e di codifica. + `add`: restituisce la somma di due numeri. + `ceiling`: arrotonda un numero intero al relativo limite matematico superiore. + `decode64`: decodifica un valore codificato in formato base64 in una stringa. + `divide`: restituisce il quoziente di due numeri. + `encode64`: codifica una stringa utilizzando base64. + `floor`: arrotonda un numero intero al relativo limite matematico inferiore. + `md5`— Esegue l'hash di una stringa passata utilizzando l' MD5algoritmo. + `modulo`: restituisce il resto di due numeri utilizzando virgola mobile. + `multiply`: restituisce il prodotto di due numeri. + `round`: arrotonda un decimale al numero intero più vicino. + `sha256`: esegue l'hash di una stringa passata utilizzando SHA-256. + `sha512`: esegue l'hash di una stringa passata utilizzando SHA-512. + `subtract`: restituisce la differenza tra due numeri. + `uuid`: genera casualmente un UUID in un formato a 128 bit. *aggiungi* Restituisce la somma di due numeri assieme alle virgole mobili. **Utilizzo** `{{add arg1 arg2}}` **Esempio** `{{add 5 2.3}} ` restituisce *7.3* *ceiling* Arrotonda un numero intero al relativo limite matematico superiore, che è il numero intero più alto più vicino al valore passato. **Utilizzo** `{{ceiling value}}` **Esempio** `{{ceiling 5.23}}` restituisce *6* *decode64* Decodifica un valore in formato base64 in una stringa. **Utilizzo** `{{decode64 "string"}}` **Esempio** `{{decode64 "SGVsbG8gd29ybGQ="}}` restituisce *Hello World* *divide* Restituisce il quoziente di due numeri, incluse le virgole mobili. **Utilizzo** `{{divide arg1 arg2}}` **Esempio** `{{divide 5 2.3}}` restituisce *2.17391304* *encode64* Codifica la stringa passata nell’argomento utilizzando base64. **Utilizzo** `{{encode64 "string"}}` **Esempio** `{{encode64 "Hello World"}}` *SGVsbG8gd29ybGQ=* *floor* Arrotonda un numero intero al relativo limite matematico inferiore, che è il numero intero più basso più vicino al valore passato. **Utilizzo** `{{floor value}}` **Esempio** `{{floor 5.23}}` restituisce *5* *md5* Esegue l'hash di una stringa passata utilizzando l'algoritmo MD5 . **Utilizzo** `{{md5 "string"}}` **Esempio** `{{md5 "Hello World"}}` *3e25960a79dbc69b674cd4ec67a72c62* *modulo* Restituisce il resto di due numeri utilizzando virgola mobile. **Utilizzo** `{{modulo arg1 arg2}}` **Esempio** `{{modulo 7 2}}` restituisce *1* *multiply* Restituisce il prodotto di due numeri, con qualsiasi virgola mobile. **Utilizzo** `{{multiply arg1 arg2}}` **Esempio** `{{multiply 5 2.3}}` restituisce *11.5* *round* Arrotonda una cifra decimale per eccesso o per difetto al numero intero più vicino. **Utilizzo** `{{round value}}` **Esempio** `You spent an average of {{round 19.21}} minutes on our website each day.` restituisce: *You spent an average of 19 minutes on our website each day.* *sha256* Esegue l'hash di una stringa passata utilizzando la sicurezza crittografica SHA-256. **Utilizzo** `{{sha256 "string"}}` **Esempio** `{{sha256 "Hello World"}}` restituisce *a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e* *sha512* Esegue l'hash di una stringa passata utilizzando la sicurezza crittografica SHA-512. **Utilizzo** `{{sha512 "string"}}` **Esempio** `{{sha512 "Hello World"}}` restituisce *2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b* *subtract* Restituisce la differenza di due numeri, con qualsiasi virgola mobile. **Utilizzo** `{{subtract arg1 arg2}}` **Esempio** `{{subtract 5 2.3}} ` restituisce *2.7* *uuid* Genera casualmente un UUID in un formato standard a 128 bit. Non è necessario passare valori nell'argomento. **Utilizzo** `{{uuid}}` **Esempio** `{{uuid}} ` restituisce **95f36680-152c-4052-99ec-cc3cdf7ca594** ## Parziali inline Anche se tecnicamente non sono considerati helper, i parziali inline sono un modo con cui Handlebars semplifica i modelli che includono stringhe ripetute, facilitandone il riutilizzo. Per ulteriori informazioni, consulta la pagina relativa ai [parziali inline](https://handlebarsjs.com/guide/partials.html#inline-partials) nel sito web [handlebarsjs.com](https://handlebarsjs.com). **Utilizzo** `{{#* inline "inlineName"}}Content to reuse{{/inline}}` Per fare riferimento al contenuto del parziale inline in una posizione diversa, usa: ` {{> inlineName}}` **Esempio** Ad esempio, potresti creare un parziale inline contenente il nome del destinatario e, se disponibile, il cognome aggiungendo il codice seguente all’inizio del modello: `{{#* inline "fullName"}}` `{{User.UserAttributes.FirstName.[0]}} {{#if User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}` `{{/inline}}` Una volta creato il parziale `fullName`, puoi includerlo in qualsiasi punto del modello anteponendo al nome del parziale il segno "maggiore di" (`>`) seguito da uno spazio, come nell'esempio seguente: `{{> fullName}}`. *` Hello {{> fullName}}`* restituisce il nome e il cognome dell'utente se vero, *Hello Jane Doe* ad esempio. Altrimenti, se non viene trovato alcun cognome, *Hello Jane* viene restituito. In Handlebars sono disponibili altre funzionalità oltre a quelle documentate in questa sezione. Per ulteriori informazioni, consulta [handlebarsjs.com](https://handlebarsjs.com/). ## Utilizzare variabili con gli helper dei modelli di messaggio I nomi degli attributi personalizzati di Amazon Connect supportano gli spazi. Per avere un attributo personalizzato denominato `"Last Name"`, devi formattare l’attributo come `Attributes.[Last Name]`. ## Utilizzare helper annidati Puoi annidare più helper modello di messaggi l'uno nell'altro. L'esempio seguente mostra come formattare due helper: `{{ first helper (second helper)}}`. Il secondo helper viene elaborato per primo, seguito dal primo helper. Ricorda che è il primo helper a determinare sempre l'output. Gli helper successivi devono essere annidati all'interno dell'helper precedente nel seguente modo: `{{ first helper (second helper (third helper) )}}` L'esempio seguente mostra come annidare due helper per modificare **JANE** in **Jane**: `{{capitalizeFirst (lower "JANE")}}`. `lower` converte innanzitutto **JANE** in **jane**. Quindi `capitalizeFirst` converte **jane** in **Jane**. # I profili di sicurezza non influiscono sull’autorizzazione dell’agente per la visualizzazione di un thread di e-mail Qualsiasi utente con la seguente autorizzazione nel proprio profilo di sicurezza può leggere le e-mail che gestisce o quelle che fanno parte di un thread a cui partecipa: **Pannello di controllo contatti (CCP)** - **Accedi al Pannello di controllo contatti** - **Accesso**. ![\[Opzione Accedi al Pannello di controllo contatti nella pagina Profili di sicurezza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/access-ccp-perm.png) Questo comportamento di autorizzazione è abilitato per impostazione predefinita. Non richiede l’impostazione di autorizzazioni o configurazioni aggiuntive. Questo comportamento è determinato dalle seguenti chiavi di contesto: 1. `connect:UserArn`: rappresenta l’utente che ha accesso a un singolo contatto. 1. `connect:ContactAssociationId`: rappresenta l’associazione di contatti a cui l’utente ha accesso. Per il canale e-mail, un’associazione di contatti rappresenta sempre un thread e-mail. 1. `connect:Channel`: rappresenta il canale di contatto a cui l’utente ha accesso. Per il canale e-mail, questa contextKey è sempre `EMAIL`. Non è consigliabile utilizzare `connect:ContactAssociationId` nella stessa policy di `connect:UserArn` perché potrebbe comportare un’interruzione dell’operatività. Poiché la chiave di condizione `connect:UserArn` è più restrittiva, eseguirà il `Deny` dell’accesso per tutti i contatti non gestiti dall’utente corrispondente, indipendentemente dall’accesso che hanno ai thread di e-mail. Puoi utilizzare `connect:Channel` separatamente per limitare l’accesso a canali specifici. I valori accettati sono: `VOICE`, `CHAT`, `TASK` o `EMAIL`. Consulta l’API [Contatto](https://docs.aws.amazon.com/connect/latest/APIReference/API_Contact.html). Di seguito sono riportate le informazioni relative ai contatti APIs che supportano queste chiavi di contesto: 1. [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html) 1. [UpdateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContact.html) 1. [ListContactReferences](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactReferences.html) 1. [TagContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagContact.html) 1. [UntagContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_UntagContact.html) 1. [UpdateContactRoutingData](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactRoutingData.html) 1. [GetContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetContactAttributes.html) 1. [UpdateContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactAttributes.html) 1. [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html) 1. [StartContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactRecording.html) 1. [StopContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactRecording.html) 1. [ResumeContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_ResumeContactRecording.html) 1. [SuspendContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_SuspendContactRecording.html) 1. [UpdateContactSchedule](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactSchedule.html) 1. [TransferContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_TransferContact.html) 1. [StartScreenSharing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartScreenSharing.html)