Zum Inhalt springen
Kibi Connect
Handbuch Kibi Connect

n8n-Integration: Kibi Connect automatisieren

Aktualisiert am Lesezeit: 3 Min.

Auf dieser Seite

n8n ist ein Werkzeug für Workflow-Automatisierung, das du selbst betreiben oder als n8n Cloud nutzen kannst. Seit dem 19.09.2026 gibt es einen offiziellen Community Node für Kibi Connect: Er verbindet deine Plattform mit anderen Systemen, ohne dass dafür Code geschrieben werden muss.

Was ist die n8n-Integration?#

Paket: @weslink/n8n-nodes-kibi-connect, Version 1.0.1, MIT-Lizenz, verfügbar auf npm.

Quelle und vollständige Referenz (Englisch): https://github.com/weslinkde/n8n-nodes-kibi-connect

Das Paket enthält zwei Nodes:

  • Kibi Connect (Aktions-Node): 18 Ressourcen mit insgesamt 129 Operationen, die die gesamte REST API v1 sowie die Files API abdecken -- Beiträge (Feed), Wiki-Seiten, Aufgaben, Termine, Chat, Gruppen, Benachrichtigungen, Umfragen, Suche, Besprechungslinks, Dateien und Ordner, Freigabelinks, Dokumente (DMS), Medien-Upload, Zeiterfassung und Nutzendenverzeichnis.

  • Kibi Connect Trigger: Startet einen Workflow, sobald Kibi ein Webhook-Ereignis liefert -- zum Beispiel ein neuer Beitrag, eine erledigte Aufgabe oder eine neue Datei.

Voraussetzungen#

Die REST API muss aktiviert sein. Wie ein Systemadministrator das einrichtet, sowie alles rund um Token und Berechtigungen (Scopes), beschreibt die Seite Kibi API.

Warnung

Module beachten: Für die Ressource Dokument muss das Modul Dokumentenmanagement installiert sein, für die Ressource Zeiterfassung das Modul Zeiterfassung. Ist das jeweilige Modul nicht installiert, antwortet Kibi auf den betroffenen Routen mit 404 -- bewusst derselben Antwort wie bei einer unbekannten ID.

Einrichtung#

1. REST-API freischalten#

Ein Systemadministrator schaltet die REST-API frei unter Administration → API. Dort liegt auch die optionale IP-Freigabeliste.

2. Token anlegen#

Jede Person legt ihr eigenes Token an unter Mein Profil → Integrationen, mit den Berechtigungen (Scopes), die die geplanten Operationen benötigen.

Info

Tokens lassen sich nachträglich nicht ändern. Fehlt später eine Berechtigung, braucht es ein neues Token.

3. Integrations-Slug vergeben#

Wer den Trigger automatisch registrieren lassen möchte (siehe unten), vergibt beim Anlegen des Tokens zusätzlich einen Integrations-Slug. Der Slug ist danach unveränderlich.

4. Community Node in n8n installieren#

  1. In n8n: Einstellungen → Community Nodes → Installieren, dann den Paketnamen @weslink/n8n-nodes-kibi-connect eingeben.

  2. Im Node die Zugangsdaten anlegen: Basis-URL (die Tenant-Adresse, ohne Schrägstrich am Ende und ohne /api), API-Token und Integrations-Slug.

  3. Der Verbindungstest im Dialog bestätigt die Einrichtung.

Der Trigger: zwei Betriebsarten#

Automatisch (Standard)#

Beim Aktivieren des Workflows legt der Node den Webhook-Endpunkt in Kibi selbst an, beim Deaktivieren entfernt er ihn wieder. Das verlangt vom Token:

  • Die Berechtigungen webhooks:read und webhooks:write

  • Einen Integrations-Slug

  • Eine Person mit Systemadministrator-Rolle als Eigentümer des Tokens

Info

Erfordert Kibi Connect 6.8.0 oder neuer.

Manuell#

Ein Administrator legt den Endpunkt selbst an unter Administration → Webhook-Endpunkte und trägt das einmalig angezeigte Signaturgeheimnis im Node ein. Dieser Weg funktioniert mit jeder Kibi-Connect-Version, die ausgehende Webhooks unterstützt.

Signaturprüfung#

Jede Zustellung wird per HMAC-SHA256 gegen den Header X-Kibi-Signature geprüft. Eine Zustellung ohne gültige Signatur beantwortet der Node mit 401 und startet den Workflow nicht.

Endlosschleifen vermeiden#

Warnung

Hier verbrennen sich Kunden am ehesten die Finger: Ein Workflow, der Kibi liest und schreibt, würde sich sonst endlos selbst auslösen.

Jede Webhook-Nachricht trägt data.origin. Darin steht, ob die Änderung über die API (source: api) oder durch eine Person beziehungsweise einen Hintergrundprozess (source: ui) ausgelöst wurde, und welcher Integrations-Slug dahintersteckt.

Die Option „Ignore Own Writes“ im Trigger ist deshalb standardmäßig aktiviert und verwirft Zustellungen mit dem eigenen Slug.

Beispiel-Workflows#

Zwei Beispiel-Workflows liegen im GitHub-Repository unter examples/ und lassen sich in n8n über Workflow → Import from File laden:

  • Feed-Ankündigung im Chat

    Kündigt neue Feed-Beiträge automatisch in einem Chat-Kanal an.

  • Rechnungs-Ablage aus dem Postfach

    Legt PDF-Rechnungen aus einem E-Mail-Postfach im Dokumentenmanagement ab und benachrichtigt anschließend die Buchhaltung per Chat-Nachricht.

Verfügbarkeit#

Stand 20.09.2026: Das Paket liegt auf npm und lässt sich in selbst gehosteten n8n-Instanzen sofort installieren. Die Verifizierung durch n8n, die zusätzlich die Installation direkt auf n8n Cloud freischaltet, ist eingereicht und wird derzeit geprüft.

Siehe auch
Kibi API