Der Visuelle Automatisierungs-Builder verwandelt Charitable Automation Connect in eine Vollbild-Canvas zum Ziehen und Verbinden, auf der Sie jede Automatisierung als Fluss verbundener Karten sehen können: ein Trigger, optionale Bedingungen und eine oder mehrere Aktionen, die nacheinander ausgeführt werden. Anstatt einen einzelnen Webhook in einem Formular zu konfigurieren, erstellen Sie jetzt eine kleine Pipeline, die ausgelöst wird, wenn in Charitable etwas passiert, prüft, ob Ihre Regeln übereinstimmen, und dann jede von Ihnen hinzugefügte Aktion ausführt.

Verfügbar in Charitable Automation Connect 2.3.0 und neuer.

Hauptmerkmale

• Automatisierungen visuell auf einer Vollbild-Canvas erstellen, die dem Charitable Campaign Builder entspricht.
• Mehrere Aktionen pro Automatisierung nacheinander aus einem einzigen Trigger ausführen.
• Spender automatisch in Charitable mit der neuen Aktion "Spender markieren" markieren, kein externer Dienst erforderlich.
• Webhooks an Zapier, Make, n8n, Pabbly Connect oder jeden Endpunkt senden, der einen HTTP POST akzeptiert.
• Jede Automatisierung mit Bedingungsgruppen, die ALLEN oder EINIGEN Ihrer Regeln entsprechen, steuern.
• Automatisierung auf Spender anwenden, die bereits existieren, mit der Nachfüllfunktion "Auf bestehende Spender anwenden".
• Frei zwischen dem einfachen Formular-Editor und dem Canvas-Builder wechseln, beide bearbeiten dieselbe Automatisierung.
• Wählen Sie aus 21 Trigger-Ereignissen für Spenden, Spender, wiederkehrende Spenden und Kampagnen.
• Testen und debuggen Sie jeden Webhook inline, bevor er bei einer echten Spende ausgeführt wird.

Warum den Visuellen Automatisierungs-Builder verwenden?

Vor Version 2.3.0 war jede Automatisierung ein einzelner Webhook, der bei einem einzelnen Ereignis ausgelöst wurde. Echte Fundraising-Workflows sind selten so einfach. Oft möchten Sie, dass ein Ereignis mehrere Dinge gleichzeitig tut, z. B. den Spender markieren, Ihr Team in Slack benachrichtigen und den Datensatz an Ihr CRM übertragen. Der Visuelle Automatisierungs-Builder ermöglicht es Ihnen, diesen gesamten Ablauf auf einem Bildschirm zu sehen und zu verwalten, so viele Aktionen hinzuzufügen, wie Sie benötigen, und genau zu bestätigen, was ausgeführt wird, bevor es live geht. Er bringt die Klarheit eines visuellen Workflow-Tools in Ihre Spendenautomatisierungen, ohne dass Sie Code schreiben müssen.

Sehen Sie es in Aktion

Voraussetzungen

• Charitable Automation Connect 2.3.0 oder neuer
• Ein aktiver Charitable Pro-Plan, der Automation Connect beinhaltet (Lieferung wird bei unzureichender oder abgelaufener Lizenz blockiert)
• WordPress 6.2 oder neuer
• Action Scheduler (in Charitable enthalten) für die Hintergrundlieferung von Webhooks

Erste Schritte

Wo Sie ihn finden

1. Gehen Sie in Ihrem WordPress-Admin zu Charitable > Automatisierungen.
2. Die Liste der Automatisierungen zeigt jede Automatisierung, ihren Trigger, ihren Status und die letzte Lieferung an.
3. Klicken Sie auf Hinzufügen, um eine neue Automatisierung zu erstellen, oder klicken Sie auf eine vorhandene, um sie zu bearbeiten.

Neue und vorlagenbasierte Automatisierungen werden standardmäßig im Canvas-Builder geöffnet. Vorhandene Automatisierungen werden in der Ansicht geöffnet, die zu ihnen passt, mit einer Schaltfläche zum Wechseln.

