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à.
Utilizzo di modelli per l'invio di e-mail personalizzate con l'API Amazon SES
In Amazon SES puoi inviare email basate su modelli utilizzando un modello archiviato o utilizzando un modello in linea.
-
Modello memorizzato — Si riferisce al
Templaterisorsa creata e salvata in SES utilizzandoCreateEmailTemplateoperazione nell'API Amazon SES v2. Il modello contiene l'oggetto e il corpo dell'email contenenti variabili (segnaposto) in linea con il contenuto scritto. Il nome del modello archiviato e i dati dinamici delle variabili segnaposto nel modello vengono forniti quando si chiama ilSendEmailoSendBulkEmailoperazioni API v2.Modelli memorizzati possono essere facilmente riutilizzati e possono farti risparmiare tempo e fatica quando invii tipi di email simili. Invece di creare ogni email da zero, è sufficiente creare la struttura di base e il design una sola volta, quindi aggiornare semplicemente il contenuto dinamico all'interno del modello.
-
Modello in linea — Il
Templatela risorsa non viene utilizzata, ma l'oggetto e il corpo dell'email contenenti le variabili (segnaposto) in linea con il contenuto scritto insieme ai valori per tali variabili segnaposto vengono forniti quando si chiama ilSendEmailoSendBulkEmailoperazioni API v2.Modelli in linea semplificate il processo di invio di e-mail in massa eliminando la necessità di gestire le risorse dei modelli nel vostro account SES e semplificate il processo di integrazione consentendovi di includere i contenuti dei modelli direttamente nella logica dell'applicazione. Non vengono conteggiati nel limite di 20.000 modelli per Regione AWS.
I seguenti limiti si applicano quando si utilizza modelli archiviati:
-
Puoi creare fino a 20.000 modelli di email in ciascuno Regione AWS.
-
Ogni modello può raggiungere le dimensioni massime di 500 KB, inclusi testo e parti HTML.
Il seguente limite si applica quando si utilizza modelli in linea:
-
Ogni file JSON di input può avere una dimensione massima di 1 MB, incluse le parti di testo e HTML.
Quanto segue si applica a entrambi immagazzinato e modelli in linea:
-
Non ci sono limiti al numero di variabili sostitutive che possono essere utilizzate.
-
È possibile inviare e-mail a un massimo di 50 oggetti di destinazione in ogni chiamata al
SendBulkEmailoperazione. LeDestinationl'oggetto può contenere più destinatari definiti in ToAddresses, CcAddresses, e BccAddresses. Il numero di destinazioni che puoi contattare con una singola chiamata all'API v2 potrebbe essere limitato dalla velocità di invio massima del tuo account. Per ulteriori informazioni, consulta Gestione dei limiti di invio di Amazon SES.
Questo capitolo include procedure con esempi per l'utilizzo di entrambe modelli archiviati e modelli in linea.
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, consulta il AWS Command Line Interface Guida per l'utente.
(Facoltativa) Parte 1: Impostazione delle notifiche degli eventi di Rendering Failure
Se invii un'e-mail che contiene contenuti di personalizzazione non validi, Amazon SES potrebbe inizialmente accettare il messaggio, ma non sarà in grado di consegnarlo. Per questo motivo, se prevedi di inviare email personalizzate, devi configurare SES per inviare notifiche di eventi di Rendering Failure tramite Amazon SNS. Quando ricevi una notifica di eventi di errore di rendering, puoi identificare il messaggio con i contenuti non validi, risolvere i problemi e inviare di nuovo il messaggio.
La procedura in questa sezione è opzionale, ma fortemente consigliata.
Configurazione delle notifiche di eventi di errore di rendering
-
Crea un argomento Amazon SNS. Per le istruzioni, consulta Creazione di un argomento nella Guida per gli sviluppatori di Amazon Simple Notification Service.
-
Iscriviti all'argomento Amazon SNS. Ad esempio, se desideri ricevere le notifiche di errore di rendering via e-mail, effettua la sottoscrizione di un endpoint di e-mail (ovvero il tuo indirizzo e-mail) all'argomento.
Per le istruzioni, consulta Sottoscrizione a un argomento nella Guida per gli sviluppatori di Amazon Simple Notification Service.
-
Completa le procedure in Configurazione di una destinazione degli eventi Amazon SNS per la pubblicazione di eventi per impostare i set di configurazione per la pubblicazione degli eventi di errore di rendering nel tuo argomento Amazon SNS.
(Facoltativo) Parte 2: creazione di un modello di email
Se intendi utilizzare un modello archiviato, questa sezione ti mostrerà come usare il CreateEmailTemplate Operazione API SES v2 per creare il modello. Puoi saltare questo passaggio se desideri utilizzare un modello in linea.
Questa procedura si basa sul presupposto che l' AWS CLI sia già stata installata e configurata. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consulta il AWS Command Line Interface Guida per l'utente.
Creazione del modello
-
In un editor di testo, crea un nuovo file e incolla il codice seguente personalizzandolo in base alle tue esigenze.
{ "TemplateName": "MyTemplate", "TemplateContent": { "Subject": "Greetings, {{name}}!", "Text": "Dear {{name}},\r\nYour favorite animal is {{favoriteanimal}}.", "Html": "<h1>Hello {{name}},</h1><p>Your favorite animal is {{favoriteanimal}}.</p>" } }Questo codice contiene le seguenti proprietà:
-
TemplateName — Il nome del
Templaterisorsa. 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 valoretagnameper ogni destinazione. -
Html — Il corpo HTML dell'email. Questa proprietà può contenere tag di sostituzione. L'esempio precedente include due tag:
{{name}}e{{favoriteanimal}}. -
- Testo — Il corpo del testo dell'email. I destinatari i cui client di posta elettronica non visualizzano contenuti HTML vedranno questa versione dell'email. Questa proprietà può contenere anche tag sostitutivi.
-
-
-
Personalizza l'esempio precedente in base alle tue esigenze, quindi salva il file come
mytemplate.json. -
Nella riga di comando, digitate il comando seguente per creare un nuovo modello utilizzando
CreateEmailTemplateOperazione API v2:aws sesv2 create-email-template --cli-input-json file://mytemplate.json
Fase 3: invio dell'e-mail personalizzata
È possibile utilizzare le due seguenti operazioni API SES v2 per inviare e-mail utilizzando una delle due modelli archiviati o modelli in linea:
-
Il
SendEmaill'operazione è utile per inviare un'email personalizzata a un singolo oggetto di destinazione. L'API v2Destinationl'oggetto può contenere ToAddresses, CcAddresses, e BccAddresses proprietà. Possono essere utilizzati in qualsiasi combinazione e possono contenere uno o più indirizzi e-mail che riceveranno la stessa e-mail. -
Il
SendBulkEmaill'operazione è utile per inviare email univoche a più oggetti di destinazione in una singola chiamata all'API v2.
Questa sezione fornisce esempi di come utilizzare il AWS CLI per 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
Puoi usare SendEmail operazione per inviare un messaggio di posta elettronica a uno o più destinatari definiti in un unico oggetto di destinazione. Tutti i destinatari nell'oggetto Destination riceveranno la stessa e-mail.
Per inviare un'e-mail basata su un modello a un singolo oggetto di destinazione
-
A seconda che si desideri utilizzare un modello memorizzato o modello in linea, seleziona il rispettivo esempio di codice da incollare in un editor di testo, personalizzandolo in base alle tue esigenze.
-
Personalizza l'esempio precedente in base alle tue esigenze, quindi salva il file come
myemail.json. -
Nella riga di comando, digita il seguente comando API v2 per inviare l'email:
aws sesv2 send-email --cli-input-json file://myemail.json
Invio di email basate su modelli a più oggetti di destinazione
Puoi usare il SendBulkEmail operazione per inviare un'e-mail a più oggetti di destinazione in una singola chiamata all'API SES v2. SES invia un'e-mail univoca al destinatario o ai destinatari di ciascuno Destination oggetto.
Per inviare un'e-mail basata su un modello a più oggetti di destinazione
-
A seconda che si desideri utilizzare un modello memorizzato o modello in linea, seleziona il rispettivo esempio di codice da incollare in un editor di testo, personalizzandolo in base alle tue esigenze.
-
Modifica i valori nel codice precedente in base alle tue esigenze, quindi salva il file con il nome
mybulkemail.json. -
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