Inxmail Konnektor
Der Inxmail Konnektor ermöglicht die Anbindung des E-Mail-Marketing-Systems Inxmail über die REST API.
Er unterstützt das Lesen und Schreiben aller relevanten Marketing- und Tracking-Daten, einschließlich Empfängern, Mailings, Versandstatistiken und Interaktionsdaten.
⚠️ Hinweis:
Die Inxmail REST API ist nicht automatisch für alle Kunden freigeschaltet.
Sie muss gesondert beantragt werden. Erst danach stehen API-URL, API-Benutzername und Passwort zur Verfügung.
Funktionsumfang
Der Konnektor ermöglicht u. a.:
- Lesen aller relevanten Marketingdaten
(Recipients, Listen, Mailings, Sendings, Klicks, Öffnungen) - Schreiben & Löschen von Empfängern und Listen
- Bulk-Operationen für Empfänger (RecipientImport)
- Automatische Schemaerweiterung um Link- und Tracking-Daten
- Nutzung der Daten in Universal Syncs und spezialisierten Syncs
- Abruf von Anmelde- und Abmelde-Ereignissen (Subscription Events)
Voraussetzungen
Bevor der Konnektor eingerichtet werden kann, müssen folgende Aktionen im Inxmail-Konto durchgeführt werden:
- REST-API für Ihren Account freischalten lassen
- API-Zugangsdaten abrufen:
- API URL
- API Benutzername
- API Passwort
Diese Werte werden in Syncler in den Systemeinstellungen eingetragen.
Einrichtung in Syncler
Neues System anlegen
- In Syncler unter Systeme → Neu ein neues System erstellen
- Konnektor „Inxmail“ auswählen
- Die folgenden Werte erfassen:
| Einstellung | Beschreibung |
|---|---|
| API Url | Basis-URL der Inxmail REST API |
| Benutzername | API-Benutzername |
| Passwort | API-Passwort |
Nach dem Speichern lädt Syncler automatisch das Schema, bestehend aus allen durch den Konnektor unterstützten Objekten.
Verfügbare Schemaobjekte
Der Inxmail Konnektor stellt folgende Objekte bereit:
- Bounce: fehlgeschlagene Zustellung
- Click: Klick in Newsletter, bereits durch das Objekt Link erweitert
- Link: Details zu klickbaren Links
- List: Empfängerlisten für Kampagnen
- Recipient: Empfänger
- RecipientImport: wird durch Bulk-Syncs zum Importieren von Empfängern genutzt
- Regular-Mailing: Mailingdetails
- Sending: konkreter Versand mit Listen- und Mailingbezug
- SendingDetail: Versandzusammenfassung (Anzahl nach Kategorie)
- SendingStatistic: Statistik zur Resultaten des Versands
- subscription-event: Abrufen von Anmeldungen
- unsubscription-event: Abrufen von Abmeldungen
- Web-Beacon-Hit: Öffnungen
Lesen von Daten
- Nur Listen des Typs STANDARD können abgerufen werden
- Empfänger werden automatisch mit allen Attributen geladen
- Click & Web-Beacon-Hit werden um Link-Daten erweitert
- Sending wird ergänzt um:
- SendingDetail
- SendingStatistic
- Mailing
Das Objekt List enthält zusätzlich eine geschachtelte Empfängerliste.
Das Abfrageverhalten kann mit den Filterparametern related und relatedid beeinflusst werden.
Das Abrufen von links kann mit related|:|mailing|;| auf ein bestimmtes Mailing beschränkt werden.
Das Abrufen von bounce, click oder web-beacon-hit kann mit related|:|...|;| auf list, mailing oder sending eingegrenzt werden.
Das Abrufen von recipient kann mit related|:|list|;| auf eine konkrete Liste begrenzt werden.
In allen Fällen muss der Bezug mit relatedid|:|###|;| hergestellt werden.
Schreiben von Daten
| Objekt | Lesen | Schreiben | Löschen | Hinweis |
|---|---|---|---|---|
| List | ✔ | – | ✔ | Nur Löschung möglich |
| Recipient | ✔ | ✔ | ✔ | E-Mail muss eindeutig sein |
| Recipient | ✔ | ✔ | – | Für Bulk-Operationen |
Empfänger werden nicht durch die E-Mail-Adresse identifiziert, sondern durch eine interne ID.
Daher kann eine doppelte E-Mail-Adresse beim Schreiben zu Fehlern führen.
Weitere Details zu Syncs mit CAS oder Sage CRM finden sie Hier.