Mautic-Integration

Die Mautic-Integration hält deine Newsletter-Kontakte und auf Wunsch alle Spender:innen in deiner Mautic-Instanz aktuell. Neben Name und E-Mail überträgt sie Profildaten, Tags und auf Wunsch Spendendaten, mit denen du in Mautic Segmente und Kampagnen aufbaust.

📍

Voraussetzung: Die Mautic-Integration ist ein optionales Modul. Kontaktiere den Soulclick-Support für die Aktivierung.

📍

Navigation: Admin-Bereich → Mautic


Überblick

DatenRichtungBeschreibung
KontakteSoulclick → MauticAlle Newsletter-Abonnements mit bestätigtem Double Opt-in, mit E-Mail, Vorname und Nachname. Mit einem Spender-Segment auch alle Spender:innen.
ProfildatenSoulclick → MauticAnrede, Sprache, Spendertyp, Firma und Datum des Opt-ins
SpendendatenSoulclick → MauticSpendenband, Anzahl Spenden, letzte Spende und Dauerspende (optional)
SegmenteSoulclick → MauticEinmalige Aufnahme in ein Newsletter-Segment und optional in ein Spender-Segment
TagsSoulclick → MauticNewsletter-Tag, Spender-Tag, Dauerspender-Tag und ein Tag pro Spendenband
Kontaktfelder, Segmente und TagsMautic → SoulclickWerden importiert, damit du sie zuordnen kannst

Aus Mautic liest Soulclick nur Kontaktfelder, Segmente und Tags. Kontaktdaten fliessen nie zurück.


So funktioniert die Synchronisation

  • Du bestimmst, was geschrieben wird: Soulclick legt in Mautic keine Felder, Segmente oder Tags an. Du importierst sie und ordnest ihnen die Soulclick-Attribute zu. Nur zugeordnete Attribute werden geschrieben.
  • Newsletter nur mit Opt-in: Ins Newsletter-Segment kommen nur Personen, die den Newsletter per Double Opt-in bestätigt haben. Wer nur spendet, landet nur in Mautic, wenn du ein Spender-Segment zuordnest.
  • Auslöser: Die Bestätigung des Newsletters, jede bezahlte Spende, auch jede Folgezahlung einer Dauerspende, und das Ende einer Dauerspende. Soulclick verarbeitet die Auslöser alle 5 Minuten.
  • Immer aktuell: Bei jeder Synchronisation berechnet Soulclick alle Werte neu und überschreibt die zugeordneten Felder. Änderungen in Mautic an diesen Feldern gehen dabei verloren. Leere Werte sendet Soulclick nie: Ein Feld ohne Wert bleibt in Mautic, wie es ist.
  • Ein Kontakt pro E-Mail-Adresse: Gibt es die E-Mail-Adresse in Mautic schon, aktualisiert Soulclick diesen Kontakt. Wer den Newsletter abonniert und spendet, ist in Mautic ein einziger Kontakt.
  • Übernahme bei der Einrichtung: Sind das Newsletter-Segment und alle Felder, Tags und Werte zugeordnet, startest du unter Einstellungen mit Bestehende Kontakte übernehmen neben Sichern die einmalige Übernahme. Soulclick speichert dabei auch deine Änderungen auf der Seite und überträgt im Hintergrund alle bestehenden Newsletter-Kontakte, mit einem Spender-Segment auch alle Spender:innen. Kontakte, die es in Mautic schon gab, nimmt Soulclick dabei nicht ins Segment auf: So bleibt eine Abmeldung aus einem Segment bestehen. Ordnest du das Spender-Segment erst später zu, startest du seine Übernahme dort noch einmal. Den Stand siehst du bei Bestehende Kontakte, auch wie viele Kontakte nicht ins Segment kamen, weil es sie in Mautic schon gab.

Einrichtung

Schritt 1: Mautic vorbereiten

