API & Schnittstellen

Die mailworx SOAP API erlaubt eine natlose Integration in Ihre Produkte. Ob eine Vollintegration oder die Synchronisation von Kontaktdaten erforderlich ist. Die standardisierte mailworx Web-Service Schnittstelle erfüllt Ihre Anforderungen.

Die Schnittstelle ist als SOAP Web-Serivce verfügbar und erlaubt einen verschlüsselten Zugriff per 1024 RSA Public Key SSL Zugang. Da es sich um eine SOAP Schnittstelle handelt ist diese unabhängig von der Technologie die diese Schnittstelle benutzt. Dadurch kann diese sowohl von JAVA, PHP, .NET als auch Phyton und anderen Programmiersprachen aufgerufen werden.
SOAP ist ein weit verbreiteter Standard und benutzt HTTP bzw. HTTPS als Übertragungsprotokoll. Dadurch ist keine spezielle Firewallkonfiguration notwendig.

Schnittstellenbeschreibung

Die Verwendung des Web-Service

Diese Seite beschreibt den Aufbau der mailworx Schnittstelle, sowie im Überblick die verfügbaren Methoden.

Abonnenten

Abonnentengruppen auslesen – GetProfiles

Abonnenten sind in Abonnentengruppen zusammengefasst. Diese Methode ermöglicht das auslesen der bestehenden Abonnentengruppen.

Erstellen einer neuen Abonnentengruppe - CreateProfile

Erstellen Sie eine neue statische Abonnentengruppe mit dieser Methode um zum Beispiel Abonnenten für einen späteren Versand zu gruppieren.

Ändern einer Abonnentengruppe – UpdateProfile

Aktualisieren Sie Abonnentengruppen mit dieser Methode.

Löschen einer Abonnentengruppe – DeleteProfile

Mit dieser Methode werden Abonnentengruppen, die nicht mehr benötigt werden wieder gelöscht.

Kombinieren von Abonnentengruppen - CombineProfile

Einzelne Abonnentengruppen werden zu einer neuen statischen Abonnentengruppe zusammengeführt.

Abonnenten aus einer Abonnentengruppe entfernen - RemoveSubscribersFromProfile

Mit dieser Methode werden Abonnenten aus einer statischen Abonnentengruppe entfernt.

Auslesen von Abonnentenfeldern - GetSubscriberFields

Diese Methode gibt Aufschluss darüber, welche Daten, z.B.: Vorname, Nachname, E-Mail, Geburtsdatum etc., für Abonnenten gespeichert werden. Diese Information ist für den Abonnentenimport und Abonnentenexport wichtig.

Exportieren von Abonnenten – ExportSubscribers

Die Kontaktsynchronisation wird mit der Kombination von Export und Import durchgeführt.

Abonnenten importieren – ImportSubscribers

Die Kontaktsynchronisation wird mit der Kombination von Export und Import durchgeführt.

Löschen von Abonnenten - DeleteSubscribers

Nicht mehr benötigte und lediglich temporär importierte Abonnenten können natürlich wieder gelöscht werden. Mit dieser Methode werden automatische Datenbereinigungsprozesse implementiert.

Wartung der Abonnentenfelder - UpdateSubscriberFields

Abonnentenfelder beschreiben welche Daten in mailworx für jeden Abonnenten abgelegt werden. Diese Methode ermöglicht das Bearbeiten dieser Felder.

Erstellen von Feldzuordnungen

Feldzuordnung beschreiben ein Matching von Abonnentenfelder verschiedener Anwendungen. Dadurch kann mailworx Kennzeichnen welche Daten von Ihrer Anwendung mit mailworx synchronisiert werden und welche nicht. Diese Information wird dem Benutzer visuell dargestellt.

Löschen von Feldzuordnungen

Feldzuordnung beschreiben ein Matching von Abonnentenfelder verschiedener Anwendungen. Dadurch kann mailworx Kennzeichnen welche Daten von Ihrer Anwendung mit mailworx synchronisiert werden und welche nicht. Diese Information wird dem Benutzer visuell dargestellt.

Kampagnen

Auslesen der verfügbaren Sprachen - GetLanguages

Liefert die für den aktuellen Mandanten verfügbaren Sprachen.

Auslesen von Kampagneninformationen – GetCampaigns

Liest alle verfügbaren E-Mail-Kampagnen aus.

Auslesen von kopierbaren Kampagnen – GetCopyableCampaigns

Nicht jede Kampagne ist dazu gedacht kopiert zu werden. In mailworx kann konfiguriert werden, welceh Kampagnen zum Kopieren verfügbar sind. Diese Methode liefert diese Information.

Kopieren einer bestehenden Kampagne – CopyCampaign

Erstellen Sie eine neue Kampagne auf Basis einer bereits bestehenden Kampagne.

Ändern einer Kampagne – UpdateCampaign

Aktualisieren Sie diverse Informationen einer Kampagne mit dieser Methode.

Erstellen einer Kampagne – CreateCampaign

Erstellen Sie mit dieser Methode eine neue E-Mail-Kampagne.

Sind bestehende Kampagnen noch in Arbeit – AreCampaignsInWork

Kampagnen unterliegen einem Workflow-Status. Diese Methode liefert alle E-Mail-Kampagnen, welche sich in Arbeit befinden.

Nachaussenden einer Kampagne – SendCampaignToSubscriber

E-Mail-Kampagnen können mithilfe dieser Methode an einzelne Abonnenten geschickt werden. Benachrichtigungen oder Geburtstagsmails werden damit abgebildet.

Erstellen eines Abschnittes einer Kampagne - CreateSection

Fügen Sie mithilfe dieser Methode einer bestehenden Kampagne einen neuen Abschnitt hinzu.

Ändern eines Abschnittes einer Kampagne - UpdateSection

Verwenden Sie diese Methode, um die Informationen eines Abschnittes zu aktualisieren.

Löschen eines Abschnittes einer Kampagne - DeleteSection

Mithilfe dieser Methode können Sie einen bestehenden Abschnitt einer Kampagne löschen.

Newslettervorlagen

Auslesen vorhandener Newslettervorlagen - GetTemplates

Um Kampagnen erstellen zu können ist es erforderlich die vorhandenen Newslettervorlagen zu kennen. Mit dieser Methode werden die verfügbaren Vorlagen ausgelesen.

Auslesen vorhandener Abschnitte einer Vorlage - GetSectionDefinitions

Zum Erstellen von zentralen Inhalten oder eines Abschnittes einer Kampagne wird die Definition des Abschnittes aus der Newslettervorlage benötigt. Vorhandene Abschnitte einer Newslettervorlage können mit dieser Methode ausgelesen werden.  

Zentrale Inhalte

Auslesen vorhandener zentraler Inhalte - GetCentralSections

Mit dieser Methode können alle zentralen Inhalte einer bestimmten Newslettervorlage ausgelesen werden. 

Erstellen eines zentralen Inhaltes - CreateCentralSection

Erstellen Sie mit dieser Methode einen neuen zentralen Inhalt.

Ändern eines zentralen Inhaltes - UpdateCentralSection

Aktualisieren Sie die im zentralen Inhalt enthaltenen Informationen.

Löschen eines zentralen Inhaltes - DeleteCentralSection

Benutzen Sie diese Methode um einen zentralen Inhalt zu löschen. 

Statistik

Kampagnenstatistik

Auslesen von Kampagnenstatistik-Informationen wie Rückläufer, Klicks oder auch Öffnungen.