Contao mit KlickTipp verbinden

[fenepedia/contao-klicktipp-gateway]

Mit dieser Erweiterung für Contao kannst du deine Kontakte von KlickTipp aktualisieren. Die Extension stellt dazu einen eigenen Gateway für das Notification Center bereit.

Aktueller Funktionsumfang

  • Hinzufügen neuer Kontakte zu KlickTipp
  • Aktualisierung bestehender Kontakte in der ContactCloud
  • Hinzufügen von Tags bei bestehenden Kontakten

Weitere Funktionen sind für zukünftige Versionen geplant. Du kannst die Weiterentwicklung gerne unterstützen. Hier findest du die Erweiterung bei GitHub.

Voraussetzungen

So setzt du die Erweiterung ein

1. Installation

Die Erweiterung kann kostenlos über den Contao Manager installiert werden.
Suche dazu nach der Erweiterung „fenepedia/contao-klicktipp-gateway“.

2. Neues Gateway anlegen

  1. Im Contao Backend anmelden
  2. Notification Center > Gateways > Neues Gateway
    • Titel: Name kann frei vergeben werden
    • Typ: KlickTipp API
    • Benutzername und Passwort von KlickTipp eintragen

Tipp: Bei KlickTipp Enterprise kannst du einen zusätzlichen Benutzer mit speziellen API-Rechten anlegen.

3. Neue Benachrichtigung erstellen

Notification Center > Benachrichtigungen > Neue Benachrichtigung

4. Aktion konfigurieren

Bei der soeben erzeugten Benachrichtigung muss nun eine "neue Nachricht" erstellt werden. Hier findet dann die Zuordnung der Felder von Contao und KlickTipp statt.

4.1 Subscriber erstellen

  • Feld für E-Mail-Adresse festlegen
  • Double-Opt-In ID eintragen
    (leer = Default-Opt-In-Prozeess)
  • Tag (optional)
    Unterstützt wird die eindeutige Tag-ID (empfohlen) und der Tag-Name
  • Zuordnung Contao Feldnamen mit KlickTipp Feldern
    • Wert = Contao Feld (##form_fieldname##)
    • Schlüssel = KlickTipp API-Feldnamen

Hinweis: Sollte der Kontakt bereits in der ContactCloud vorhanden sein, werden die Daten aktualisiert.

4.2 Subscriber Update

Unterschied zur Subscriber-Aktion ist, dass der Kontakt nur aktualisiert wird, wenn dieser vorhanden ist. Sollte der Kontakt nicht vorhanden sein, wird nichts gemacht.

  • Feld für E-Mail-Adresse festlegen
  • Zuordnung Contao Feldnamen mit KlickTipp Feldern
    • Wert = Contao Feld (##form_fieldname##)
    • Schlüssel = KlickTipp API-Feldnamen

4.3 Tag hinzufügen

  • Feld für E-Mail-Adresse festlegen
  • Tag vergeben oder dynamisch aus Formularfeld auslesen
    Unterstützt wird die eindeutige Tag-ID (empfohlen) und der Tag-Name

Es können auch mehrere Aktionen pro Nachricht erstellt werden. So kann z.B. ein Update der Daten und gleichzeitig auch ein zusätzlicher Tag vergeben werden.