Richte in Mautic zuerst Folgendes ein:

  1. API einschalten: Aktiviere unter Configuration → API Settings die Optionen «API enabled?» und «Enable HTTP basic auth?».
  2. API-Benutzer anlegen: Lege für Soulclick einen eigenen Benutzer mit einer eigenen Rolle an. Welche Rechte die Rolle braucht, steht in der Tabelle unten.
  3. E-Mail als Erkennungsmerkmal: Das Kontaktfeld Email muss das eindeutige Merkmal (Unique Identifier) deiner Kontakte sein. So ist Mautic voreingestellt.
  4. Kontaktfelder anlegen: Lege die Felder an, die Soulclick füllen soll, und veröffentliche sie. Nur veröffentlichte Felder kannst du importieren. Welche Felder sich lohnen und welchen Typ sie brauchen, steht unter Marketing-Automation-Integrationen im Abschnitt «Empfohlene Felder». Den Betrag der letzten Spende legst du als Zahl mit 2 Dezimalstellen an: Die Dezimalstellen des Feldes bestimmen, wie Mautic eine Zahl speichert und anzeigt.
  5. Segmente anlegen: Lege ein Segment ohne Filter für deine Newsletter-Kontakte an und, wenn du alle Spender:innen in Mautic haben willst, ein zweites für sie.
  6. Tags anlegen: Lege die Tags an, die Soulclick setzen soll. Nur bestehende Tags kannst du importieren und zuordnen.

Die Rolle des API-Benutzers braucht diese Rechte, jeweils auch für Einträge anderer Benutzer:innen:

BereichRechte
KontakteAnsehen, Erstellen und Bearbeiten
SegmenteAnsehen und Bearbeiten
KontaktfelderAnsehen
TagsAnsehen

Schritt 2: Zugangsdaten hinterlegen

Öffne in Soulclick Mautic → Zuordnungen & Einstellungen → Einstellungen, trage die Zugangsdaten ein und speichere.

FeldBeschreibung
Mautic Basis-URLAdresse deiner Mautic-Instanz ohne /api, z. B. https://mautic.example.ch
BenutzernameDer API-Benutzer aus Schritt 1
PasswortDas Passwort dieses Benutzers
Spendendaten synchronisierenÜberträgt zusätzlich die Spendendaten. Standardmässig ausgeschaltet.

Beim Speichern prüft Soulclick die Zugangsdaten bei Mautic. Lehnt Mautic sie ab, wird nichts gespeichert und du siehst die Antwort von Mautic.

Schritt 3: Kontaktfelder, Segmente und Tags importieren

Öffne Importierte Objekte und klicke auf Jetzt aktualisieren. Soulclick lädt alle veröffentlichten Kontaktfelder, alle Segmente und alle Tags. Die Reiter Kontaktfelder, Segmente und Tags zeigen sie mit Titel, Feldtyp, Alias und ID.

Legst du in Mautic etwas Neues an, aktualisiere danach die Liste.

Schritt 4: Felder zuordnen

Öffne Zuordnungen. Drei Standardfelder sind fest verbunden und werden immer geschrieben: E-Mail-Adresse → Email, Vorname → First Name und Nachname → Last Name.

Klicke auf Zuordnung hinzufügen, wähle das Soulclick Attribut und das Mautic Objekt und speichere. Unter dem Attribut steht, was es enthält und welchen Feldtyp es in Mautic braucht. Felder mit unpassendem Typ und bereits vergebene Felder sind ausgegraut. Hinter dem Titel steht der Alias des Feldes in eckigen Klammern. Eine automatische Zuordnung gibt es für Mautic nicht.

Ordne keine Systemfelder von Mautic zu, etwa Attribution oder Attribution Date. Diese füllt Mautic selbst.

Schritt 5: Segmente zuordnen

Newsletter-Segment: Ordne dem Attribut Newsletter-Segment (Kontakte mit bestätigtem Newsletter-Opt-in) das Segment zu, in das Soulclick deine Newsletter-Kontakte aufnimmt. Es gibt genau ein Newsletter-Segment.

Spender-Segment (optional): Ordne dem Attribut Spender-Segment (alle Spender:innen, auch ohne Newsletter-Opt-in) ein Segment zu, wenn alle Spender:innen in Mautic landen sollen, auch ohne Newsletter-Anmeldung. Soulclick nimmt jede Person mit mindestens einer erfolgreichen Spende, ob einmalig oder wiederkehrend, ein einziges Mal in dieses Segment auf, mit den zugeordneten Profilfeldern aus ihrem Spenderkonto. Ohne diese Zuordnung überträgt Soulclick nur Newsletter-Kontakte.

Newsletter-Segment und Spender-Segment sind zwei verschiedene Segmente. Wer den Newsletter abonniert und spendet, ist in beiden.

Schritt 6: Tags zuordnen

