Caso di utilizzo: Invio di e-mail transazionali con allegati

Lo scopo di questo caso d’uso è quello di aggiungere al volo allegati e-mail a messaggi in uscita.

Passaggi chiave

In questo scenario verrà illustrato come inviare e-mail transazionali con allegati singoli e/o personalizzati. Gli allegati non verranno precaricati nel server di messaggistica transazionale: invece saranno generate al volo.

Quando acquisite informazioni sui clienti o informazioni dettagliate, potrebbe essere necessario inviarle nuovamente al cliente al termine del processo, ad esempio in un file PDF allegato a un messaggio e-mail.

Di seguito sono riportati i passaggi principali di questo scenario:

1. Il cliente accede al sito Web e trova un prodotto che desidera acquistare.
2. Il cliente seleziona il prodotto e personalizza alcune opzioni.
3. Il cliente completa la transazione.
4. Al cliente viene inviato un messaggio e-mail di conferma della transazione. Poiché non si consiglia di inviare PII (Informazioni personali) all’indirizzo e-mail, viene generato un PDF protetto e allegato al messaggio e-mail.
5. Il cliente riceve l'e-mail e il relativo allegato contenente i dati pertinenti.

In questo scenario, gli allegati non vengono pre-creati, ma aggiunti al volo alle e-mail in uscita, il che offre i seguenti vantaggi:

• Questo consente di personalizzare il contenuto dell'allegato.
• Se l'allegato è associato a una transazione (come nello scenario di esempio sopra descritto), potrebbe contenere dati dinamici generati durante il processo del cliente.
• L’associazione di file PDF ottimizza la protezione e consente di cifrarli e inviarli mediante il protocollo HTTPS.

Raccomandazioni

Prima di implementare questo scenario, leggi attentamente le linee guida seguenti:

• Le istanze di Messaggi transazionali non devono essere utilizzate per memorizzare, esportare o caricare file o dati. Possono essere utilizzati solo per i dati dell'evento e le relative informazioni. Non devono essere considerati come un sistema di archiviazione file.
• Poiché non esiste un accesso diretto alle istanze o ai server di Messaggistica transnazionale al di fuori Adobe, non esiste un modo standard per inviare tali file in push su tali server (nessun accesso FTP).
• Non è invece corretto utilizzare lo spazio su disco nelle istanze dei messaggi transazionali per archiviare file di qualsiasi tipo, nemmeno per gli allegati.
• Per ospitare questi file è necessario utilizzare un altro sistema di dischi online. Hai bisogno di un accesso FTP a questo sistema e devi essere in grado di scrivere ed eliminare file.

Implementazione

Il diagramma seguente mostra i diversi passaggi per implementare questo scenario:

Per aggiungere al volo un allegato e-mail a un messaggio transazionale, effettua le operazioni seguenti:

1. Iniziate progettando l'allegato. Per ulteriori informazioni, consulta questa sezione.

   Questo consente di allegare i file a un'e-mail, anche se non sono ospitati nell'istanza di esecuzione.

2. Potete inviare le e-mail tramite un trigger di messaggio SOAP. Nella chiamata SOAP è presente un parametro URL (attachmentURL).

   Per ulteriori informazioni sulle richieste SOAP, vedere Descrizione evento.

3. Durante la progettazione del messaggio e-mail, fate clic su Attachment.

4. Nella schermata Attachment definition, immettete il parametro SOAP attachment:

   <%= rtEvent.ctx.attachementUrl %>
   

5. Quando il messaggio viene elaborato, il sistema riceve il file dalla posizione remota (server di terze parti) e lo allega al singolo messaggio.

   Poiché questo parametro può essere una variabile, deve accettare la variabile URL remota completa del file, inviata tramite la chiamata SOAP.