Die beiden Editoren: Einfach und Canvas

Jede Automatisierung kann in einer von zwei Ansichten geöffnet werden. Beide bearbeiten dieselbe zugrunde liegende Automatisierung, und Sie können jederzeit zwischen ihnen wechseln.

Einfach

Die klassische Form, eingebettet in die normale WordPress-Verwaltung. Sie ist ideal für schnelle Bearbeitungen: Wählen Sie einen Auslöser, legen Sie Bedingungen fest und konfigurieren Sie eine einzelne Zustellung. Verwenden Sie den Link Canvas View, um dieselbe Automatisierung im visuellen Builder zu öffnen.

Canvas

Der bildschirmfüllende visuelle Builder. Er übernimmt den Bildschirm, genau wie der Kampagnen-Builder, und zeigt:

• Eine obere Leiste mit dem Charitable-Logo, einem Live-Automatisierungs-Namen-Feld, einer Speichern-Schaltfläche und einer Statuskontrolle.
• Ein Einfache Ansicht-Link, der zum eingebetteten Editor zurückkehrt. Wenn Sie ungespeicherte Änderungen haben, werden Sie aufgefordert, zuerst zu speichern.
• Eine linke Konfigurationsspalte mit vier Tabs: Auslöser, Bedingungen, Aktion und Info.
• Die Canvas selbst: Auslöser-, Bedingungen- und Aktionskarten, die durch Verbindungslinien verbunden sind, mit einer Aktion hinzufügen-Schaltfläche, Zoom-Steuerelementen, Einrasten am Gitter und einer Minimap. Die Linie vom Auslöser zu den Bedingungen animiert, um die Flussrichtung anzuzeigen.

Erstellen einer Automatisierung

1. Wählen Sie einen Auslöser. Auf der Registerkarte Auslöser wählen Sie das Ereignis, das die Automatisierung startet, z. B. Spende erstellt oder wiederkehrende Spenden-Zahlung erfolgt.
2. Bedingungen hinzufügen (optional). Erstellen Sie auf der Registerkarte Bedingungen eine oder mehrere Regelgruppen. Lassen Sie sie leer, um immer auszuführen.
3. Aktionen hinzufügen. Klicken Sie auf Aktion hinzufügen, um die Aktionspalette zu öffnen, und wählen Sie dann Webhook oder Spender markieren. Jede von Ihnen hinzugefügte Aktion erscheint als neue Karte im Fluss. Aktionen werden von oben nach unten ausgeführt.
4. Konfigurieren Sie jede Aktion. Wählen Sie eine Aktionskarte aus und verwenden Sie dann die Registerkarte Aktion, um ihre Optionen festzulegen.
5. Neu anordnen, falls erforderlich. Ziehen Sie Aktionen, um die Reihenfolge zu ändern, in der sie ausgeführt werden.
6. Speichern. Klicken Sie auf Speichern. Die Schaltfläche bestätigt inline, wenn Ihre Änderungen gespeichert wurden.

Auslöserereignisse

Automation Connect 2.3.0 liefert 21 Auslöserereignisse, die den Spendenlebenszyklus, Spender, wiederkehrende Spenden und Kampagnen umfassen. Beispiele sind:

• Spende erstellt
• Spende abgeschlossen
• Spender erstellt (Erste Spende)
• Wiederkehrende Spenden-Zahlung erfolgt
• Kampagnenziel erreicht

Die Auslöserauswahl listet alle Ereignisse in Großbuchstaben auf. Jedes Ereignis zeigt Hilfetext an, der beschreibt, wann es ausgelöst wird.

Bedingungen

Bedingungen sind optional. Erstellen Sie eine oder mehrere Regelgruppen und wählen Sie, ob eine Automatisierung ausgeführt wird, wenn sie ALLE oder IRGENDEINE der Regeln in einer Gruppe erfüllt. Lassen Sie die Bedingungen leer, um immer auszuführen. Der Bedingungs-Builder spiegelt das Styling der bedingten Logik des Kampagnen-Builders wider, sodass die Erfahrung vertraut ist.

