Your favorite animal is {{favoriteanimal}}.
" } } ``` Questo codice contiene le seguenti proprietà: + **TemplateName**— Il nome della `Template` risorsa. Quando invii l'e-mail, fai riferimento a questo nome. + **TemplateContent**— Un contenitore per i seguenti attributi: + **Oggetto**: riga dell'oggetto dell'e-mail. Questa proprietà può contenere tag di sostituzione. Questi tag utilizzano il formato seguente: `{{tagname}}`. Quando invii l'e-mail, puoi specificare un valore `tagname` per ogni destinazione. + **Html**: il corpo HTML del messaggio di posta elettronica. Questa proprietà può contenere tag di sostituzione. L'esempio precedente include due tag: `{{name}}` e `{{favoriteanimal}}`. + **Testo**: il corpo del testo dell'e-mail. I destinatari i cui client di posta elettronica non visualizzano contenuti HTML vedranno questa versione dell'e-mail. Questa proprietà può contenere anche tag sostitutivi. 1. Personalizza l'esempio precedente in base alle tue esigenze, quindi salva il file come *mytemplate.json*. 1. Nella riga di comando, digitate il seguente comando per creare un nuovo modello utilizzando l'operazione API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateEmailTemplate.html)v2: ``` aws sesv2 create-email-template --cli-input-json file://mytemplate.json ``` ## Fase 3: invio dell'e-mail personalizzata È possibile utilizzare le seguenti due operazioni API SES v2 per inviare e-mail utilizzando *modelli archiviati o modelli* *in* linea: + L'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)operazione è utile per inviare un'e-mail personalizzata a un singolo oggetto di destinazione. L'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html)oggetto API v2 può contenere le *BccAddresses*proprietà *ToAddresses*CcAddresses**, e. Questi possono essere utilizzati in qualsiasi combinazione e possono contenere uno o più indirizzi e-mail che riceveranno la stessa e-mail. + L'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html)operazione è utile per inviare e-mail uniche a più oggetti di destinazione in un'unica chiamata all'API v2. Questa sezione fornisce esempi di come utilizzare per AWS CLI inviare e-mail basate su modelli utilizzando entrambe queste operazioni di invio. ### Invio di e-mail basate su modelli a un singolo oggetto di destinazione È possibile utilizzare l'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendEmail.html)operazione per inviare un'e-mail a uno o più destinatari definiti in un singolo oggetto di destinazione. Tutti i destinatari nell'oggetto [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html) riceveranno la stessa e-mail. **Per inviare un'e-mail basata su un modello a un singolo oggetto di destinazione** 1. A seconda che desideri utilizzare un *modello memorizzato o un modello* *in linea*, seleziona il rispettivo esempio di codice da incollare in un editor di testo, personalizzandolo in base alle tue esigenze. ------ #### [ Stored template code example ] Notate che il modello creato nel passaggio precedente viene utilizzato come valore per il parametro. *MyTemplate*`TemplateName` ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"Alejandro\", \"favoriteanimal\": \"alligator\" }" } }, "ConfigurationSetName": "ConfigSet" } ``` Questo codice contiene le seguenti proprietà: + **FromEmailAddress**— L'indirizzo e-mail del mittente. + **Destinazione**: un oggetto contenente i destinatari di posta elettronica definiti nelle *ToAddresses*proprietà *CcAddresses*, e *BccAddresses*. Questi possono essere utilizzati in qualsiasi combinazione e possono contenere uno o più indirizzi e-mail che riceveranno lo stesso messaggio di posta elettronica. + **TemplateContent**— Un contenitore per i seguenti attributi: + **Oggetto**: riga dell'oggetto dell'e-mail. Questa proprietà può contenere tag di sostituzione. Questi tag utilizzano il formato seguente: `{{tagname}}`. Quando invii l'e-mail, puoi specificare un valore `tagname` per ogni destinazione. + **Html**: il corpo HTML del messaggio di posta elettronica. Questa proprietà può contenere tag di sostituzione. L'esempio precedente include due tag: `{{name}}` e `{{favoriteanimal}}`. + **Testo**: il corpo del testo dell'e-mail. I destinatari i cui client di posta elettronica non visualizzano contenuti HTML vedranno questa versione dell'e-mail. Questa proprietà può contenere anche tag sostitutivi. + **TemplateData**— Una stringa JSON con escape che contiene coppie chiave-valore. Le chiavi corrispondono alle variabili definite nelle `TemplateContent` proprietà di questo file, ad esempio. `{{name}}` I valori rappresentano il contenuto che sostituisce le variabili. + **ConfigurationSetName**— Il nome del set di configurazione da utilizzare per l'invio dell'e-mail. **Nota** È consigliabile utilizzare un set di configurazione configurato per pubblicare gli eventi di errore di rendering in Amazon SNS. Per ulteriori informazioni, consulta [(Facoltativo) Parte 1: Impostazione delle notifiche relative agli eventi di errore di rendering](#send-personalized-email-set-up-notifications). ------ 1. Personalizza l'esempio precedente in base alle tue esigenze, quindi salva il file come *myemail.json*. 1. Nella riga di comando, digita il seguente comando API v2 per inviare l'e-mail: ``` aws sesv2 send-email --cli-input-json file://myemail.json ``` ### Invio di e-mail basate su modelli a più oggetti di destinazione È possibile utilizzare l'[https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_SendBulkEmail.html)operazione per inviare un'e-mail a più oggetti di destinazione in un'unica chiamata all'API SES v2. SES invia un'e-mail univoca al destinatario o ai destinatari di ciascun [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Destination.html)oggetto. **Per inviare un'e-mail basata su un modello a più oggetti di destinazione** 1. A seconda che desideri utilizzare un *modello memorizzato o un modello* *in linea*, seleziona il rispettivo esempio di codice da incollare in un editor di testo, personalizzandolo in base alle tue esigenze. ------ #### [ Stored template code example ] Notate che il modello creato nel passaggio precedente viene utilizzato come valore per il parametro. *MyTemplate*`TemplateName` ``` { "FromEmailAddress": "Mary MajorYour favorite animal is {{favoriteanimal}}.
" }, "TemplateData": "{ \"name\":\"friend\", \"favoriteanimal\":\"unknown\" }" } }, "BulkEmailEntries": [ { "Destination": { "ToAddresses": [ "anaya.iyengar@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Anaya\", \"favoriteanimal\":\"angelfish\" }" } } }, { "Destination": { "ToAddresses": [ "liu.jie@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Liu\", \"favoriteanimal\":\"lion\" }" } } }, { "Destination": { "ToAddresses": [ "shirley.rodriguez@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{ \"name\":\"Shirley\", \"favoriteanimal\":\"shark\" }" } } }, { "Destination": { "ToAddresses": [ "richard.roe@example.com" ] }, "ReplacementEmailContent": { "ReplacementTemplate": { "ReplacementTemplateData": "{}" } } } ], "ConfigurationSetName": "ConfigSet" } ``` Questo codice contiene le seguenti proprietà: + **FromEmailAddress**— L'indirizzo e-mail del mittente. + **DefaultContent**— Un oggetto JSON che contiene gli oggetti `TemplateContent` and`TemplateData`. + **TemplateContent**— Un contenitore per i seguenti attributi: + **Oggetto**: riga dell'oggetto dell'e-mail. Questa proprietà può contenere tag di sostituzione. Questi tag utilizzano il formato seguente: `{{tagname}}`. Quando invii l'e-mail, puoi specificare un valore `tagname` per ogni destinazione. + **Html**: il corpo HTML del messaggio di posta elettronica. Questa proprietà può contenere tag di sostituzione. L'esempio precedente include due tag: `{{name}}` e `{{favoriteanimal}}`. + **Testo**: il corpo del testo dell'e-mail. I destinatari i cui client di posta elettronica non visualizzano contenuti HTML vedranno questa versione dell'e-mail. Questa proprietà può contenere anche tag sostitutivi. + **TemplateData**— Contiene coppie chiave-valore che verranno utilizzate se l'`ReplacementEmailContent`oggetto contiene un oggetto JSON vuoto`{}`, nella proprietà. `ReplacementTemplateData` + **BulkEmailEntries**— Un array che contiene uno o più oggetti. `Destination` + **Destinazione**: un oggetto contenente i destinatari di posta elettronica definiti nelle *BccAddresses*proprietà *ToAddresses*CcAddresses**, e. Questi possono essere utilizzati in qualsiasi combinazione e possono contenere uno o più indirizzi e-mail che riceveranno lo stesso messaggio di posta elettronica. + **ReplacementTemplateData**— Una stringa JSON con escape che contiene coppie chiave-valore. Le chiavi corrispondono alle variabili definite nelle `TemplateContent` proprietà di questo file, ad esempio. `{{name}}` I valori rappresentano il contenuto che sostituisce le variabili nell'e-mail. (Se la stringa JSON qui è vuota, indicata da`{}`, verranno utilizzate le coppie chiave-valore definite nella `TemplateData` proprietà all'interno dell'`DefaultContent`oggetto.) + **ConfigurationSetName**— Il nome del set di configurazione da utilizzare per l'invio dell'e-mail. **Nota** È consigliabile utilizzare un set di configurazione configurato per pubblicare gli eventi di errore di rendering in Amazon SNS. Per ulteriori informazioni, consulta [(Facoltativo) Parte 1: Impostazione delle notifiche relative agli eventi di errore di rendering](#send-personalized-email-set-up-notifications). ------ 1. Modifica i valori nel codice precedente in base alle tue esigenze, quindi salva il file con il nome *mybulkemail.json*. 1. Nella riga di comando, digita il seguente comando API v2 per inviare l'e-mail in blocco: ``` aws sesv2 send-bulk-email --cli-input-json file://mybulkemail.json ``` # Personalizzazione avanzata dell'email Se utilizzi un *modello archiviato*, ovvero hai creato una [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_Template.html)risorsa in Amazon SES utilizzando l'`CreateEmailTemplate`operazione con l'API SES v2, puoi sfruttare il sistema Handlebars per creare modelli che includono funzionalità avanzate, come attributi annidati, iterazione di array, istruzioni condizionali di base e creazione di parziali in linea. In questa sezione vengono forniti alcuni esempi di queste caratteristiche. Handlebars include altre caratteristiche oltre quelle documentate in questa sezione. Per ulteriori informazioni, consulta la pagina relativa agli [Helper integrati](https://handlebarsjs.com/guide/builtin-helpers.html) in [handlebarsjs.com](http://handlebarsjs.com). **Nota** SES non fa l'escape del contenuto HTML durante il rendering del modello HTML per un messaggio. Ciò significa che se includi i dati inseriti dall'utente, ad esempio da un modulo di contatto, devi farne l'escape sul lato client. **Topics** + [ ## Analisi degli attributi nidificati ](#send-personalized-email-advanced-nested) + [ ## Scorrimento degli elenchi ](#send-personalized-email-advanced-iterating) + [ ## Utilizzo di istruzioni condizionali di base ](#send-personalized-email-advanced-conditionals) + [ ## Creazione di funzioni parziali in linea ](#send-personalized-email-advanced-inline-partials) ## Analisi degli attributi nidificati Handlebars include il supporto per percorsi nidificati, semplificando la gestione dei dati complessi dei clienti e facendo quindi riferimento a quei dati nei tuoi modelli e-mail. Per esempio, puoi organizzare i dati dei destinatari in diverse categorie generali. In ciascuna di quelle categorie, puoi includere informazioni dettagliate. L'esempio di codice che segue mostra un esempio di questa struttura per un singolo destinatario: ``` { "meta":{ "userId":"51806220607" }, "contact":{ "firstName":"Anaya", "lastName":"Iyengar", "city":"Bengaluru", "country":"India", "postalCode":"560052" }, "subscription":[ { "interest":"Sports" }, { "interest":"Travel" }, { "interest":"Cooking" } ] } ``` Nei tuoi modelli di e-mail, puoi riferirti agli attributi nidificati fornendo il nome dell'attributo padre, seguito da un punto (.), seguito dal nome dell'attributo per il quale si desidera includere il valore. Ad esempio, se utilizzi la struttura di dati illustrata nell'esempio precedente e desideri includere il nome di ciascun destinatario nel modello e-mail, includi il seguente testo nel tuo modello e-mail: `Hello {{contact.firstName}}!` Handlebars è in grado di analizzare percorsi nidificati in diversi livelli, il che significa che disponi di una certa flessibilità nella modalità di strutturazione dei tuoi dati di modello. ## Scorrimento degli elenchi La funzione helper `each` scorre gli elementi in una matrice. Il codice seguente è un esempio di un modello e-mail che utilizza la funzione helper `each` per creare un elenco dettagliato degli interessi di ogni destinatario. ``` { "Template": { "TemplateName": "Preferences", "SubjectPart": "Subscription Preferences for {{contact.firstName}} {{contact.lastName}}", "HtmlPart": "You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
", "TextPart": "Your Preferences\n\nYou have indicated that you are interested in receiving information about the following subjects:\n {{#each subscription}} - {{interest}}\n {{/each}} \nYou can change these settings at any time by visiting the Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}" } } ``` **Importante** Nel precedente esempio di codice, i valori degli attributi `HtmlPart` e `TextPart` includono interruzioni di riga per rendere più semplice la lettura dell'esempio. Il file JSON per il tuo modello non è in grado di contenere interruzioni di riga all'interno di questi valori. Se hai copiato e incollato questo esempio nel tuo file JSON, prima di procedere rimuovi le interruzioni di riga e gli spazi eccedenti dalle sezioni `HtmlPart` e `TextPart`. Dopo che hai creato il modello, puoi utilizzare l'operazione `SendEmail` o `SendBulkEmail` per inviare e-mail ai destinatari utilizzando questo modello. Se ogni destinatario dispone di almeno un valore nell'oggetto `Interests`, questi ricevono un'e-mail che include un elenco dettagliato dei loro interessi. L'esempio seguente mostra un file JSON che può essere utilizzato per inviare e-mail a più destinatari utilizzando il modello precedente: ``` { "Source":"Sender NameDear {{contact.firstName}},
{{#if subscription}}You have indicated that you are interested in receiving information about the following subjects:
You can change these settings at any time by visiting the Preference Center.
{{else}}Please update your subscription preferences by visiting
the
Preference Center.
{{/if}}",
"TextPart": "Your Preferences\n\nDear {{contact.firstName}},\n\n
{{#if subscription}}
You have indicated that you are interested in receiving
information about the following subjects:\n
{{#each subscription}}
- {{interest}}\n
{{/each}}
\nYou can change these settings at any time by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{else}}
Please update your subscription preferences by visiting the
Preference Center at https://www.example.com/prefererences/i.aspx?id={{meta.userId}}.
{{/if}}"
}
}
```
**Importante**
Nel precedente esempio di codice, i valori degli attributi `HtmlPart` e `TextPart` includono interruzioni di riga per rendere più semplice la lettura dell'esempio. Il file JSON per il tuo modello non è in grado di contenere interruzioni di riga all'interno di questi valori. Se hai copiato e incollato questo esempio nel tuo file JSON, prima di procedere rimuovi le interruzioni di riga e gli spazi eccedenti dalle sezioni `HtmlPart` e `TextPart`.
L'esempio seguente mostra un file JSON che può essere utilizzato per inviare e-mail a più destinatari utilizzando il modello precedente:
```
{
"Source":"Sender Name You have listed the following people as your friends: This is the HTML part of the message. This is the HTML part of the message.Hello {{> fullName}}!
{{#each friends}}
",
"TextPart": "{{#* inline \"fullName\"}}
{{firstName}}{{#if lastName}} {{lastName}}{{/if}}
{{/inline~}}\n
Hello {{> fullName}}! You have listed the following people
as your friends:\n
{{#each friends}}
- {{> fullName}}\n
{{/each}}"
}
}
```
**Importante**
Nel precedente esempio di codice, i valori degli attributi `HtmlPart` e `TextPart` includono interruzioni di riga per rendere più semplice la lettura dell'esempio. Il file JSON per il tuo modello non è in grado di contenere interruzioni di riga all'interno di questi valori. Se hai copiato e incollato questo esempio nel tuo file JSON, prima di procedere rimuovi le interruzioni di riga e gli spazi eccedenti da queste sezioni.
# Gestione dei modelli e-mail
Oltre a [creare modelli di e-mail](send-personalized-email-api.md), puoi anche utilizzare l'API Amazon SES v2 per aggiornare o eliminare modelli esistenti, elencare tutti i modelli esistenti o visualizzare il contenuto di un modello.
Questa sezione contiene le procedure per l'utilizzo AWS CLI di eseguire attività relative ai modelli SES.
**Nota**
Queste procedure si basano anche sul presupposto che l' AWS CLI sia già stata installata e configurata. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consultate la [Guida per l'AWS Command Line Interface utente](https://docs.aws.amazon.com/cli/latest/userguide/).
## Visualizzazione di un elenco di modelli e-mail
È possibile utilizzare l'operazione API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListEmailTemplate.html)SES v2 per visualizzare un elenco di tutti i modelli di e-mail esistenti.
**Visualizzazione di un elenco di modelli e-mail**
+ Nella riga di comando, inserisci il comando seguente:
```
aws sesv2 list-email-templates
```
Se nel tuo account SES nella regione corrente sono presenti modelli di e-mail esistenti, questo comando restituisce una risposta simile al seguente esempio:
```
{
"TemplatesMetadata": [
{
"Name": "SpecialOffers",
"CreatedTimestamp": "2020-08-05T16:04:12.640Z"
},
{
"Name": "NewsAndUpdates",
"CreatedTimestamp": "2019-10-03T20:03:34.574Z"
}
]
}
```
Se non è stato creato alcun modello, il comando restituisce un `TemplatesMetadata` senza membri.
## Visualizzazione del contenuto di un modello specifico di e-mail
È possibile utilizzare l'operazione API [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailTemplate.html)SES v2 per visualizzare il contenuto di un modello di e-mail specifico.
**Visualizzazione del contenuto di un modello di e-mail**
+ Nella riga di comando, inserisci il comando seguente:
```
aws sesv2 get-email-template --template-name MyTemplate
```
Nel comando precedente, sostituiscilo *MyTemplate* con il nome del modello che desideri visualizzare.
Se il nome del modello che avete fornito corrisponde a un modello esistente nel vostro account SES, questo comando restituisce una risposta simile al seguente esempio:
```
{
"Template": {
"TemplateName": "TestMessage",
"SubjectPart": "Amazon SES Test Message",
"TextPart": "Hello! This is the text part of the message.",
"HtmlPart": "\n\nHello!
\nHello!
\n