Ganz einfach: Du brauchst zwei zentrale Dateien.

Die MailDesignerIntegrationExample-Datei in FileMaker zeigt dir Schritt für Schritt die benötigten Skripte (.fmp12 Filemaker Datei):


In der Mail Designer 365-Vorlage findest du Platzhalter, die dir zeigen, wie deine FileMaker-Felder direkt im Design zum Leben erwachen (Mail Designer Datei):


Öffne diese Mail Designer Datei und gehe danach direkt auf Ablage > Sichern, um sie in deinem Projekt zu sichern.

Du hast noch kein Mail Designer?

Erstelle einen FileMaker String mit deinen vorhandenen Datenbank-Variablen, damit sie den Platzhaltern im Mail Designer 365 Template entsprechen. Übergebe die Werte an das FileMaker Send-Skript (cURL-basiert), um aus einem Eintrag E-Mails mit einem Klick zu ermöglichen. So einfach geht es!

Die API-Integration ist kompatibel mit FileMaker Versionen ab FileMaker 12 sowie mit der FileMaker Go iOS App kompatibel. Bei der Nutzung von Attachments wird mindestens FileMaker 18 benötigt.

Ja, mit der Mail Designer API kannst du zum Beispiel gezielt Platzhalter in Designs füllen und automatisiert versenden. So lassen sich beispielsweise direkt aus FileMaker personalisierte Emails and Kunden versenden.

Nutze die Template ID, um ein bestimmtes Design anzusteuern. Du findest die Template ID im Platzhalter-Inspektor: wähle einen Platzhalter in deinem Design aus und kopiere die Template ID (ganz unten in der der Seitenleiste).

Die API Dokumentation befindet sich hier:
https://my.maildesigner365.com/docs/api

Du musst die Absenderadresse festlegen – es können nur Adressen verwendet werden, die unter folgendem Link hinterlegt wurden:
https://my.maildesigner365.com/team/deliveries/domains

Mit Platzhaltern lassen sich einfach Zielgruppen erstellen oder deine E-Mails personalisieren. In Drittanbieter-Apps wie z.B. FileMaker kannst du Felder anlegen, die du als Platzhalter in Designs hinterlegst, um diese E-Mails automatisch und personalisiert aus FileMaker zu versenden.

Ein Platzhalter (z.B. "Land") kann mehrere Werte annehmen (z.B. "Deutschland", "USA").

Füge deinen Kontakten Platzhalter hinzu, um anschließend auf dieser Basis Zielgruppen zu erstellen (z.B. "Newsletter nur an Nutzer in USA").

Oder füge in der Mail Designer 365 App diese Platzhalter in deine E-Mails ein, um sie zu personalisieren (z.B. "Ganz 'Deutschland' feiert jetzt den Super-Sale!").

Mehr im Handbuch erfahren

Die folgenden Schritte basieren auf dem Definitionsabschnitt des Skripts „Send record with Mail Designer 365“ und erläutern diesen. Das Skript ist in unserer frei verfügbaren FileMaker-Demo-Datenbank „MailDesignerIntegrationExample“ enthalten. (siehe Link am Ende dieser FAQ)

Schritt 1: Erstelle die Variable $AttributeFields

Beginne mit der Erstellung einer Variable namens $AttributeFieldsDiese Variable enthält den Textstring, der den Platzhalter-Inhalt definiert, der in deiner Mail Designer 365 E-Mail-Vorlage verwendet wird. Alle Werte müssen durch Kommata getrennt sein.

Szenario A: FileMaker-Feldnamen stimmen mit den E-Mail-Platzhaltern überein

Methode:
Verwende FileMaker-Feldnamen, die direkt mit den Platzhaltern in deinem E-Mail-Design übereinstimmen. Erstelle die $AttributeFields-Variable, indem du diese Feldnamen kommasepariert auflistest.

In Mail Designer verwendest du einfach den Feldnamen als Platzhalter.

Format:
$AttributeFields = "Table::Field1,Table::Field2,Table::Field3"

Beispieldefinition von $AttributeFields in FileMaker:
$AttributeFields="CityHotel::GUEST_FIRST_NAME,CityHotel::GUEST_LAST_NAME,CityHotel::GUEST_EMAIL,CityHotel::BOOKING_METHOD"

In Mail Designer 365 kannst du später auf die Werte über diese Platzhalter zugreifen:
GUEST_FIRST_NAME
GUEST_LAST_NAME
GUEST_EMAIL
BOOKING_METHOD

---

Szenario B: FileMaker-Feldnamen stimmen nicht mit den Platzhaltern in Mail Designer überein

Methode:
Erstelle die $AttributeFields-Variable, indem du jeden Platzhalternamen manuell dem entsprechenden Feld oder der entsprechenden Variable zuordnest, im Format:
$AttributeFields = "PLACEHOLDER_NAME:" & FieldName_or_Variable & "," …

Beispieldefinition von $AttributeFields in FileMaker:
"BOOKING_DATE:" & RESERVATION_DATE & "," &
"BOOKING_TIME:" & RESERVATION_TIME & "," & …

---

Szenario C: Verwendung von FileMaker-Variablen als Platzhalter

Methode:
Wenn deine FileMaker-Variable denselben Namen wie der Platzhalter in Mail Designer 365 hat, kannst du sie direkt so zuweisen:
$AttributeFields = "$city,$country"
Dies sagt Mail Designer, dass der Wert von $city für den Platzhalter mit dem Namen „city“ verwendet werden soll.

Beispiel:
Die FileMaker-Variable $city enthält „München“. Wenn deine Mail Designer-Vorlage einen Platzhalter mit dem Namen „city“ enthält, dann definiere:
$AttributeFields = "$city"
Das Skript zeigt dann den Inhalt „München“ an und übergibt ihn an Mail Designer, um den Platzhalter „city“ auszufüllen.