Soulclick AttributWer den Tag erhält
Newsletter-Tag (Kontakte mit bestätigtem Newsletter-Opt-in)Alle Newsletter-Kontakte
Spender-Tag (Kontakte mit mindestens einer Spende)Mit Spender-Segment alle Spender:innen. Ohne Spender-Segment nur Newsletter-Kontakte mit Spenden, und nur mit Spendendaten synchronisieren.
Dauerspender-Tag (Kontakte mit aktiver wiederkehrender Spende)Kontakte mit aktiver Dauerspende, nur mit Spendendaten synchronisieren. Ist keine Dauerspende mehr aktiv, entfernt Soulclick den Tag.
Spendenband-Tag 0-100 … 5000+Der Tag des aktuellen Bands, nur mit Spendendaten synchronisieren. Die Tags der anderen Bänder entfernt Soulclick.

Einem Attribut kannst du mehrere Tags zuordnen. Jeder Tag nimmt nur ein Attribut auf.

Der Spender-Tag ist für alle Spender:innen gleich. Für Abstufungen nach Spendensumme nutzt du die Spendenband-Tags.

Schritt 7: Werte zuordnen

Anrede, Sprache, Spendertyp, Spendenband und Dauerspender haben feste Werte. Ordnest du eines dieser Attribute einem Dropdown-Feld zu, legst du nach dem Speichern unter Werte-Zuordnungen fest, welche Option in Mautic zu welchem Soulclick-Wert gehört: Wähle in jeder Zeile den Soulclick Wert und die Mautic Option, zum Beispiel Female → Frau.

  • Fehlt die Option für einen Wert, lässt Soulclick das Feld bei Kontakten mit diesem Wert aus.
  • Ohne Werte-Zuordnungen wird das Feld nie geschrieben.
  • Die Spalte Werte-Zuordnung zeigt «vollständig» oder die fehlenden Werte.

Bei allen anderen Feldtypen entfällt dieser Schritt, siehe Attribute.


Attribute

Soulclick AttributInhaltFeldtyp in Mautic
Newsletter-Segment (Kontakte mit bestätigtem Newsletter-Opt-in)Newsletter-Kontakte, einmalig ins Segment aufgenommenSegment
Spender-Segment (alle Spender:innen, auch ohne Newsletter-Opt-in)Alle Personen mit mindestens einer erfolgreichen Spende, einmalig ins Segment aufgenommen. Optional.Segment
Newsletter-Tag (Kontakte mit bestätigtem Newsletter-Opt-in)Für alle Newsletter-KontakteTag
Spender-Tag (Kontakte mit mindestens einer Spende)Für alle Spender:innen, siehe SpendendatenTag
Dauerspender-Tag (Kontakte mit aktiver wiederkehrender Spende)Solange eine Dauerspende aktiv ist, siehe SpendendatenTag
Spendenband-Tag 0-100 … 5000+Ein Tag pro Spendenband, siehe SpendendatenTag
Anrede (Herr/Frau)Male, Female oder noGender. Ein Text- oder Nachschlagefeld erhält Herr oder Frau.Dropdown, Nachschlagefeld oder Textfeld
Bevorzugte Sprache (de/fr/it/en)de, fr, it oder enGebietsschema, Dropdown oder Textfeld
Spendertyp (Privat/Geschäft)Privat oder GeschäftDropdown oder Textfeld
FirmaFirmenname, z. B. Muster AGTextfeld
Datum des Newsletter-Opt-insDatum der Bestätigung, z. B. 2026-08-17. Ein Datum/Zeit-Feld erhält den vollen Zeitpunkt, z. B. 2026-08-17T14:05:09+02:00.Datum, Datum/Zeit oder Textfeld
Spendensumme als Band (z.B. 100-500)0-100, 100-500, 500-1000, 1000-5000 oder 5000+Dropdown oder Textfeld
Anzahl wiederkehrende SpendenAlle erfolgreichen Belastungen wiederkehrender Spenden inklusive der ersten, z. B. 12Zahl oder Textfeld
Anzahl EinzelspendenAnzahl einmaliger Spenden, z. B. 3Zahl oder Textfeld
Datum der letzten SpendeDatum der neusten Spende, z. B. 2026-08-01Datum oder Textfeld
Betrag der letzten SpendeBetrag der neusten Spende, z. B. 50.00. Ein Textfeld erhält die Währung dazu, z. B. 50.00 CHF.Zahl oder Textfeld
Dauerspender (Ja/Nein)Ja, wenn eine aktive Dauerspende besteht, sonst NeinJa/Nein, Dropdown oder Textfeld

Telefonnummer und Postadresse überträgt Soulclick nicht.