Aktionen

Eine Automatisierung führt eine geordnete Liste von Aktionen aus, wenn ihr Auslöser ausgelöst wird und ihre Bedingungen erfüllt sind. Version 2.3.0 liefert zwei Aktionstypen.

Webhook

Sendet die Event-Daten als HTTP POST an eine beliebige URL. So verbinden Sie Charitable mit Zapier, Make, n8n, Pabbly Connect und anderen Tools.

Option	Typ	Standard	Beschreibung
Zustellungs-URL	Zeichenkette	(leer)	Erforderlich. Die URL, die den Webhook-POST empfängt. Muss mit https:// beginnen.
Zustellungsmodus	Auswahl	Asynchron	Asynchron stellt die Anfrage im Hintergrund in eine Warteschlange, um die Leistung zu verbessern.
Inhaltstyp	Auswahl	JSON	JSON (application/json) für Zapier, Make und die meisten modernen Tools oder Formular-kodiert (application/x-www-form-urlencoded) für Endpunkte, die es erwarten.
Geheimnis	Zeichenkette	automatisch generiert	Optional. Wird zum Signieren von Webhook-Payloads verwendet. Leer lassen, um automatisch zu generieren.
Benutzerdefinierte Header	Liste	(leer)	Optionale Anfrage-Header wie ein API-Schlüssel oder ein Bearer-Token. Die Content-Type- und Signatur-Header werden automatisch verwaltet und können nicht überschrieben werden.
Payload	Felder	Alle Felder	Wählen Sie aus, welche Felder einbezogen werden sollen, und ziehen Sie sie per Drag & Drop, um die Reihenfolge zu ändern. Die Payload-Bearbeitung ist im einfachen Modus verfügbar.

Webhook-Zustellung läuft standardmäßig im Hintergrund. Webhooks werden nicht während der Rückverfüllung angewendet.

Spender markieren

Die erste Aktion, die innerhalb von Charitable selbst ausgeführt wird, ohne dass ein externer Dienst benötigt wird. Sie ändert die Tags eines Spenders, wenn die Automatisierung ausgeführt wird.

Option	Typ	Standard	Beschreibung
Modus	Auswahl	Tag hinzufügen	Tag hinzufügen (bestehende Tags beibehalten), Tag entfernen oder Gruppe ersetzen (befördern oder herabstufen innerhalb einer benannten Tag-Gruppe).
Gruppe	Zeichenkette	(leer)	Wird nur verwendet, wenn der Modus 'Gruppe ersetzen' ist. Die Tag-Gruppe, innerhalb derer getauscht werden soll.
Schlagwörter	Liste	(leer)	Erforderlich. Das oder die anzuwendenden Tags. Tags werden automatisch erstellt, wenn sie nicht existieren.

Da 'Spender markieren' innerhalb von Charitable schreibt, kann es durch Rückverfüllung auf bestehende Spender angewendet werden.

Auf bestehende Spender anwenden (Rückverfüllung)

Für Automatisierungen, deren Aktionen dies unterstützen, wie z. B. 'Spender markieren', schätzt eine Steuerung Auf bestehende Spender anwenden, wie viele Spender betroffen wären, bittet um Bestätigung und verarbeitet sie dann im Hintergrund. Nur Aktionen innerhalb von WordPress werden während einer Rückverfüllung ausgeführt. Webhook-Aktionen werden übersprungen, da vergangene Spenden nicht in Echtzeit erfolgten.

Testen und Debuggen

Auf der Registerkarte 'Test' einer Webhook-Aktion verwenden Sie Test-Payload senden, um einen Webhook zu senden und die Antwort inline anzuzeigen. Sie können mit Beispieldaten oder mit einem echten Datensatz testen, um genau zu sehen, was eine Live-Zustellung senden wird. Der Test umgeht die asynchrone Zustellung, sodass Sie das Ergebnis sofort erhalten. Sobald eine Automatisierung gespeichert ist, helfen Ihnen die Zustellungsverlauf und eine Steuerung zum erneuten Senden bei der Diagnose von Fehlern.

