Agillic verbinden

Mit der Agillic-Integration wird jede Person, die sich anmeldet, in Agillic als Empfänger angelegt oder aktualisiert. Agillic nutzt hier keine Listen: Empfänger werden Ihren Agillic-Daten hinzugefügt, und Ihre Zielgruppen bauen Sie in Agillic.

Was Sie brauchen

• Ein Agillic-Konto auf der europäischen Plattform von Agillic und einen Benutzer, der API-Schlüssel erstellen darf (meist ein Administrator).

Schritt 1: Einen API-Schlüssel in Agillic erstellen

1. Öffnen Sie in Agillic die Settings und suchen Sie die API-Schlüssel (API credentials).
2. Erstellen Sie einen neuen Schlüssel und geben Sie ihm einen Namen, den Sie wiedererkennen, zum Beispiel „Scratcher“.
3. Kopieren Sie den Developer key (auch API-Schlüssel genannt) und das Secret. Das Secret wird nur einmal angezeigt.

Berechtigungen, die der Schlüssel braucht

Scratcher nutzt den Schlüssel, um Ihre Personendatenfelder zu lesen, Empfänger per E-Mail zu finden sowie Empfänger anzulegen und zu aktualisieren. Wenn Agillic Ihnen erlaubt, den Schlüssel einzuschränken, braucht er Lese- und Schreibzugriff auf Empfänger und Lesezugriff auf Personendaten. Weiterer Zugriff ist nicht nötig.

Schritt 2: Agillic mit Scratcher verbinden

1. Gehen Sie in Scratcher zu Einstellungen > Integrationen und klicken Sie auf Agillic.
2. Fügen Sie den Developer key und das Secret ein.
3. Klicken Sie auf Integration installieren. Scratcher meldet sich bei Agillic an, um die Angaben zu prüfen.

Schritt 3: In einer Kampagne aktivieren

1. Gehen Sie im Editor zu Verbinden > Integrationen > Agillic und klicken Sie auf Aktivieren.
2. Wenn Sie mehr als ein Konto verbunden haben, wählen Sie es unter Konto auswählen.
3. Ordnen Sie unter Feldzuordnungen jedes Scratcher-Feld einem Personendatenfeld in Agillic zu.
4. Wählen Sie unter Eindeutiges E-Mail-Feld das Agillic-Feld, das Sie für die E-Mail verwenden: „Wählen Sie das Feld in Agillic, das Sie für die E-Mail verwenden (stellen Sie sicher, dass es auch in Agillic eindeutig ist)“. Nur eindeutige Textfelder werden aufgeführt. Lassen Sie es leer, nutzt Scratcher das Feld EMAIL.
5. Wählen Sie unter Nach Einwilligungen filtern (optional) Ihre Checkbox für die Marketing-Einwilligung, damit nur Menschen gesendet werden, die zugestimmt haben.
6. Klicken Sie auf Speichern und dann auf Testen.

Gut zu wissen: Bei Agillic gibt es keine Liste zu wählen. Scratcher beginnt also zu senden, sobald Sie auf Aktivieren klicken. Aktivieren Sie die Integration, bevor die Kampagne live geht, oder richten Sie sie sofort vollständig ein.

Feldzuordnung

• Die E-Mail-Adresse wird immer an das eindeutige E-Mail-Feld gesendet. Sie müssen sie nicht zuordnen.
• Die Feldliste zeigt Ihre Agillic-Personendaten mit ihren Typen. Datumsangaben werden im Format von Agillic gesendet, zum Beispiel 31.12.2025.
• Wenn Sie ein Personendatenfeld für das Opt-in haben, ordnen Sie ihm das Feld Angenommen einer Einwilligung zu.

Was wann gesendet wird

Scratcher sucht den Empfänger anhand der E-Mail. Gibt es ihn nicht, wird er angelegt, sonst wird er aktualisiert. Neue Anmeldungen werden innerhalb von ein, zwei Minuten gesendet, bestehende Leads beim Aktivieren. Unter Einstellungen > Integrationen > Zustellstatus sehen Sie, ob jeder Lead in Agillic neu war oder schon existierte.

Fehlerbehebung

• „Agillic API request failed with status code ...“: Agillic hat die Anfrage nicht angenommen. 401 oder 403 bedeutet, dass der Schlüssel gelöscht wurde oder ihm Zugriff fehlt; verbinden Sie einen neuen Schlüssel.
• Eine Meldung von Agillic zu einem Feld: Ein Wert passt nicht zum Feldtyp, oder ein Pflichtfeld fehlt. Prüfen Sie die Zuordnungen.