Feldtypen in Mautic

In Mautic heissen die Feldtypen so:

Feldtyp in SoulclickFeldtyp in Mautic
TextfeldText
ZahlNumber
DatumDate
Datum/ZeitDate/Time
DropdownSelect
NachschlagefeldLookup
GebietsschemaLocale
Ja/NeinBoolean

Ein Attribut in mehrere Felder

Ein Attribut kannst du mehreren Feldern zuordnen, etwa die Anrede den Feldern Anrede DE, Anrede FR und Anrede IT, jedes mit eigenen Werte-Zuordnungen wie Frau, Madame und Signora. Soulclick schreibt jedes zugeordnete Feld bei jedem Kontakt. Umgekehrt nimmt jedes Feld nur ein Attribut auf.

Spendendaten

Spendendaten schreibt Soulclick nur, solange Spendendaten synchronisieren eingeschaltet ist. Schaltest du es aus, bleiben die bisherigen Werte und Tags in Mautic stehen.

  • Welche Spenden: Alle Spenden der Spendenkonten mit derselben E-Mail-Adresse. Testzahlungen zählen nicht.
  • Währung: Beträge stehen in der Basiswährung deiner Plattform, meist CHF.
  • Spendenband: Die Summe aller Spenden. Die untere Grenze gehört zum Band, genau 100 liegt also in 100-500.
  • Spendenband-Tags: Ordnest du einem Band einen Tag zu, setzt Soulclick nach jeder Spende den Tag des aktuellen Bands und entfernt die zugeordneten Tags der anderen Bänder. Andere Tags bleiben unverändert.
  • Anzahl Einzelspenden: Ein Multi-Checkout mit mehreren Spenden zählt einmal.
  • Anzahl wiederkehrende Spenden: Die erste Zahlung und jede erfolgreiche Folgezahlung. Folgezahlungen per QR-Rechnung zählen, sobald die Rechnung erstellt ist, nicht erst beim Zahlungseingang.
  • Spender-Tag: Mit einem Spender-Segment erhalten alle Spender:innen den Spender-Tag, auch wenn Spendendaten synchronisieren ausgeschaltet ist.
  • Dauerspender-Tag: Nur mit Spendendaten synchronisieren. Soulclick setzt ihn, solange eine Dauerspende aktiv ist, und entfernt ihn, sobald keine mehr aktiv ist.
  • Ohne Spenden: Hat ein Kontakt noch nie gespendet, lässt Soulclick alle Spendenfelder, den Spender-Tag und den Dauerspender-Tag aus.

Segmente und Abmeldungen

Soulclick nimmt einen Newsletter-Kontakt nur bei der ersten Synchronisation ins Newsletter-Segment auf und Spender:innen nur bei ihrer ersten Synchronisation ins Spender-Segment. Danach schreibt Soulclick das Segment nie wieder: Entfernst du einen Kontakt in Mautic aus dem Segment, bleibt er draussen. Soulclick selbst entfernt nie jemanden aus einem Segment.

Abmeldungen verwaltest du in Mautic. Den Status «Do Not Contact» ändert Soulclick nie: Eine abgemeldete Person bleibt abgemeldet, auch wenn Soulclick ihre Felder weiter aktualisiert.

Lösche abgemeldete Personen in Mautic nicht, sondern lass sie abgemeldet. Einen gelöschten Kontakt legt Soulclick beim nächsten Auslöser neu an und nimmt ihn wieder ins Segment auf.


Status und Fehler

Sync-Events

Unter Mautic → Sync-Events siehst du jeden Auslöser mit seinem Stand. Filtern kannst du nach Status und Auslöser, suchen nach der E-Mail-Adresse.

StatusBedeutung
WartendWird mit dem nächsten Durchgang verarbeitet
In VerarbeitungWird gerade übertragen
ZugestelltIn Mautic geschrieben
ÜbersprungenKein bestätigtes Newsletter-Opt-in oder keine erfolgreiche Spende, nichts übertragen
FehlgeschlagenWird automatisch wiederholt
Maximale Wiederholungen erreichtFünf Versuche gescheitert, keine weitere Wiederholung

Der Auslöser ist «Newsletter-Opt-in», «Spende», «Manuell erneut eingereiht» oder «Bestand übernommen», wenn Soulclick bestehende Kontakte übernommen hat.

