Zakenmaat documentatie handleiding
De AI-koppeling

Wat de koppeling is

Snap waarom er geen chatknop is, en wat je in plaats daarvan koppelt.

Zoek je in de app naar een chatvenster, dan zoek je vergeefs. Dat is geen functie die nog moet komen, het is een keuze. Je koppelt je eigen AI aan Zakenmaat en praat met hem waar je toch al werkt.

Hoe het werkt

Je verbindt de AI-client die je zelf gebruikt, bijvoorbeeld Claude, ChatGPT of Gemini, met je werkruimte. Daarna kan die client je gegevens in Zakenmaat lezen en bewerken, alsof jij het zelf in de app doet.

Je zegt dan tegen je AI: boek drie uur op Bakkerij Janssen van gisteren, of stuur factuur 2026-004 naar de klant. Hij voert het uit en het staat in de app.

Wat de koppeling niet kan is bij de code van Zakenmaat zelf. Hij praat met dezelfde gegevens waar jij toegang toe hebt, binnen jouw werkruimte, en niet daarbuiten.

Waarom er geen chatknop is

Een chatvenster in de app zou betekenen dat je een tweede AI-abonnement afneemt bij Zakenmaat, terwijl je er al een hebt. Je zou bovendien vastzitten aan het model dat hier is ingebouwd.

Nu bepaal je zelf welke AI je gebruikt en betaal je daar al voor. Wissel je van Claude naar iets anders, dan verbind je die opnieuw en werkt alles hetzelfde. Zakenmaat levert de gegevens en de handelingen, jouw AI levert het gesprek.

Het praktische gevolg: je werkt niet in Zakenmaat als je met de assistent praat. Je zit in je eigen AI-client, in een ander venster, en ziet het resultaat daarna in de app terug.

Twee manieren om te verbinden

Je vindt beide onder Instellingen › Koppelingen. Bovenaan staan drie kaarten, een per AI, met op elke kaart een knop Verbinden; daarachter zit de route die bij die client hoort. De sleutels zelf staan eronder bij Je sleutels.

Inloggen, zonder sleutel. Voor de meeste mensen is dit genoeg. Je voegt in je AI-client een connector toe met alleen de URL van Zakenmaat, en wordt daarna één keer naar de app gestuurd om in te loggen en toestemming te geven. Velden als client-id en client-secret laat je leeg. De verbinding verschijnt daarna in je instellingen onder “Verbonden via inloggen”, waar je hem ook weer kunt loskoppelen.

Met een sleutel. Voor clients die niet kunnen inloggen, en voor wie de API rechtstreeks aanroept. Je maakt een sleutel aan, geeft hem een naam die je herkent, en gebruikt hem als token. Vraagt je client om een token in plaats van je te laten inloggen, dan is dit de manier.

De stappen per client staan op Claude, ChatGPT en Gemini, elk klik voor klik.

Over die sleutels

Een sleutel krijg je precies één keer te zien, direct na het aanmaken. Bewaar hem meteen; daarna is hij niet meer op te vragen en maak je een nieuwe aan als je hem kwijt bent.

Je kunt kiezen of hij verloopt: niet, na 30 dagen, na 90 dagen of na een jaar. In de lijst zie je per sleutel zijn naam, het begin van de sleutel, wanneer hij voor het laatst is gebruikt en wanneer hij verloopt. De kolom Laatst gebruikt is nuttig: staat er “nog nooit” bij een sleutel die je vorige week hebt gemaakt, dan is je koppeling niet gelukt.

Elke sleutel kun je intrekken. De gekoppelde AI verliest dan meteen toegang, en dat geldt ook voor het loskoppelen van een verbinding die via inloggen loopt.

Wat je hierna wil weten

De assistent mag niet zomaar alles. Wat hij zelfstandig doet en waar hij eerst toestemming voor vraagt, stel je per groep in; zie Wat de AI mag.

Bij alles wat geld raakt of bestaande gegevens verandert, krijg je een bevestiging waarin de exacte inhoud staat. Waarom dat zo omslachtig is, staat op Waarom je twee keer bevestigt.

Wil je eerst weten wat er allemaal kan, kijk dan op Wat de AI kan.