Konnektoren
Schemaobjekte
Die SQL- und Dateibrücke
Das OAuth 2.0 Verfahren
Gesperrte Datensätze

SmartEmailing Konnektor

Der SmartEmailing-Konnektor verbindet Syncler mit der SmartEmailing REST-API (v3). Er unterstützt das Abrufen von Kontakten, Listen, E-Mails sowie Statistikobjekten und das Anlegen/Aktualisieren von Kontakten, Kontaktlisten und E-Mails. Authentifiziert wird per HTTP Basic (Username + API-Key).

Funktionsumfang

  • Lesen von:
    • Kontakten (inkl. Customfields & Listenmitgliedschaften)
    • Kontaktlisten
    • E-Mails
    • Kampagnen-Versandstatistiken (campaignstat)
    • Newsletter-Gesamtstatistik (newsletterstat)
  • Schreiben von:
    • Kontakten (Create/Update, optional Double-Opt-In)
    • Kontaktlisten (Create/Update)
    • E-Mails (Create)
  • Batch-Import von Kontakten (bis 500 je Request)
  • Filter, Sortierung, Paging (limit/offset)
  • „Geändert seit“-Abrufe (per updated/Header-Logik)

Voraussetzungen

  • SmartEmailing-Zugang mit Username und API-Key
  • API-URL (Standard: https://app.smartemailing.cz/api/v3)
  • Für DOI (Double-Opt-In): E-Mail-ID und Absenderdaten in SmartEmailing

Einrichtung & Authentifizierung

Konfigurieren:

Feld Beschreibung
ApiUrl Basis-URL der SmartEmailing-API (Standard v3)
Username SmartEmailing Benutzername
ApiKey SmartEmailing API-Key (wird per Basic Auth verwendet)

Optional (DOI-Einstellungen):

Feld Beschreibung
DoiEmailId ID der DOI-Kampagne/Email
DoiFrom Absenderadresse
DoiReplyTo Reply-To-Adresse
DoiSenderName Absendername
DoiThankYouUrl (Infofeld, nicht im Workflow verwendet)
DoiSendModeAll true: DOI an alle, false: nur an neue

Authentifizierung: Der Konnektor setzt für jeden Request den Authorization: Basic <base64(username:apikey)> Header.

Datenmodell - Schemaobjekte

Kontakt (contact)

  • Kern: id, emailaddress, Name/Adresse/Telefon, Sprache, Geschlecht
  • Zeitstempel (read-only): created, updated, last_opened, last_clicked
  • Customfields: Werden dynamisch aus SmartEmailing geladen (Typen: Text, Zahl, Datum, Bool, Select, Checkbox, Radio)
  • Listenmitgliedschaften: Objektgruppe contactlists mit contactlist_id & status (confirmed / unsubscribed)

Kontaktliste (contactlist)

  • Kern: id, name, publicname, sendername, senderemail, replyto
  • Kennzahlen (read-only): created, openRate, clickRate, …

E-Mail (email)

  • Kern: id, name (intern), title (Betreff), textbody/htmlbody (mind. eins), attachments (Dateinamen)

Kampagnen-Versandstatik (campaignstat)

  • Versandzeilen mit opened, clicked, unsubscribed, bounced, time (nur lesen)
  • Enthält newsletter_id und contact_id
  • Beispiel Filter: type=newsletter&campaign_id=#id#&opened=0

Newsletter-Gesamtstatistik (newsletterstat)

  • Summen/Kennzahlen je Newsletter (nur lesen)
  • Enthält email_id und id (newsletter_id)
  • Beispiel Filter: email_id=#id#

Häufige Fragen (FAQ)

Wie aktiviere ich DOI für neue Kontakte?
Tragen Sie DoiEmailId, DoiFrom, DoiReplyTo, DoiSenderName ein und setzen Sie optional DoiSendModeAll auf „alle“. Danach Kontakte normal speichern – der Konnektor steuert den DOI-Versand.

Kann ich die E-Mailadresse eines Kontakts ändern?
Ja. Tragen Sie die neue emailaddress ein. Der Konnektor führt automatisch change-emailaddress (von alt → neu) aus.

Warum kann ich E-Mails nicht ändern/löschen?
Die API sieht das im hier genutzten Kontext nicht vor. E-Mails lassen sich anlegen, Änderungen/Löschungen bitte in SmartEmailing selbst.

Wie filtere ich bestätigte/unsubscribed Mitglieder einer Liste?
Im Filter contactlist=<ID>&confirmed bzw. contactlist=<ID>&unsubscribed verwenden.