Einen fehlgeschlagenen Auslöser wiederholt Soulclick nach 5 Minuten, 15 Minuten, 1 Stunde und 4 Stunden. In der Detailansicht zeigt Ergebnis, welche Felder, Tags und welches Segment geschrieben und welche Felder aus welchem Grund ausgelassen wurden. Mit der Aktion Ausgewählte Events erneut einreihen stösst du einen Auslöser von Hand erneut an.

Kontakte

Unter Kontakte siehst du, welche E-Mail-Adresse mit welchem Mautic-Kontakt verbunden ist (Mautic Kontakt-ID) und wann Soulclick das Segment geschrieben hat (Segment geschrieben am). Wer den Newsletter abonniert und spendet, steht hier zweimal, einmal mit der Newsletter Anmeldung und einmal als Spender:in, beide Male mit derselben Mautic Kontakt-ID.

Status der Zuordnungen

Die Spalte Status unter Zuordnungen vergleicht jede Zuordnung mit dem letzten Import:

StatusBedeutung
OKFeld, Segment oder Tag besteht unverändert
Immer synchronisiertStandardfeld, wird immer geschrieben
⚠ In Mautic gelöschtFehlt im letzten Import. Soulclick schreibt es nicht mehr.
⚠ In Mautic geändertTitel oder Typ haben sich geändert. Bei einem neuen Typ schreibt Soulclick das Feld nicht mehr.

Änderst du Felder, Segmente oder Tags in Mautic, klicke danach unter Importierte Objekte auf Jetzt aktualisieren und speichere die betroffene Zuordnung neu.

Verbindungsstörung

Lehnt Mautic die Zugangsdaten ab, etwa weil das Passwort geändert wurde, oder ist Mautic länger nicht erreichbar, zeigt der Verbindungsstatus unter Einstellungen «⚠ Verbindung gestört seit …». Soulclick benachrichtigt die Administrator:innen deiner Plattform und den Soulclick-Support per E-Mail, höchstens einmal pro Tag. Trage das neue Passwort unter Einstellungen ein: Wartende Synchronisationen holt Soulclick danach automatisch nach.


Fehlerbehebung

ProblemLösung
Kontakt fehlt in MauticPrüfe, ob die Person den Newsletter per Double Opt-in bestätigt hat. Spender:innen ohne Newsletter landen nur mit einem Spender-Segment in Mautic. Suche die Person unter Sync-Events.
Ein Feld bleibt leerPrüfe unter Zuordnungen die Spalten Status und Werte-Zuordnung. Das Ergebnis des Sync-Events nennt den Grund.
Ein Feld fehlt unter Importierte ObjekteVeröffentliche das Feld in Mautic und klicke auf Jetzt aktualisieren. Soulclick importiert nur veröffentlichte Felder.
Ein Feld ist nicht auswählbarDas Feld hat einen Typ, den das Attribut nicht annimmt, oder ist bereits zugeordnet. Der Hinweis unter dem Attribut nennt die passenden Typen.
Spendendaten fehlenSchalte Spendendaten synchronisieren ein. Die Werte kommen mit dem nächsten Auslöser des Kontakts.
Ein Betrag hat zu wenige DezimalstellenDas Zahlenfeld in Mautic braucht 2 Dezimalstellen.
Einstellungen: «Mautic hat die Zugangsdaten abgelehnt»Prüfe Benutzername und Passwort und ob in Mautic die API und HTTP Basic Auth eingeschaltet sind.
Einstellungen: «Mautic ist nicht erreichbar» oder «Unerwartete Antwort von Mautic»Prüfe die Mautic Basis-URL: die Adresse deiner Mautic-Instanz ohne /api.
Sync-Events fehlgeschlagen, Letzter Fehler mit HTTP 403Der Rolle des API-Benutzers fehlt ein Recht zum Erstellen oder Bearbeiten, siehe Schritt 1.
Sync-Events bleiben «Wartend» und zeigen keinen FehlerDer Rolle des API-Benutzers fehlt ein Recht zum Ansehen von Kontaktfeldern, Segmenten oder Tags, siehe Schritt 1. Klicke unter Importierte Objekte auf Jetzt aktualisieren: Die Meldung nennt die Antwort von Mautic.
Ein gelöschter Kontakt ist wieder daSoulclick legt ihn beim nächsten Auslöser neu an. Melde Personen in Mautic ab, statt sie zu löschen. Eine Newsletter-Anmeldung kannst du in Soulclick löschen, Spender:innen nicht: Mit einem Spender-Segment legt ihre nächste Spende den Kontakt wieder an.

Did this page help you?