Skip to content
Kibi Connect
Handboek Kibi Connect

n8n-integratie: Kibi Connect automatiseren

Bijgewerkt op Leestijd: 3 min

Op deze pagina

n8n is een tool voor workflowautomatisering die je zelf kunt hosten of als n8n Cloud kunt gebruiken. Sinds 19.09.2026 is er een officiële community-node voor Kibi Connect: deze verbindt je platform met andere systemen zonder dat daar code voor hoeft te worden geschreven.

Wat is de n8n-integratie?#

Pakket: @weslink/n8n-nodes-kibi-connect, versie 1.0.1, MIT-licentie, beschikbaar op npm.

Bron en volledige referentie (Engels): https://github.com/weslinkde/n8n-nodes-kibi-connect

Het pakket bevat twee nodes:

  • Kibi Connect (actie-node): 18 bronnen met in totaal 129 operaties die de volledige REST API v1 en de Files API dekken — berichten (feed), wiki-pagina's, taken, afspraken, chat, groepen, meldingen, enquêtes, zoeken, vergaderlinks, bestanden en mappen, deellinks, documenten (DMS), media-upload, tijdregistratie en gebruikersdirectory.

  • Kibi Connect Trigger: start een workflow zodra Kibi een webhook-gebeurtenis levert — bijvoorbeeld een nieuw bericht, een voltooide taak of een nieuw bestand.

Vereisten#

De REST API moet zijn ingeschakeld. Hoe een systeembeheerder dit instelt, alsmede alles over tokens en machtigingen (scopes), wordt beschreven op de pagina Kibi API.

Waarschuwing

Modules in acht nemen: Voor de bron Document moet de module Documentbeheer zijn geïnstalleerd, voor de bron Tijdregistratie de module Tijdregistratie. Als de betreffende module niet is geïnstalleerd, reageert Kibi op de betrokken routes met 404 — bewust dezelfde reactie als bij een onbekend ID.

Instelling#

1. REST-API inschakelen#

Een systeembeheerder schakelt de REST-API in onder Beheer → API. Daar bevindt zich ook de optionele IP-witlijst.

2. Token aanmaken#

Iedereen maakt zijn eigen token aan onder Mijn profiel → Integraties, met de machtigingen (scopes) die de geplande operaties vereisen.

Info

Tokens kunnen achteraf niet worden gewijzigd. Ontbreekt later een machtiging, dan is een nieuw token nodig.

3. Integratie-slug toekennen#

Wie de trigger automatisch wil laten registreren (zie hieronder), wijst bij het aanmaken van het token bovendien een integratie-slug toe. De slug is daarna onveranderlijk.

4. Community-node in n8n installeren#

  1. In n8n: Instellingen → Community Nodes → Installeren, voer vervolgens de pakketnaam @weslink/n8n-nodes-kibi-connect in.

  2. In de node de toeganggegevens aanmaken: Basis-URL (het tenant-adres, zonder schuine streep aan het einde en zonder /api), API-token en Integratie-slug.

  3. De verbindingstest in de dialoog bevestigt de instelling.

De trigger: twee bedrijfsmodi#

Automatisch (standaard)#

Bij het activeren van de workflow maakt de node het webhook-eindpunt zelf aan in Kibi; bij het deactiveren verwijdert deze het weer. Dit vereist van het token:

  • De machtigingen webhooks:read en webhooks:write

  • Een integratie-slug

  • Een persoon met systeembeheerder-rol als eigenaar van het token

Info

Vereist Kibi Connect 6.8.0 of nieuwer.

Handmatig#

Een beheerder maakt het eindpunt zelf aan onder Beheer → Webhook-eindpunten en voert het eenmalig getoonde handtekeninggeheim in de node in. Deze methode werkt met elke Kibi Connect-versie die uitgaande webhooks ondersteunt.

Handtekeningcontrole#

Elke levering wordt gecontroleerd via HMAC-SHA256 tegen de header X-Kibi-Signature. Een levering zonder geldige handtekening beantwoordt de node met 401 en start de workflow niet.

Oneindige lussen voorkomen#

Waarschuwing

Hier verbranden klanten zich het meest de vingers: een workflow die Kibi leest en schrijft, zou zich anders eindeloos zelf triggeren.

Elk webhook-bericht bevat data.origin. Hierin staat of de wijziging via de API (source: api) of door een persoon of een achtergrondproces (source: ui) is geactiveerd, en welke integratie-slug erachter zit.

De optie „Eigen schrijfacties negeren“ in de trigger is daarom standaard geactiveerd en verwijdert leveringen met de eigen slug.

Voorbeeld-workflows#

Twee voorbeeld-workflows bevinden zich in het GitHub-repository onder examples/ en kunnen in n8n worden geladen via Workflow → Importeren uit bestand:

  • Feed-aankondiging in de chat

    Kondigt nieuwe feed-berichten automatisch aan in een chatkanaal.

  • Factuuropslag uit de mailbox

    Slaat PDF-facturen uit een e-mailpostvak op in het documentbeheer en licht vervolgens de boekhouding in via een chatbericht.

Beschikbaarheid#

Stand 20.09.2026: Het pakket staat op npm en kan in zelf gehoste n8n-instanties direct worden geïnstalleerd. De verificatie door n8n, die bovendien de installatie rechtstreeks op n8n Cloud mogelijk maakt, is ingediend en wordt momenteel beoordeeld.

Zie ook
Kibi API