Cas d'utilisation : envoi d'e-mails transactionnels avec des pièces jointes

L'objectif de ce cas pratique est d'ajouter des pièces jointes d'emails à la volée aux envois sortants.

Principales étapes

Dans ce scénario, vous allez apprendre à envoyer des emails transactionnels avec des pièces jointes individuelles et/ou personnalisées. Les pièces jointes ne seront pas préchargées sur le serveur de messagerie transactionnelle, mais générées à la volée.

Lorsque vous capturez des interactions ou des détails sur un client, vous devrez peut-être lui renvoyer ces informations à la fin du processus, par exemple dans un fichier PDF joint à un email.

Voici les étapes générales de ce scénario :

1. Le client accède au site web et trouve le produit qu'il souhaite acheter.
2. Il sélectionne le produit et personnalise certaines options.
3. Il termine la transaction.
4. Un email est envoyé au client pour confirmer la transaction. L'envoi de PII dans un email n'étant pas recommandé, un fichier PDF sécurisé est généré et joint à cet email.
5. Le client reçoit l'email et la pièce jointe contenant toutes les données nécessaires.

Dans ce scénario, les pièces jointes ne sont pas créées à l'avance, mais ajoutées à la volée aux emails sortants, avec les avantages suivants :

• Vous pouvez personnaliser le contenu de la pièce jointe.
• Si elle est associée à une transaction (comme dans l'exemple de scénario ci-dessus), elle peut contenir des données dynamiques générées pendant le processus client.
• L'ajout de fichiers PDF optimise la sécurité lorsque vous pouvez les chiffrer et les envoyer via HTTPS.

Recommandations

Avant de mettre en œuvre ce scénario, lisez attentivement les directives suivantes :

• Les instances de messagerie transactionnelle ne doivent pas être utilisées pour stocker, exporter ou charger des fichiers ou des données. Elles ne peuvent être utilisées que pour les données d'événements et les informations s'y rapportant. Elles ne doivent pas être considérées comme un système de stockage de fichiers.
• Comme il n'existe aucun accès direct aux instances de messagerie transactionnelle ou aux serveurs à l'extérieur d'Adobe, il n'y a aucun moyen standard de transférer ces fichiers sur ces serveurs (pas d'accès FTP).
• D'un point de vue contractuel, il n'est pas correct d'utiliser l'espace disque sur l'instance de messagerie transactionnelle pour stocker des fichiers, quels qu'ils soient, même pour les pièces jointes.
• Pour héberger ces fichiers, vous devez utiliser un autre système de disque en ligne. Vous avez besoin d'un accès FTP à ce système et vous devez pouvoir écrire et supprimer des fichiers.

Mise en œuvre

Le diagramme suivant montre les différentes étapes pour mettre en œuvre ce scénario :

Pour ajouter à la volée une pièce jointe à un message transactionnel, procédez comme suit :

1. Commencez par créer votre pièce jointe. Voir à ce propos cette section.

   Vous pouvez ainsi joindre les fichiers à un email, même s'ils ne sont pas hébergés sur l'instance d'exécution.

2. Vous pouvez envoyer des emails via un déclencheur de message SOAP. Un appel SOAP contient un paramètre d'URL (attachmentURL).

   Pour plus d'informations sur les requêtes SOAP, voir la section Description des événements.

3. Lors de la conception de votre email, cliquez sur Pièce jointe.

4. Dans l'écran Définition d'un fichier attaché, saisissez le paramètre de pièce jointe SOAP :

   <%= rtEvent.ctx.attachmentUrl %>
   

5. Lorsque le message est traité, le système extrait le fichier de l'emplacement distant (serveur tiers) et le joint au message.

   Comme ce paramètre peut être une variable, il doit accepter la variable d'URL distante entièrement formée de votre fichier, envoyée via l'appel SOAP.