Zapier, Make und n8n
Auslöser
Auslöser basieren auf Webhooks: Beim Aktivieren eines Ablaufs registriert die Plattform einen Webhook-Endpunkt bei DebtFlow, beim Deaktivieren entfernt sie ihn. Ereignisse kommen damit sofort an, ohne Abfragen im Minutentakt.
| Auslöser | Ereignis |
|---|---|
| Neuer Kontakt | contact.created |
| Rechnung festgeschrieben | invoice.finalized |
| Rechnung bezahlt | invoice.paid |
| Rechnung überfällig | invoice.overdue |
| Angebot angenommen | offer.accepted |
| Zahlung zu Forderung eingegangen | payment.received |
| Forderung wechselt die Phase | debt.phase_changed |
| Forderung überfällig | debt.overdue |
| Rate wird fällig (3 Tage vorher) | installment.due |
| Rate versäumt | installment.missed |
| Kommunikation erfasst | communication.created |
| Melderegisteranfrage gestellt | residence_registry_inquiry.created |
| Empfehlung der Gläubiger-KI erstellt | recommendation.created |
| Beleg erkannt | receipt.processed |
| Brief zugestellt | letter.delivered |
| Beliebiges Ereignis | alle aus dem Katalog |
Aktionen
| Aktion | Endpunkt |
|---|---|
| Kontakt anlegen | POST /contacts |
| Kontakt suchen | GET /contacts |
| Rechnungsentwurf anlegen | POST /invoices |
| Rechnung festschreiben | POST /invoices/{id}/finalize |
| Rechnung versenden | POST /invoices/{id}/send |
| Forderung anlegen | POST /debts |
| Zeit erfassen | POST /time-entries |
| Kommunikation protokollieren | POST /contacts/{id}/communications |
| Melderegisteranfrage beauftragen (kostenpflichtig) | POST /contacts/{id}/residence-registry-inquiries |
| Empfehlung der Gläubiger-KI erzeugen | POST /debts/{id}/recommendations |
| Eintrag im Aktivitätsprotokoll | POST /activities |
| API-Anfrage (beliebiger Endpunkt) | jeder Endpunkt der API v1 |
Die Melderegisteranfrage kostet 19,99 € zzgl. USt. je Anfrage und braucht den Scope research:write. Die Gläubiger-KI (Scope ai:write) nutzt das KI-Kontingent Ihres Kontos; bei ausgeschöpftem Kontingent antwortet die API mit 429. Erlauben Sie diese Scopes einer Verbindung nur, wenn der Ablauf sie wirklich braucht.
Anmeldung
- Zapier und Make verbinden sich per OAuth 2.0: Sie melden sich bei DebtFlow an und erlauben den Zugriff. Unter Einstellungen → Apps sehen und trennen Sie die Verbindung.
- n8n unterstützt beides: einen API-Schlüssel (einfach, ideal für selbst gehostete Instanzen) oder OAuth 2.0.
Heute schon: ohne offizielle App
Daten an DebtFlow senden
In Zapier („Webhooks by Zapier“, Aktion Custom Request), Make (Modul HTTP → Make a request) oder n8n (Knoten HTTP Request) eine Anfrage an https://www.debt-flow.io/api/v1/… mit dem Header Authorization: Bearer df_live_… und JSON-Body senden. Welche Felder ein Endpunkt erwartet, steht in der API-Referenz. Für POST-Anfragen einen Idempotency-Key aus einer eindeutigen ID des Ablaufs setzen, damit Wiederholungen der Plattform keine Dubletten erzeugen.
Ereignisse aus DebtFlow empfangen
Auf der Plattform einen Webhook-Auslöser anlegen (Zapier „Catch Hook“, Make „Custom webhook“, n8n „Webhook“), dessen URL kopieren und in DebtFlow unter Einstellungen → Webhooks als Endpunkt mit den gewünschten Ereignissen eintragen. Die Signaturprüfung ist optional, aber empfohlen.