Webhooks
Andere Anwendungen per Webhook automatisch informieren
Webhooks melden einer anderen Anwendung innerhalb von Sekunden, was in Erdikon passiert, zum Beispiel wenn eine Rechnung bezahlt oder ein Angebot angenommen wird. Sie kann sofort reagieren, ohne dass jemand Daten von Hand überträgt.
In den Plänen Pro und Unlimited enthalten, ab 7 € pro Benutzer:in und Monat.
Abläufe automatisieren
Team informieren
Wird eine Rechnung bezahlt oder ein Angebot angenommen, kann die empfangende Anwendung dein Team sofort benachrichtigen.
Folgeschritte starten
Nehmen Kund:innen ein Angebot über ihren persönlichen Link an, kann deine Projektverwaltung den Auftrag gleich anlegen. Ist eine Rechnung bezahlt, kann ein Onlineshop die bestellte Leistung freischalten.
Daten nachführen
Erdikon meldet neue Datensätze, Änderungen und Statuswechsel. Damit hältst du eine Umsatzübersicht oder ein anderes System auf dem aktuellen Stand.
Inhalt der Ereignisse
Jedes Ereignis enthält den betroffenen Datensatz, so wie er nach der Änderung war, bei einer Rechnung etwa Nummer, Status, Beträge und Datumsangaben. Die empfangende Anwendung braucht deshalb keinen Zugriff auf Erdikon, um darauf zu reagieren.
Für jeden Webhook wählst du, ob er alle Ereignisse erhält oder nur bestimmte, zum Beispiel nur bezahlte Rechnungen. Mit «Alle Ereignisse» erhält er auch Ereignisse, die später hinzukommen, etwa aus neuen Anwendungen.
Diese Ereignisse sendet Erdikon
- Ereignisse aller Anwendungen eines Space
- Neue & geänderte Datensätze
- Statuswechsel wie ausgestellt, bezahlt oder angenommen
Zuverlässige Zustellung
Vollständig & in Reihenfolge
Ereignisse kommen in der Reihenfolge an, in der sie passiert sind. Nimmt die empfangende Anwendung eines nicht an, stellt Erdikon es automatisch erneut zu, bevor das nächste folgt.
Probleme früh erkennen
Schlägt die Zustellung länger fehl, erhalten die Inhaber:innen eine E-Mail. Unter «Zustellungen» siehst du jeden Versuch der letzten 30 Tage.
Stabil bei Updates
Ein Webhook behält das Datenformat, mit dem du ihn eingerichtet hast. Updates von Erdikon fügen höchstens neue Angaben hinzu und ändern keine bestehenden.
Echtheit prüfbar
Erdikon signiert jedes Ereignis nach der offenen Spezifikation Standard Webhooks. Mit bestehenden Bibliotheken lässt sich so prüfen, ob ein Ereignis wirklich von Erdikon stammt.
Kontrolle über deine Daten
Ein Webhook sendet Geschäftsdaten an eine andere Anwendung. Einrichten und ändern dürfen ihn deshalb nur die Inhaber:innen des Space oder der Organisation, und er erhält nur die Ereignisse seines Space.
Soll ein Webhook an eine neue Adresse senden oder andere Ereignisse erhalten, bestätigst du das mit deinem Passwort oder Passkey.
So behältst du die Kontrolle
- Nur Ereignisse des eigenen Space
- Nur Inhaber:innen richten Webhooks ein
- Bestätigung mit Passwort oder Passkey
- Nur verschlüsselt über HTTPS
- Jederzeit pausieren oder löschen
Häufige Fragen
Welche Anwendungen können Webhooks von Erdikon empfangen?
Jede Anwendung, die Webhooks über eine öffentlich erreichbare HTTPS-Adresse annimmt, etwa ein Automatisierungsdienst oder ein eigenes Skript.
Was passiert, wenn die empfangende Anwendung länger ausfällt?
Erdikon versucht die Zustellung bis zu 72 Stunden lang. Danach deaktiviert es den Webhook und informiert die Inhaber:innen per E-Mail. Aktivierst du ihn wieder, holt er die verpassten Ereignisse nach.
Wo finden Entwickler:innen die technischen Details?
Direkt in Erdikon. Die Details jedes Webhooks beschreiben den Aufbau der Anfragen, die Prüfung der Signatur und die Regeln der Zustellung. Unter «Ereignistypen» siehst du die Felder jedes Ereignisses.
Sendet Erdikon auch Änderungen an Stammdaten?
Vorerst nicht. Webhooks senden die Ereignisse aller Anwendungen eines Space. Stammdaten können aber in mehreren Spaces verfügbar sein, und ein Webhook würde Änderungen aus den anderen Spaces verpassen.
Funktionieren Webhooks auch beim Self-Hosting?
Ja, deine eigene Installation sendet Webhooks wie die Erdikon-Cloud. Auch dort muss die empfangende Anwendung über eine öffentliche Adresse erreichbar sein. Adressen im lokalen Netzwerk lehnt Erdikon ab.
Verwendet in
Fakturierung
Angebote, Rechnungen und Gutschriften melden ihre Änderungen an andere Anwendungen.
Mehr erfahrenProjekte
Neue, geänderte und gelöschte Projekte melden ihre Änderungen an andere Anwendungen.
Mehr erfahrenProjektzeit
Neue, geänderte und gelöschte Zeiteinträge melden ihre Änderungen an andere Anwendungen.
Mehr erfahrenAusgaben
Ausgaben melden ihre Änderungen, auch neue Zahlungen und wenn eine Rechnung sie verrechnet.
Mehr erfahren