CRM integratie via open interfaces: je tools en agents werken vanuit hetzelfde klantrecord

Een CRM integratie verplaatst gegevens of triggers tussen je CRM en een ander systeem, zodat niemand een deal van het ene scherm naar het andere overtypt. Customermates doet dat via vier open interfaces in plaats van een app-marktplaats: een REST API, uitgaande webhooks, een MCP-eindpunt voor AI-clients en een community node voor n8n. De REST API en MCP zijn er bij elk abonnement. Webhooks, en de n8n-triggers die ervan afhangen, horen bij elk betaald abonnement. Self-hosted installaties hebben alle vier.

Die keuze heeft een prijs die je vooraf moet kennen. Er is geen catalogus met apps die je met één klik koppelt. Wil je dat Customermates met Slack, je boekhoudtool of een formulierbouwer praat, dan richt je een webhook op die tool, roep je de API aan vanuit je eigen code, of bouw je de flow in een automatiseringstool zoals n8n, Make of Zapier.

Wat dit betekent voor opvolging. De opvolging van een klantgesprek eindigt vaak in een ander systeem: een bericht in de teamchat als er een antwoord binnenkomt, een record in je projecttool. Een webhook op de berichtgebeurtenissen, een n8n-flow of je eigen AI-client via MCP kan dat oppakken, zodat de volgende stap er niet van afhangt dat iemand het overtikt.

Waarom een CRM koppelen aan andere tools?

Een CRM waar niemand de gegevens van andere tools in terugvindt, wordt snel een extra administratiesysteem. Een koppeling haalt dat weg:

• Minder overtikken. Een gewonnen deal, een ingevuld formulier of een binnengekomen bericht hoeft maar op één plek te worden ingevoerd.
• Eén beeld van de klant. Wat sales, administratie en support weten, staat bij hetzelfde record in plaats van verspreid over tools die elkaar tegenspreken.
• Minder fouten. Gegevens die van systeem naar systeem gaan, worden niet halverwege verkeerd overgetypt.
• Sneller reageren. Een gebeurtenis, zoals een nieuw bericht van een klant, kan direct iemand in de teamchat informeren of een volgende stap aanmaken.

Elke koppeling is ook iets om te onderhouden. Begin daarom met de ene overdracht die je nu het vaakst met de hand doet.

Welke CRM-koppelingen komen het meest voor?

Het gaat meestal om dezelfde zes soorten systemen. Zo pak je ze aan met Customermates:

Native of zelf bouwen? Een native koppeling met een app-marktplaats is snel aangezet, maar beperkt tot wat de leverancier heeft gebouwd. Een koppeling via API en webhooks kost meer werk bij de start en past daarna op elk proces dat je team heeft.

Zo pak je een CRM-integratie stap voor stap aan

1. Kies één overdracht. Bijvoorbeeld: een gewonnen deal doorgeven aan je boekhoudsoftware.
2. Bepaal de richting. Stuurt het CRM iets (webhook), ontvangt het iets (REST API) of moet een AI-client meelezen en schrijven (MCP)? De tabel hieronder helpt je kiezen.
3. Geef de koppeling de juiste rechten. Een API-sleutel erft de rechten van de gebruiker die hem aanmaakt, dus maak hem aan met een gebruiker wiens rol bij de integratie past.
4. Test met één record. Maak een testdeal, open het webhooklog en controleer of de ontvanger de statuscode 2xx teruggeeft.
5. Maak de koppeling betrouwbaar. Behandel leveringen als idempotent, met de gebeurtenis-id als sleutel, en spreek af wie de koppeling beheert als er iets verandert.

De vijf soorten koppelingen in één overzicht

Webhooks, REST en MCP horen bij Starter voor € 12 per gebruiker per maand. De gecombineerde inbox begint bij Pro voor € 29 per gebruiker per maand en bevat 1 gekoppeld account per gebruiker; Business bevat 3 per gebruiker en gedeelde accounts. Self-hosted installaties krijgen REST, webhooks en MCP maar geen inbox, dus berichtgebeurtenissen gaan daar nooit af.

Welke route past bij welke taak

Webhooks

Maak een webhook aan onder Instellingen → Webhooks → Toevoegen, plak de URL van de ontvanger, kies gebeurtenissen en kies de lijst onder Records uit. Je kunt kiezen uit 16 gebeurtenissen: 5 recordgebeurtenissen (aangemaakt, bijgewerkt, naar de prullenbak verplaatst, hersteld en definitief verwijderd, voor elke lijst die je kiest, ook je eigen) en 11 berichtgebeurtenissen, zoals een ontvangen bericht of e-mail en een gewijzigde agenda-afspraak.

De details die tellen als je erop bouwt:

• Handtekeningen. Stel een secret in en elke levering draagt een HMAC-SHA256-handtekening over de body van het verzoek, zodat de ontvanger vervalste aanroepen kan weigeren.
• Nieuwe pogingen. Time-outs, netwerkfouten, 5xx-antwoorden en 408, 425 en 429 worden automatisch opnieuw geprobeerd, tot in totaal 10 pogingen. Andere 4xx-antwoorden niet.
• Leveringslog. Instellingen → Webhooklog toont elke levering met statuscode en payload, en je kunt er een opnieuw versturen.
• Eigen headers en bodysjablonen. Met headers authenticeer je je bij de ontvanger. Een bodysjabloon vervangt de standaard JSON-envelop door de vorm die de ontvanger verwacht, met plaatsaanduidingen zoals {{event}} en {{data.record.ref.recordId}}.
• Alleen wijzigingen. Een record.updated-gebeurtenis noemt elk gewijzigd veld met de waarde before en after, en een schrijfactie die niets verandert, stuurt geen gebeurtenis.

