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.
Überblick
| Daten | Richtung | Beschreibung |
|---|---|---|
| Kontakte | Soulclick → Mautic | Alle Newsletter-Abonnements mit bestätigtem Double Opt-in, mit E-Mail, Vorname und Nachname. Mit einem Spender-Segment auch alle Spender:innen. |
| Profildaten | Soulclick → Mautic | Anrede, Sprache, Spendertyp, Firma und Datum des Opt-ins |
| Spendendaten | Soulclick → Mautic | Spendenband, Anzahl Spenden, letzte Spende und Dauerspende (optional) |
| Segmente | Soulclick → Mautic | Einmalige Aufnahme in ein Newsletter-Segment und optional in ein Spender-Segment |
| Tags | Soulclick → Mautic | Newsletter-Tag, Spender-Tag, Dauerspender-Tag und ein Tag pro Spendenband |
| Kontaktfelder, Segmente und Tags | Mautic → Soulclick | Werden 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:
- API einschalten: Aktiviere unter Configuration → API Settings die Optionen «API enabled?» und «Enable HTTP basic auth?».
- 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.
- E-Mail als Erkennungsmerkmal: Das Kontaktfeld Email muss das eindeutige Merkmal (Unique Identifier) deiner Kontakte sein. So ist Mautic voreingestellt.
- 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.
- 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.
- 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:
| Bereich | Rechte |
|---|---|
| Kontakte | Ansehen, Erstellen und Bearbeiten |
| Segmente | Ansehen und Bearbeiten |
| Kontaktfelder | Ansehen |
| Tags | Ansehen |
Schritt 2: Zugangsdaten hinterlegen
Öffne in Soulclick Mautic → Zuordnungen & Einstellungen → Einstellungen, trage die Zugangsdaten ein und speichere.
| Feld | Beschreibung |
|---|---|
| Mautic Basis-URL | Adresse deiner Mautic-Instanz ohne /api, z. B. https://mautic.example.ch |
| Benutzername | Der API-Benutzer aus Schritt 1 |
| Passwort | Das 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 Attribut | Wer 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 Attribut | Inhalt | Feldtyp in Mautic |
|---|---|---|
| Newsletter-Segment (Kontakte mit bestätigtem Newsletter-Opt-in) | Newsletter-Kontakte, einmalig ins Segment aufgenommen | Segment |
| 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-Kontakte | Tag |
| Spender-Tag (Kontakte mit mindestens einer Spende) | Für alle Spender:innen, siehe Spendendaten | Tag |
| Dauerspender-Tag (Kontakte mit aktiver wiederkehrender Spende) | Solange eine Dauerspende aktiv ist, siehe Spendendaten | Tag |
| Spendenband-Tag 0-100 … 5000+ | Ein Tag pro Spendenband, siehe Spendendaten | Tag |
| 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 en | Gebietsschema, Dropdown oder Textfeld |
| Spendertyp (Privat/Geschäft) | Privat oder Geschäft | Dropdown oder Textfeld |
| Firma | Firmenname, z. B. Muster AG | Textfeld |
| Datum des Newsletter-Opt-ins | Datum 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 Spenden | Alle erfolgreichen Belastungen wiederkehrender Spenden inklusive der ersten, z. B. 12 | Zahl oder Textfeld |
| Anzahl Einzelspenden | Anzahl einmaliger Spenden, z. B. 3 | Zahl oder Textfeld |
| Datum der letzten Spende | Datum der neusten Spende, z. B. 2026-08-01 | Datum oder Textfeld |
| Betrag der letzten Spende | Betrag 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 Nein | Ja/Nein, Dropdown oder Textfeld |
Telefonnummer und Postadresse überträgt Soulclick nicht.
Feldtypen in Mautic
In Mautic heissen die Feldtypen so:
| Feldtyp in Soulclick | Feldtyp in Mautic |
|---|---|
| Textfeld | Text |
| Zahl | Number |
| Datum | Date |
| Datum/Zeit | Date/Time |
| Dropdown | Select |
| Nachschlagefeld | Lookup |
| Gebietsschema | Locale |
| Ja/Nein | Boolean |
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.
| Status | Bedeutung |
|---|---|
| Wartend | Wird mit dem nächsten Durchgang verarbeitet |
| In Verarbeitung | Wird gerade übertragen |
| Zugestellt | In Mautic geschrieben |
| Übersprungen | Kein bestätigtes Newsletter-Opt-in oder keine erfolgreiche Spende, nichts übertragen |
| Fehlgeschlagen | Wird automatisch wiederholt |
| Maximale Wiederholungen erreicht | Fü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:
| Status | Bedeutung |
|---|---|
| OK | Feld, Segment oder Tag besteht unverändert |
| Immer synchronisiert | Standardfeld, wird immer geschrieben |
| ⚠ In Mautic gelöscht | Fehlt im letzten Import. Soulclick schreibt es nicht mehr. |
| ⚠ In Mautic geändert | Titel 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
| Problem | Lösung |
|---|---|
| Kontakt fehlt in Mautic | Prü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 leer | Prüfe unter Zuordnungen die Spalten Status und Werte-Zuordnung. Das Ergebnis des Sync-Events nennt den Grund. |
| Ein Feld fehlt unter Importierte Objekte | Veröffentliche das Feld in Mautic und klicke auf Jetzt aktualisieren. Soulclick importiert nur veröffentlichte Felder. |
| Ein Feld ist nicht auswählbar | Das Feld hat einen Typ, den das Attribut nicht annimmt, oder ist bereits zugeordnet. Der Hinweis unter dem Attribut nennt die passenden Typen. |
| Spendendaten fehlen | Schalte Spendendaten synchronisieren ein. Die Werte kommen mit dem nächsten Auslöser des Kontakts. |
| Ein Betrag hat zu wenige Dezimalstellen | Das 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 403 | Der Rolle des API-Benutzers fehlt ein Recht zum Erstellen oder Bearbeiten, siehe Schritt 1. |
| Sync-Events bleiben «Wartend» und zeigen keinen Fehler | Der 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 da | Soulclick 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. |
Updated 10 days ago
