Skip to content
Kibi Connect
Handboek Kibi Connect

n8n-integratie: Kibi Connect automatiseren

3min

n8n is een tool voor workflowautomatisering die u 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 uw 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 (actienode): 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, zoekopdrachten, 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, evenals alles over tokens en machtigingen (scopes), wordt beschreven op de pagina Kibi API.

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.

Tokens kunnen achteraf niet worden gewijzigd. Als later een machtiging ontbreekt, 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 aanvullend 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 tenantadres, 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 systeembeheerderrol als eigenaar van het token

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 via HMAC-SHA256 gecontroleerd tegen de header X-Kibi-Signature. Een levering zonder geldige handtekening beantwoordt de node met 401 en start de workflow niet.

Eindeloze lussen voorkomen

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 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.

Voorbeeldworkflows

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

  • Feed-aankondiging in 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 onmiddellijk worden geïnstalleerd in zelf gehoste n8n-instanties. De verificatie door n8n, die bovendien de installatie rechtstreeks op n8n Cloud vrijgeeft, is ingediend en wordt momenteel gecontroleerd.

Aanvullende links

Zie ook
Kibi API