---

Das beste Szenario D: Kombination aller Methoden

Du kannst die oben genannten Ansätze in einem einzigen $AttributeFields-String kombinieren.

Methode:
Mische übereinstimmende Feldnamen, manuell zugeordnete Felder und Variablen in der $AttributeFields-Variable.

Beispiel:
$AttributeFields = "BOOKING_DATE:" & RESERVATION_DATE & "," &
"CityHotel::BREAKFAST_TYPE," & "$city"

In Mail Designer 365 kannst du dann auf sie mit den Namen BOOKING_DATE, BREAKFAST_TYPE und city zugreifen.

Um ein E-Mail-Design für die Verwendung mit deiner FileMaker-Integration festzulegen, gehe zu:

https://my.maildesigner365.com/team/designs

Klicke auf das Drei-Punkte-Symbol und wähle „Mail Designer 365 API: Template-ID kopieren“.

Diese ID wirst du dann verwenden, um die Variable $EMailTemplateID festzulegen.

Die Integration von Mail Designer erfordert keine zusätzliche Installation von FileMaker-Plug-ins oder Ähnlichem. Technisch erfolgt die Integration über einen CURL-Aufruf des API-Endpunkts unseres Mail-Designer-Versandservices. Dies wird mithilfe des entsprechenden FileMaker-Skriptschritts umgesetzt.

Somit ist eine Nutzung mit FileMaker Go für iPhone und iPad möglich.

Mit der Bereitstellung der FileMaker-Demodatei können alle entsprechenden Schritte nachvollzogen werden. Siehe FAQ "Wie starte ich mit der Mail Designer Integration?"

Ja, das ist möglich. Du benötigst mindestens FileMaker 18, um Anhänge über unsere API hinzuzufügen.

Aktuell werden nur Text-Platzhalter von der API unterstützt. Bildplatzhalter sind auf unserer Roadmap für einen späteren Zeitpunkt.

Unsere eigenen Tests haben gezeigt, dass oft das Filemaker Script nicht gespeichert wurde, bevor man einen weiteren Anlauf machen. Man erkennt das an dem Sternchen:

Ja, Du kannst die Integration in der FileMaker Go iOS App testen, um E-Mails mit deinem iPhone oder iPad zu versenden.

Ja, ohne weiteren Eingriff in deine API oder FileMaker Lösung. Deine API oder FileMaker-Lösung verweist nur auf die Template-ID aus Mail Designer – du kannst das Design jederzeit ändern: Logos, Texte, saisonale Elemente, ganz ohne Script-Anpassung. Einfach in Mail Designer 365 bearbeiten und speichern. Fertig.

Alle unsere Lizenzen beinhalten eine kostenlose 7-tägige Testphase – perfekt, um sämtliche Funktionen in Ruhe auszuprobieren und ganz flexibel zu entscheiden.
Besuche unseren Mail Designer 365 Store. Sollten Fragen oder Probleme im Testzeitraum auftreten, kannst du uns gerne jederzeit kontaktieren.

Für Fragen und Feedback aller Art stehen wir dir gerne über unser Support-Formular zur Verfügung.

Für die Erstellung der Vorlagen ist eine Mail Designer 365 Design-Lizenz erforderlich.
Für den Versand wird zusätzlich ein Mail Designer 365 Versandplan benötigt.

Dein Kunde benötigt einen Mail Designer Kampagnenplan, abhängig davon, wie viele E-Mails er versenden möchte. So funktioniert die Abrechnung:
1. Team anlegen:
Erstelle für jeden Kunden ein eigenes Team in Mail Designer 365. Dort kannst du auch das Zahlungsmittel hinterlegen.
2. Zahlung über dich:
Möchtest du die Abrechnung selbst übernehmen, hinterlege deine eigene Kreditkarte. Du erhältst für jedes Team eine separate, ordentliche Rechnung. Wie viel du deinem Kunden weiterberechnest, entscheidest du selbst.
3. Zahlung durch den Kunden:
Alternativ kann dein Kunde direkt für den Versandplan zahlen. In diesem Fall hinterlegst du einfach die Zahlungsdaten deines Kunden im jeweiligen Team.

Nein, du musst für jeden Kunden ein eigenes Team anlegen. Vermische keine Kunden innerhalb eines Teams – allein aus Datenschutzgründen ist es wichtig, dass Versandverlauf und andere kundenspezifische Daten sauber getrennt bleiben.
Du selbst kannst natürlich Administrator in allen Teams sein.
Erstelle ein neues Team pro Kunde über:
https://my.maildesigner365.com/teams/new

Jeder Versandplan bei Mail Designer enthält ein monatliches Kontingent an sogenannten Stamps. Ein Stamp entspricht einer E-Mail an einen Empfänger – etwa bei einem Massenversand an 10.000 Adressen werden entsprechend 10.000 Stamps verwendet.

Bei Nutzung der Mail Designer API werden pro versendeter E-Mail 25 Stamps berechnet.

Beispiel: Der Versandplan „Paris“ umfasst 15.000 Stamps pro Monat – ausreichend für bis zu 600 API-Mails.

Überblick über die Mail Designer Versandpläne

Alle unsere Lizenzen beinhalten eine kostenlose 7-tägige Testphase – perfekt, um sämtliche Funktionen in Ruhe auszuprobieren und ganz flexibel zu entscheiden.
Besuche unseren Mail Designer 365 Store. Sollten Fragen oder Probleme im Testzeitraum auftreten, kannst du uns gerne jederzeit kontaktieren.

Für Fragen und Feedback aller Art stehen wir dir gerne über unser Support-Formular zur Verfügung.