Dokumentation AEM AEM-Tutorials AEM Forms-Tutorials

Integrieren von AEM Forms in SendGrid

Letzte Aktualisierung: 2. April 2025

Gilt für:
Experience Manager 6.4
Experience Manager 6.5

Themen:
Adaptive Formulare

Erstellt für:

Fortgeschrittener
Entwickler

Willkommen bei diesem technischen Handbuch, in dem wir den Prozess des E-Mail-Versands mit dynamischen SendGrid-Vorlagen aus AEM Forms untersuchen. In diesem Handbuch erfahren Sie, wie Sie dynamische Vorlagen nutzen können, um E-Mail-Inhalte effektiv zu personalisieren.

Mit dynamischen Vorlagen können Sie E-Mail-Vorlagen erstellen, die Empfängerinnen und Empfängern je nach den im adaptiven Formular erfassten Daten unterschiedliche Inhalte präsentieren. Durch Personalisierungsvariablen können Sie zielgerichtete und benutzerdefinierte E-Mail-Erlebnisse bereitstellen, die bei Ihrer Zielgruppe ankommen.

Darüber hinaus werden wir uns mit der Verwendung der Swagger-Datei befassen, mit der Sie Ihre E-Mails weiter personalisieren können, indem Sie den Namen und die E-Mail-Adresse der Kundin oder des Kunden einschließen sowie die entsprechende dynamische E-Mail-Vorlage auswählen.

Befolgen Sie die schrittweisen Anweisungen in diesem Dokument, um die Leistungsfähigkeit dynamischer SendGrid-Vorlagen und AEM Forms zu nutzen und Ihre E-Mail-Kommunikation in eine neue Dimension der Interaktion und Relevanz zu führen. Fangen wir an!

Voraussetzungen

Bevor Sie mit dem Versand von E-Mails mit dynamischen SendGrid-Vorlagen aus AEM Forms fortfahren, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

SendGrid-Konto: Registrieren Sie sich auf https://sendgrid.com für ein SendGrid-Konto, um auf die entsprechenden E-Mail-Versanddienste zuzugreifen. Sie benötigen die Konto-Anmeldeinformationen, um SendGrid in AEM Forms zu integrieren.
Vertrautheit mit der Erstellung von Datenquellen: Sie verfügen über Kenntnisse zum Erstellen von Datenquellen in AEM Forms. Ausführliche Anweisungen finden Sie ggf. in der Dokumention zum Erstellen von Datenquellen.
Vertrautheit mit dem Formulardatenmodell: Sie verstehen das Konzept des Formulardatenmodells in AEM Forms. Lesen Sie bei Bedarf die Dokumentation zum Erstellen von Formulardatenmodellen, um sicherzustellen, dass Sie über die erforderlichen Kenntnisse verfügen.

Wenn Sie diese Voraussetzungen erfüllen, verfügen Sie über die nötigen Kenntnisse und Ressourcen, um E-Mails mit dynamischen SendGrid-Vorlagen aus AEM Forms effektiv zu versenden.

Beispiel-Assets

Im Rahmen dieses Artikels werden folgende Beispiel-Assets bereitgestellt:

Swagger-Datei: Diese Datei ermöglicht den Versand von E-Mails mithilfe einer dynamischen E-Mail-Vorlage. Sie liefert die erforderlichen Spezifikationen und Konfigurationen zur Integration in SendGrid und AEM Forms für einen nahtlosen E-Mail-Versand.

Nutzen Sie die bereitgestellte Swagger-Datei als Referenz oder Ausgangspunkt, um E-Mail-Funktionen mit dynamischen Vorlagen zu implementieren.

Testanweisungen

Gehen Sie wie folgt vor, um die in diesem Handbuch beschriebenen Funktionen zu testen:

Laden Sie die Swagger-Datei aus dem Assets-Ordner herunter.
Erstellen Sie eine Restful-Datenquelle mithilfe der heruntergeladenen Swagger-Datei und Ihrer SendGrid-Anmeldeinformationen.
Erstellen Sie ein Formulardatenmodell basierend auf der Restful-Datenquelle.
Rufen Sie den mail/send-POST-Vorgang des Formulardatenmodells entsprechend Ihren Anforderungen auf. Beispielsweise können Sie die E-Mail beim Klicken auf eine Schaltfläche auslösen oder als Teil Ihres AEM Forms-Workflows einschließen.

Die Beispiel-Payload für den Dienst ist wie folgt. Ersetzen Sie die Platzhalterwerte durch Ihre eigenen Daten:

{
    "sendgridpayload": {
        "from": {
            "email": "gs@xyz.com"
        },
        "personalizations": [{
            "to": [{
                "email": "johndoe@xyz.com"
            }],
            "dynamic_template_data": {
                "customerName": "John Doe"
            }
        }],
        "template_id": "d-72aau292a3bd60b5300c"
    }
}

Stellen Sie sicher, dass template_id der ID Ihrer dynamischen SendGrid-E-Mail-Vorlage entspricht und die E-Mail-Adressen gültig sind und von SendGrid überprüft wurden. Anhand der Werte im Abschnitt personalizations können Sie die E-Mail mithilfe der von der Benutzerin oder dem Benutzer eingegebenen Daten aus dem adaptiven Formular personalisieren.

Indem Sie diese Schritte ausführen und die bereitgestellte Payload anpassen, können Sie die Integration dynamischer SendGrid-Vorlagen in AEM Forms effektiv testen.

recommendation-more-help