Leveringen komen niet strikt op volgorde aan, dus behandel ze als idempotente berichten met de gebeurtenis-id als sleutel en sorteer op de timestamp uit de payload en de recordversie. De volledige catalogus en de vormen van de payload staan in de webhookdocumentatie.

REST API

De API is geversioneerd onder /api/v1, wordt geauthenticeerd met een x-api-key-header en wordt beschreven door een OpenAPI-document. Dezelfde actie-eindpunten bedienen elke lijst die je werkruimte aanmaakt en adresseren een record via typeId en recordId: POST /api/v1/records/query en /records/search lezen, POST /api/v1/records/mutate maakt aan, werkt bij, verwijdert, koppelt en ontkoppelt, en de acties updateMany en deleteMany wijzigen tot 100 records per verzoek. POST /api/v1/model/read geeft je velden en hun optie-ID's terug, die je nodig hebt omdat de Fase van een deal een instelbaar veld met enkele keuze is en geen vaste waarde.

Een API-sleutel erft de rechten van de gebruiker die hem heeft aangemaakt. Er is geen bereik per sleutel, dus maak sleutels aan met een gebruiker wiens rol bij de integratie past. Meer details op de pagina over de API.

MCP voor AI-clients

MCP (Model Context Protocol) is een open standaard om AI-toepassingen met externe systemen te verbinden. Customermates draait één MCP-eindpunt op /api/v1/mcp met 59 tools. Claude en ChatGPT verbinden als aangepaste connector met OAuth-aanmelding, zoals beschreven in Claude en ChatGPT koppelen. Claude Code, Codex, Cursor en Gemini CLI verbinden met een API-sleutel.

De client en het model zijn van jou. Je AI-aanbieder rekent het gebruik van zijn eigen model af. Semantisch zoeken in de cloud via MCP kan nog steeds meetellen voor het gebruik van Mate; gewone CRM-recordaanroepen gebruiken het model van je client niet op de server van Customermates. Tools voor berichten, agenda en social media vragen een Cloud-abonnement met inbox. De MCP-referentie somt elke tool op.

In Customermates Cloud zit ook Mate, de gehoste assistent, die gehoste AI-credits gebruikt. Mate kan webhooks voor je aanmaken en bewerken, en zijn routines kunnen een opgeslagen instructie uitvoeren als een record verandert. Dat dekt werk waarvoor lezen en oordelen nodig is; vaste regels horen thuis in webhooks en n8n.

n8n, Make of Zapier

Geen van deze is bij Customermates inbegrepen. Je draait ze apart of neemt er apart een abonnement op, en zij brengen de grote connectorcatalogi mee. Customermates documenteert de n8n-patronen en publiceert een community node; Make en Zapier werken via hun algemene webhook- en HTTP-stappen. Customermates publiceert deze pagina; de tabel hieronder beschrijft het factureringsmodel van elke tool volgens zijn eigen prijspagina, gecontroleerd op 8 oktober 2026.

n8n is fair-code onder de Sustainable Use License: n8n omschrijft zijn broncode als beschikbaar en zelf te hosten. Dat is een andere licentie dan de AGPL voor de kern van Customermates.

Betaal je al voor een van deze tools, gebruik die dan. Begin je helemaal opnieuw en heb je iemand die een container kan draaien, dan houdt self-hosted n8n zowel de CRM als de automatisering op je eigen servers. De n8n-installatiegids toont de webhooktrigger, de HTTP Request-aanroepen en de x-api-key-inloggegevens.

Slack: twee routes, geen native app

Customermates heeft geen Slack-app, geen Slack-kanaal in de inbox en geen scherm met Slack-instellingen. Slack bereik je via webhooks of n8n.

Route 1, alleen een webhook. De inkomende webhooks van Slack accepteren een JSON-POST zoals {"text": "Hallo"} en plaatsen die in één kanaal. Een bodysjabloon van Customermates levert precies dat op:

Route 2, n8n. Gebruik n8n als het bericht logica nodig heeft: alleen een melding als de Fase van de deal een bepaalde waarde bereikt, een wekelijks pipelineoverzicht uit een geplande POST /api/v1/records/query, of een Slack-snelkoppeling die via de API een nieuwe contactpersoon wordt. Slack-gesprekken verschijnen in beide gevallen nooit in de inbox van Customermates.

Wat niet is inbegrepen

Heeft je team honderden kant-en-klare connectors nodig die door de leverancier worden onderhouden en die een niet-technisch persoon in een instellingenscherm aanzet, dan past een CRM met een eigen app-marktplaats beter. Customermates past bij teams die graag een webhook aansluiten of een AI-client de aanroepen laten doen, en die dezelfde interfaces willen of ze nu de cloud gebruiken of zelf hosten. Koppelingen met een ERP volgen hetzelfde patroon; de gids over CRM en ERP koppelen loopt het door.

Veelgestelde vragen

Houd de bedrijfsgids en de brongegevens naast het klantrecord in de AI-kennisbank.

Verificatie van gegevens van derden op 8 oktober 2026 aan de hand van de prijzen van n8n, de n8n-repository, de prijzen van Make, de prijzen van Zapier, de inkomende webhooks van Slack en de MCP-introductie.