Webhooks & API

dVersum bietet Webhooks und eine REST-API für die Integration mit anderen Systemen wie n8n, Zapier oder Ihrer eigenen Software.

Ausgehende Webhooks

Ausgehende Webhooks senden automatisch Benachrichtigungen an externe Systeme, wenn bestimmte Ereignisse in dVersum auftreten.

Webhook erstellen

1. Gehen Sie zu Einstellungen → Integrationen
2. Klicken Sie auf Webhooks
3. Klicken Sie auf Neuer Webhook
4. Füllen Sie aus:
   • Name - Beschreibender Name
   • URL - Ziel-URL, die aufgerufen wird
   • Ereignisse - Welche Events auslösen sollen
5. Speichern Sie

Verfügbare Ereignisse

Die wichtigsten Ereignisse:

• Rechnungen: invoice.created, invoice.sent, invoice.paid, invoice.overdue
• Angebote: quote.created, quote.accepted, quote.rejected
• Kunden: client.created, client.updated
• Aufgaben: task.created, task.completed
• Projekte: project.created
• Zeit: time_entry.created

→ Vollständige Event-Liste in den API Docs

Eingehende Webhooks

Eingehende Webhooks ermöglichen es externen Systemen, Daten an dVersum zu senden.

Eingehenden Webhook erstellen

1. Gehen Sie zu Einstellungen → Integrationen
2. Klicken Sie auf Eingehende Webhooks
3. Klicken Sie auf Neuer Eingehender Webhook
4. Wählen Sie die Berechtigungen:
   • Aufgaben erstellen/bearbeiten/löschen
   • Projekte erstellen/bearbeiten
   • Kunden erstellen/bearbeiten
   • Zeiteinträge erstellen
   • Rechnungen erstellen
   • Angebote erstellen
5. Optional: IP-Whitelist für zusätzliche Sicherheit
6. Speichern Sie

API-Key

Nach dem Erstellen erhalten Sie einen API-Key (z.B. ik_live_abc123...).

Verfügbare Endpunkte

Mit eingehenden Webhooks können Sie:

• Aufgaben erstellen und aktualisieren
• Kunden anlegen und bearbeiten
• Zeiteinträge erfassen
• Rechnungen und Angebote erstellen

→ Alle Endpunkte mit Request/Response-Beispielen in den API Docs

Integration mit n8n

n8n ist eine Open-Source-Automatisierungsplattform.

dVersum → n8n (Ausgehend)

1. Erstellen Sie einen Webhook in dVersum
2. In n8n: Fügen Sie einen Webhook-Trigger hinzu
3. Kopieren Sie die n8n-Webhook-URL
4. Tragen Sie diese URL in dVersum ein

n8n → dVersum (Eingehend)

1. Erstellen Sie einen eingehenden Webhook in dVersum
2. In n8n: Fügen Sie einen HTTP Request-Node hinzu
3. Methode: POST
4. URL: https://dversum.com/api/v1/webhooks/incoming/tasks
5. Header: Authorization: Bearer IHR_API_KEY
6. Body: JSON mit den Aufgaben-Daten

Beispiel-Workflow

Szenario: Neue E-Mail → Aufgabe in dVersum

1. Trigger: E-Mail empfangen (Gmail/IMAP)
2. Action: HTTP Request an dVersum
3. Payload: Betreff → Titel, Inhalt → Beschreibung

Integration mit Zapier

Zapier ermöglicht Integrationen ohne Programmierung.

dVersum-Trigger in Zapier

1. Erstellen Sie einen neuen Zap
2. Wählen Sie Webhook by Zapier als Trigger
3. Wählen Sie Catch Hook
4. Kopieren Sie die Zapier-Webhook-URL
5. Erstellen Sie in dVersum einen Webhook mit dieser URL

dVersum-Action in Zapier

1. Wählen Sie Webhook by Zapier als Action
2. Wählen Sie POST
3. URL: dVersum-Eingehender-Webhook-URL
4. Headers: Authorization Bearer Key
5. Data: JSON-Daten

Fehlerbehandlung

Webhook-Retry

Ausgehende Webhooks werden bei Fehlern automatisch wiederholt:

• 1. Retry: Nach 1 Minute
• 2. Retry: Nach 5 Minuten
• 3. Retry: Nach 30 Minuten
• 4. Retry: Nach 2 Stunden

Webhook-Log

Sehen Sie alle Webhook-Aufrufe:

1. Gehen Sie zu Einstellungen → Webhooks
2. Klicken Sie auf Log anzeigen
3. Sie sehen:
   • Zeitpunkt
   • Ereignis
   • Status (Erfolg/Fehler)
   • Response-Code
   • Payload

Sicherheit

Best Practices

1. HTTPS verwenden - Nur verschlüsselte Verbindungen
2. Signatur prüfen - Verifizieren Sie die Webhook-Signatur
3. IP-Whitelist - Beschränken Sie den Zugriff
4. Berechtigungen minimal - Nur nötige Berechtigungen erteilen
5. Keys rotieren - Ändern Sie API-Keys regelmäßig

Webhook deaktivieren

Bei Sicherheitsproblemen:

1. Gehen Sie zu den Webhook-Einstellungen
2. Klicken Sie auf Deaktivieren
3. Der Webhook sendet keine Daten mehr

Rate Limits

Bei Überschreitung erhalten Sie den Status-Code 429.