Integrationen
Fynex bietet mehrere Wege, Ihre bestehenden Systeme mit Ihrem Inkasso-Workflow zu verbinden. Sie können Daten importieren und exportieren, Echtzeit-Ereignisse per Webhook empfangen und die vollständige REST API für programmatische Steuerung nutzen.
Was Sie integrieren können
| Funktion | Beschreibung |
|---|---|
| CSV/Excel-Import | Hochladen von Account-Portfolios aus Tabellen über die UI |
| REST API | Lesen und Schreiben von Accounts, Contacts, Payments und Interactions per HTTP |
| Webhooks | Echtzeit-HTTP-POST-Benachrichtigungen, wenn Events in Fynex auftreten |
| Datenexport | Export von Accounts und Interaction-Daten als JSON oder CSV für Reporting |
Erste Schritte
- API-Key anlegen — Öffnen Sie Einstellungen > Integrationen und erzeugen Sie einen API-Key mit den Scopes, die Ihre Integration braucht. Details im Leitfaden API-Keys.
- Webhooks konfigurieren — Fügen Sie einen Webhook-Endpoint hinzu, um Ereignisbenachrichtigungen in Echtzeit zu empfangen. Anleitung im Leitfaden Webhooks.
- Daten synchronisieren — Nutzen Sie die REST API zum Import von Accounts, Export von Daten oder für eigene Workflows. Bulk-Operationen siehe Import & Export per API.
Authentifizierungsmethoden
Fynex unterstützt je nach Anwendungsfall zwei Authentifizierungsmethoden:
| Methode | Anwendungsfall | Funktionsweise |
|---|---|---|
| API Key | Machine-to-machine-Integrationen | Key im HTTP-Header X-API-Key senden |
| JWT Token | Browserbasierte Sessions | Von Supabase Auth ausgestellt, von der Fynex-UI automatisch angehängt |
Für die meisten Integrationen — CRM-Sync, ERP-Import, Reporting-Pipelines — verwenden Sie API-Keys. JWT wird intern von der Fynex-Webanwendung genutzt.
Integrations-Leitfäden
| Leitfaden | Beschreibung |
|---|---|
| API-Keys | API-Keys anlegen, verwalten und absichern |
| Webhooks | Echtzeit-Ereignisbenachrichtigungen empfangen |
| Import & Export per API | Bulk-Import und -Export von Accounts programmatisch |
| API-Referenz | Vollständige Endpoint-Dokumentation |
TIP
Wenn Sie nur Accounts aus einer Tabelle importieren möchten, können Sie den CSV/Excel-Import auf der Seite Portfolio nutzen, ohne API-Keys einzurichten.