Hilfe-CenterIntegrationen & API
docunest lässt sich mit über 7.000 Apps verbinden — von Slack über Outlook bis DATEV. Dafür gibt es drei Wege: Zapier, Webhooks und die REST-API.
Alle Integrations-Einstellungen findest du im Dashboard unter Einstellungen → Integrationen.
API-Key erstellen
Ein API-Key ist die Voraussetzung für alle Integrationen. Er authentifiziert externe Systeme gegenüber docunest.
- Gehe zu Einstellungen → Integrationen → API Keys.
- Gib einen Namen ein (z. B. „Zapier" oder „DATEV-Export").
- Klicke auf Erstellen.
Der vollständige Key wird nur einmal angezeigt — kopiere ihn sofort und speichere ihn sicher. Er beginnt mit dk_live_.
Du kannst bis zu 10 API-Keys gleichzeitig haben. Keys lassen sich jederzeit deaktivieren oder löschen.
Zapier verbinden
Mit Zapier verbindest du docunest mit tausenden Apps — ohne Programmierung. Typische Anwendungsfälle:
- Schicht beendet → Slack-Nachricht an den Team-Channel
- Urlaubsantrag → E-Mail an den Vorgesetzten
- Neuer Mitarbeiter → Eintrag in Google Sheets
So richtest du es ein
- Erstelle einen API-Key (siehe oben) mit Lese- und Schreibrechten.
- Erstelle einen kostenlosen Account auf zapier.com.
- Erstelle einen neuen Zap und suche nach docunest Zeiterfassung.
- Gib deinen API-Key ein, wenn nach der Verbindung gefragt wird.
- Wähle einen Trigger (z. B. „Schicht Beendet") und eine Action (z. B. „Slack-Nachricht senden").
- Teste den Zap und aktiviere ihn.
Verfügbare Trigger
| Trigger | Beschreibung |
|---|---|
| Schicht Erstellt | Wird ausgelöst, wenn eine Schicht angelegt wird |
| Schicht Gestartet | Wird ausgelöst, wenn jemand einstempelt |
| Schicht Beendet | Wird ausgelöst, wenn jemand ausstempelt |
| Pause Gestartet | Wird ausgelöst bei Pausenbeginn |
| Pause Beendet | Wird ausgelöst bei Pausenende |
| Urlaub Beantragt | Wird ausgelöst bei neuem Urlaubsantrag |
| Urlaub Entschieden | Wird ausgelöst bei Genehmigung oder Ablehnung eines Urlaubsantrags |
| Abwesenheit Gemeldet | Wird ausgelöst bei neuer Abwesenheitsmeldung |
| Neuer Mitarbeiter | Wird ausgelöst, wenn ein Mitarbeiter hinzugefügt wird |
Verfügbare Actions
| Action | Beschreibung |
|---|---|
| Einstempeln | Startet eine Schicht für einen Mitarbeiter |
| Ausstempeln | Beendet die aktive Schicht |
| Schicht Anlegen | Erstellt eine abgeschlossene Schicht mit Start- und Endzeit |
| Urlaub Anlegen | Erstellt einen Urlaubsantrag |
| Abwesenheit Anlegen | Meldet eine Abwesenheit |
Webhooks einrichten
Webhooks senden automatisch Benachrichtigungen an eine URL deiner Wahl, sobald ein Ereignis eintritt. Das ist nützlich für eigene Systeme oder Automatisierungen.
- Gehe zu Einstellungen → Integrationen → Webhooks.
- Klicke auf Webhook hinzufügen.
- Gib die Ziel-URL ein (z. B.
https://dein-server.de/webhook). - Wähle das Event aus (z. B. „Schicht abgeschlossen").
- Klicke auf Erstellen.
Sicherheit
Jeder Webhook wird mit einer HMAC-SHA256-Signatur versehen. Den zugehörigen Secret findest du in den Webhook-Details. Prüfe die Signatur im Header X-Webhook-Signature, um sicherzustellen, dass die Anfrage tatsächlich von docunest stammt.
Zustellung
- Webhooks werden mit bis zu 3 Wiederholungsversuchen zugestellt (nach 1s, 5s, 25s).
- Nach 3 fehlgeschlagenen Versuchen in Folge wird der Webhook automatisch deaktiviert.
- Im Tab Webhook-Logs siehst du den Status jeder Zustellung.
REST-API
Für fortgeschrittene Integrationen bietet docunest eine vollständige REST-API. Die Dokumentation findest du im Dashboard unter Einstellungen → Integrationen → API-Dokumentation (Button oben rechts).
Die API bietet:
- Triggers: Polling-Endpoints für alle Events
- Actions: Schichten, Urlaub und Abwesenheiten erstellen
- Searches: Mitarbeiter, Projekte und Schichten durchsuchen
Alle Anfragen werden mit dem API-Key im Header Authorization: Bearer dk_live_... authentifiziert.
War dieser Artikel hilfreich?