Kompatibilität

Automatisierungen, die vor 2.3.0 erstellt wurden, funktionieren unverändert weiter. Eine einzelne Legacy-Webhook-Automatisierung wird als Automatisierung mit einer einzigen Webhook-Aktion behandelt, sodass bestehende Zustellungen und Zaps weiterhin genau wie zuvor ausgelöst werden. Kein Migrationsschritt Ihrerseits erforderlich.

Fehlerbehebung

Die Verbindungslinien zwischen den Karten fehlen

Dies wurde in 2.3.0 behoben. Wenn Sie die aktuelle Version verwenden und die Linien immer noch nicht sehen, laden Sie den Builder neu. Die Flusslinien werden automatisch gezeichnet, wenn die Leinwand geöffnet wird.

Eine Automatisierung wird nicht ausgelöst

Stellen Sie sicher, dass der Status der Automatisierung aktiv und nicht pausiert oder deaktiviert ist. Nur aktive Automatisierungen werden versendet. Bestätigen Sie außerdem, dass Ihre Charitable Pro-Lizenz aktiv und nicht abgelaufen ist, da die Zustellung bei einem unzureichenden oder abgelaufenen Plan blockiert wird.

Webhooks werden in die Warteschlange gestellt, aber nie gesendet

Webhooks werden standardmäßig im Hintergrund (asynchron) zugestellt, was auf Action Scheduler angewiesen ist. Stellen Sie sicher, dass die geplanten Aufgaben Ihrer Website ausgeführt werden. Für ein sofortiges Ergebnis während des Tests verwenden Sie die Steuerung „Test-Payload senden“ oder stellen Sie die Aktion auf synchrone Zustellung ein.

Backfill hat keine Webhooks an frühere Spender gesendet

Dies ist erwartet. Backfill führt nur Aktionen innerhalb von WP aus, wie z. B. Spender markieren. Webhook-Aktionen werden für bestehende Spender absichtlich übersprungen.

Entwicklerressourcen

Hooks und Filter

• charitable_automation_connect_actions filtert die registrierten Aktionstypen, sodass Sie Ihre eigene Aktion hinzufügen können.
• charitable_automation_connect_events und charitable_automation_connect_event_labels filtern die registrierten Trigger-Ereignisse und ihre Labels.
• charitable_automation_connect_events_for_editor filtert die Ereignisliste (und den Hilfe-Text pro Ereignis), die an den Builder übergeben wird.
• charitable_automation_connect_condition_fields filtert die im Bedingungs-Builder verfügbaren Felder.
• charitable_automation_connect_templates und charitable_automation_connect_zapier_templates filtern die Starter-Vorlagen.
• charitable_automation_connect_merge_tags und charitable_automation_connect_payload_fields filtern die Webhook-Payload-Merge-Tags und -Felder.
• charitable_automation_connect_default_editor_mode filtert, welcher Editor standardmäßig geöffnet wird.
• charitable_automation_connect_http_args und charitable_automation_connect_secret_key filtern die ausgehende Webhook-Zustellung.
• charitable_webhook_subscription_failure_threshold filtert, wie viele Fehler eine Automatisierung deaktivieren.
• charitable_automation_connect_fire_event wird ausgelöst, wenn ein Ereignis versendet wird, für benutzerdefinierte Handhabung.

Hinweise zur Erweiterung von Aktionen

Aktionen werden in der Aktionsregistrierung des Add-ons registriert und jede erweitert eine gemeinsame abstrakte Aktionsklasse, die ihren Slug, ihr Label, ihre Gruppe, unterstützte Ereignisse, ob sie nachfüllbar ist, ihr Konfigurationsschema und ihre Ausführungsmethode deklariert. Registrieren Sie Ihre eigene Aktion unter charitable_automation_connect_actions, damit sie im Aktions-Add-Palett angezeigt wird.

Zusätzliche Ressourcen

• Dokumentation zu Automation Connect
• Ankündigung des visuellen Automatisierungs-Builders
• Zapier Dokumentation