Zum Inhalt springen
Kibi Connect
Handbuch Kibi Connect

n8n-Integration: Kibi Connect automatisieren

3min

n8n ist ein Werkzeug für Workflow-Automatisierung, das Sie selbst betreiben oder als n8n Cloud nutzen können. Seit dem 19.09.2026 gibt es einen offiziellen Community Node für Kibi Connect: Er verbindet Ihre 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.

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.

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

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

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.

Weiterführende Links

Siehe auch
Kibi API