Beliebige Systeme an twingle anbinden (API, Webhook, Middleware)

    Für viele Systeme gibt es eine fertige Anbindung in twingle, zum Beispiel für CiviCRM, Brevo oder Mailchimp. Für alle anderen Systeme, etwa Newsletter-Tools wie Listmonk oder MailPoet oder eine eigene Datenbank, gibt es drei Wege: den Webhook, die twingleAPI und eine Middleware. Hier erfährst du, welcher Weg wofür passt und wie du vorgehst.

    Welcher Weg passt?

    • Webhook: twingle sendet nach jeder neuen oder geänderten Zahlung alle Daten an eine URL, die du angibst. Das passt, wenn dein System neue Zahlungen sofort übernehmen soll.
    • twingleAPI: Dein System ruft Daten bei twingle ab oder ändert sie. Das passt für einen regelmäßigen Abgleich, für Auswertungen und wenn du Daten oder Einstellungen in twingle automatisiert ändern willst.
    • Middleware (z. B. n8n, Zapier, make.com): Ein Werkzeug dazwischen nimmt den Webhook von twingle an und gibt die Daten an dein System weiter. Das passt, wenn dein System keinen Webhook annehmen kann, mehrere Systeme die Daten bekommen sollen oder die Daten umgebaut werden müssen.

    Anbindung über den Webhook

    1. Lege in deinem System oder in der Middleware eine URL an, die Daten per POST im JSON-Format annimmt.
    2. Logge dich im twingleMANAGER ein und öffne Organisationseinstellungen / Allgemein. Trage die URL im Bereich "CRM: Salesforce / Webhook" ein.
    3. Aktiviere in jedem Projekt, dessen Zahlungen übertragen werden sollen, die Option "Neue und geänderte Spenden an Webhook übertragen".
    4. Führe eine Testzahlung durch und prüfe, ob die Daten in deinem System ankommen.

    Eine Anleitung mit allen Optionen (Secret für die Signatur, Verzögerung, Authentifizierung) steht in Kann ich einen externen Webhook (für Salesforce) anbinden?. Welche Felder twingle überträgt, steht in Documentation for webhook payload.


    Hinweise:

    • Pro Organisation kann eine Webhook-URL hinterlegt werden.
    • Der Webhook überträgt nur Zahlungen ab der Aktivierung, keine historischen Daten.
    • Eine Zahlung kann mehrfach ankommen, wenn sie sich ändert, zum Beispiel wenn Kontaktdaten ergänzt werden. Lege sie in deinem System nicht doppelt an, sondern erkenne sie an der trx_id und aktualisiere sie. Ob es ein Update ist, steht im Header X-Twingle-Isupdate.
    • Dein System sollte mit dem HTTP-Status 200, 201 oder 202 antworten.

    Anbindung über die twingleAPI

    • Logge dich im twingleMANAGER ein, öffne Einstellungen / Logins & API-Keys und erstelle einen API-Key mit den nötigen Berechtigungen. Details stehen in Verwaltung von API-Keys.
    • Die API ist eine REST-Schnittstelle. Den API-Key sendest du bei jedem Request im Header x-access-code.
    • Jedes API-Modul hat seine eigene Basis-URL. Die technische Dokumentation bekommst du vom twingle Support, mehr dazu in API-Nutzung und Entwickler-Zugriff.

    Beispiel: Newsletter-System ohne fertige Anbindung

    Für Newsletter-Systeme wie Listmonk oder MailPoet gibt es keine direkte Schnittstelle. Mit dem Webhook funktioniert es trotzdem:

    • Der Webhook enthält das Feld newsletter (true, wenn die Person den Newsletter möchte), die E-Mail-Adresse in user_email sowie Vor- und Nachname.
    • Dein System oder die Middleware trägt Personen mit newsletter = true in die Liste ein.
    • Nutzt du das Double-Opt-In von twingle, steht im Feld user_double_opt_in_date das Datum der Bestätigung. So kannst du nur bestätigte Anmeldungen übernehmen. Mehr dazu in Double-Opt-In (DOI) für Newsletteranmeldungen.

    Weitere Informationen

    Veröffentlicht:
    API-Nutzung und Entwickler-Zugriff
    Einrichten eines Spendenterminals