Deinen Emarsys-API-Schlüssel einrichten

Um E-Mail-Kampagnen aus Figma-Designs mit Emailify hochzuladen, erstellst du in Emarsys einen WSSE-Schlüssel, legst seine Berechtigungen fest und verbindest Emailify dann mit den erzeugten API-Zugangsdaten mit deinem Emarsys-Konto.

Deinen Emarsys-WSSE-Schlüssel erstellen

Im ersten Schritt erstellst du deinen WSSE-Schlüssel in Emarsys (dafür musst du Kontoinhaber sein). Navigiere dazu zu Management -> Security Settings -> API Credentials und erstelle dort deinen WSSE-Schlüssel.

Berechtigungen deines API-Schlüssels festlegen

Nachdem du deinen Schlüssel erstellt und Benutzername und Schlüssel sicher abgelegt hast (um sie im nächsten Schritt in das Figma-Plugin Emailify einzufügen), musst du außerdem die unten aufgeführten Berechtigungen für API-Endpunkte aktivieren, damit die API-Integration wie erwartet funktioniert:

• campaign.create
• campaign.update
• contactlist.list

HTML aus Emailify hochladen

Wähl im Export-Panel von Emailify in der Dropdown-Liste die Option Emarsys und füge dann gültige API-Zugangsdaten von Emarsys ein (aus dem vorherigen Schritt). Sobald Emarsys im Plugin authentifiziert ist, wählst du die Contact List, an die die Kampagne später gesendet werden soll, sowie From Name und From Email, also Name und Adresse, von der die Kampagne später versendet wird.

Wenn du so weit bist, klick auf den Button Upload To Emarsys. Emailify exportiert dann die in Figma ausgewählten E-Mails als HTML und lädt sie automatisch in deine Emarsys-Kampagnen hoch.

Aus Emailify hochgeladene Emarsys-Vorlagen aktualisieren

Wenn deine Emarsys-Vorlagen automatisch aktualisiert statt bei jedem Upload neu angelegt werden sollen, kannst du in den Exporteinstellungen des Plugins den Schalter Enable Updatable Templates aktivieren (wenn die Option Emarsys ausgewählt ist).

Damit wird automatisch ein emarsysTemplateId-Wert an den Ebenennamen des hochgeladenen Figma-Frames angehängt. Wird derselbe Frame beim nächsten Export aus dem Plugin erneut über die API zu Emarsys hochgeladen, wird diese ID wiederverwendet.

Hinweis: Damit das funktioniert, musst du bei deinem Emarsys-WSSE-Schlüssel die Berechtigung campaign.update aktivieren.

Hinweis: Der Schalter Enable Updatable Templates muss schon vor dem Upload deiner ersten Vorlage aktiviert sein. Nur dann wird die Emarsys Template ID der ursprünglich zu Emarsys hochgeladenen Vorlage an den Namen deines Figma-Frames angehängt. Diese ID wird dann bei allen künftigen Uploads genutzt, um dieselbe Vorlage in deinem Emarsys-Konto zu aktualisieren (statt jedes Mal eine neue anzulegen) – vorausgesetzt, der Schalter Enable Updatable Templates bleibt ebenfalls aktiviert.