Die ActiveCampaign-Integration hält deine Newsletter-Kontakte in deinem ActiveCampaign-Konto aktuell. Neben Name und E-Mail überträgt sie Profildaten und auf Wunsch Spendendaten, mit denen du in ActiveCampaign Segmente und Automationen aufbaust.

---

Überblick

Aus ActiveCampaign liest Soulclick nur Felder, Listen und Tags. Kontaktdaten fliessen nie zurück.

---

So funktioniert die Synchronisation

• Du bestimmst, was geschrieben wird: Soulclick legt in deinem Konto keine Felder an. Du importierst deine Felder und Listen und ordnest ihnen die Soulclick-Attribute zu. Nur zugeordnete Attribute werden geschrieben.
• Nur mit Opt-in: Übertragen werden nur Personen, die den Newsletter per Double Opt-in bestätigt haben. Wer nur spendet, landet nicht in ActiveCampaign.
• Auslöser: Die Bestätigung des Newsletters und jede bezahlte Spende, auch jede Folgezahlung 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 ActiveCampaign an diesen Feldern gehen dabei verloren, ausser bei festen Texten. Leere Werte sendet Soulclick nie.
• Bestehende Kontakte: Gibt es die E-Mail-Adresse in ActiveCampaign schon, aktualisiert Soulclick diesen Kontakt.
• Kein Nachladen: Wer den Newsletter vor der Aktivierung bestätigt hat, kommt beim nächsten Auslöser dazu, zum Beispiel mit der nächsten Spende.

---

Einrichtung

Schritt 1: Zugangsdaten hinterlegen

1. Kopiere in ActiveCampaign unter Einstellungen → Entwickler die API-URL und den API-Schlüssel.
2. Öffne in Soulclick ActiveCampaign → Zuordnungen & Einstellungen → Einstellungen, trage beides ein und speichere.

Beim Speichern prüft Soulclick die Zugangsdaten bei ActiveCampaign. Lehnt ActiveCampaign den API-Schlüssel ab, wird nichts gespeichert.

Schritt 2: Felder und Listen importieren

Öffne Importierte Objekte und klicke auf Jetzt aktualisieren. Soulclick lädt alle Felder, Listen und Tags deines Kontos. Die Reiter Felder, Listen und Tags zeigen sie mit Titel, Feldtyp und ID.

Lege neue Felder zuerst in ActiveCampaign an und aktualisiere danach die Liste. Tags siehst du hier, synchronisiert werden sie nicht.

Schritt 3: Felder zuordnen

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

Automatisch zuordnen: Der Button oben rechts ordnet jedes noch freie Attribut dem Feld zu, das genau den empfohlenen Titel trägt, siehe Attribute. Gross- und Kleinschreibung spielt keine Rolle. Bestehende Zuordnungen bleiben unverändert. Tragen mehrere Felder denselben Titel, ordnest du selbst zu.

Von Hand: Klicke auf Zuordnung hinzufügen, wähle das Soulclick Attribut und das ActiveCampaign Objekt und speichere. Unter dem Attribut steht, was es enthält und welchen Feldtyp es in ActiveCampaign braucht. Felder mit unpassendem Typ und bereits vergebene Felder sind ausgegraut.

Schritt 4: Newsletter-Liste zuordnen

Ordne dem Attribut Newsletter-Liste die Liste zu, auf die Soulclick deine Newsletter-Kontakte setzt. Diese Zuordnung machst du immer von Hand, die automatische Zuordnung lässt sie aus. Es gibt genau eine Newsletter-Liste.

Schritt 5: Werte zuordnen

Anrede, Sprache, Spendertyp, Spendenband und Dauerspender haben feste Werte. Ordnest du eines dieser Attribute einem Dropdown- oder Radio-Button-Feld zu, legst du nach dem Speichern unter Werte-Zuordnungen fest, welche Option in ActiveCampaign zu welchem Soulclick-Wert gehört, 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 Textfeldern entfällt dieser Schritt: Sie erhalten den Wert als Text, die Anrede als Herr oder Frau.

---

Attribute

Telefonnummer und Postadresse überträgt Soulclick nicht.

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.

Feste Texte

Mit dem Attribut Fester Text schreibst du einen eigenen Text in ein Feld, zum Beispiel «Spendenplattform» oder eine URL in ein Feld für die Quelle des Kontakts. Den Text erfasst du im Feld Fester Text, höchstens 255 Zeichen.

• Soulclick schreibt den Text einmal pro Kontakt und nur, wenn das Feld in ActiveCampaign leer ist. Ein vorhandener Wert bleibt stehen.
• Leerst du das Feld später in ActiveCampaign, füllt Soulclick es nicht wieder.
• Änderst du den Text, gilt der neue Text nur für Kontakte, die Soulclick für dieses Feld noch nicht bearbeitet hat.
• Du kannst mehrere feste Texte anlegen, jeden in einem eigenen Feld. Die automatische Zuordnung legt keine an.

Spendendaten

Spendendaten schreibt Soulclick nur, solange Spendendaten synchronisieren eingeschaltet ist. Schaltest du es aus, bleiben die bisherigen Werte in ActiveCampaign 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.
• 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.
• Ohne Spenden: Hat ein Kontakt noch nie gespendet, lässt Soulclick alle Spendenfelder aus.

Newsletter-Liste und Abmeldungen

Soulclick setzt einen Kontakt nur bei der ersten Synchronisation auf die Newsletter-Liste. Steht der Kontakt schon auf der Liste, auch als abgemeldet, lässt Soulclick die Liste unverändert. Eine Abmeldung in ActiveCampaign überschreibt Soulclick nie, Abmeldungen verwaltest du deshalb in ActiveCampaign.

---

Status und Fehler

Sync-Events

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

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

Unter Kontakte siehst du, welche E-Mail-Adresse mit welchem ActiveCampaign-Kontakt verbunden ist und wann Soulclick die Newsletter-Liste geschrieben hat.

Status der Zuordnungen

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

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

Verbindungsstörung

Lehnt ActiveCampaign den API-Schlüssel ab, etwa weil er erneuert wurde, oder ist das Konto länger nicht erreichbar, zeigt der Verbindungsstatus unter Einstellungen «⚠ Verbindung gestört seit …». Soulclick benachrichtigt die Superuser deiner Plattform und den Soulclick-Support per E-Mail, höchstens einmal pro Stunde. Trage den neuen API-Schlüssel unter Einstellungen ein: Ausstehende Synchronisationen holt Soulclick danach automatisch nach.

---

Fehlerbehebung