Webhooks und Ereignisse im RaiseNow Hub

Dieser Artikel erklärt, wie Organisationen mit einem Growth-Plan Webhooks im RaiseNow Hub erstellen, verwalten und überwachen können. Webhooks ermöglichen Echtzeit-Benachrichtigungen für wichtige Ereignisse und helfen Organisationen, RaiseNow-Daten effizient in ihre eigenen Systeme zu integrieren.

Was sind Webhooks und Ereignisse?

Ein Webhook ist eine automatisierte Nachricht, die von RaiseNow Hub an eine definierte URL gesendet wird, sobald ein bestimmtes Ereignis eintritt.

Ein Event ist eine Aktion oder Änderung im System, zum Beispiel:

• Eine neue Spende
• Eine erfolgreiche Zahlung
• Ein aktualisiertes Abonnement
• Änderungen an Unterstützer- oder Organisationsdaten

Anstatt regelmässig nach Updates zu suchen (Polling), erhält dein System die Informationen sofort, wenn das Ereignis eintritt.

So funktioniert es

Webhooks aufrufen

1. Gehe in RaiseNow Hub zu Einstellungen.
2. Wähle Webhooks.

Dieser Bereich enthält alle Optionen, um Webhooks und Events zu erstellen, zu verwalten und zu überwachen.

Webhooks erstellen und verwalten

Du kannst neue Webhooks erstellen, um die Events zu abonnieren, die für deine Organisation relevant sind, darunter:

• Transaktionen und Zahlungen

• Abonnements

• Unterstützerdaten

• Organisationsbezogene Änderungen

Jeder Webhook sendet Ereignisdaten an die von dir definierte URL.

Eine vollständige und aktuelle Liste der unterstützten Ereignisse findest du in der Developer Documentation.

Webhooks suchen und filtern

Um grössere Setups einfacher zu verwalten, kannst du bestehende Webhooks suchen und filtern.

Verfügbare Filter sind:

• UUID

• Webhook-URL

• Webhook-Alias

• Name des Ereignisses

So findest du schnell bestimmte Konfigurationen und behältst dein Setup übersichtlich.

Ereignis-Lieferprotokolle ansehen

RaiseNow Hub speichert Webhook-Lieferprotokolle für die letzten sechs Monate.

Fehlgeschlagene Webhook-Events erneut senden

Wenn die Zustellung eines Webhook-Events fehlschlägt, kannst du es direkt in RaiseNow Hub erneut senden, ohne eine manuelle Nachbearbeitung ausserhalb der Plattform durchführen zu müssen.

So sendest du ein Event erneut

1. Gehe zu Einstellungen → Webhooks
2. Öffne den Bereich Antworten und suche die fehlgeschlagene Antwort
3. Klicke in der Detailansicht der Antwort auf Erneut senden.

Was du erwarten kannst

• Ein Ladeindikator bestätigt, dass das Event für den erneuten Versand vorgemerkt wurde
• Nach Abschluss wird eine Erfolgs- oder Fehlermeldung angezeigt
• Der erneute Versand wird protokolliert und ist in der Responses-Tabelle vollständig nachvollziehbar

Rate Limiting

Um Missbrauch zu verhindern, sind erneute Versandversuche auf 5 pro Minute begrenzt. Sobald das Limit erreicht ist, wird der Erneut senden-Button deaktiviert und eine entsprechende Meldung angezeigt.