Met webhooks stuurt Smartsupp realtime meldingen naar een URL naar keuze – op het moment dat een gesprek wordt geopend, een contact wordt aangemaakt of een bericht wordt afgeleverd, weet jouw systeem ervan. In dit artikel lees je wat webhooks zijn, hoe je ze instelt in je dashboard en hoe je ze koppelt aan automatiseringsplatformen zoals Make en n8n.
We hebben het artikel opgedeeld in een paar secties:
Waar zijn webhooks goed voor?
Een webhook is een automatisch HTTP-bericht dat Smartsupp naar een URL naar keuze stuurt zodra een geselecteerde gebeurtenis plaatsvindt. In plaats van zelf te blijven controleren op wijzigingen, krijgen je tools de gegevens direct toegestuurd op het moment dat er iets gebeurt.
Typische toepassingen zijn:
Automatiseringsplatformen – workflows starten in Make, n8n of vergelijkbare tools om contacten toe te voegen aan een CRM, meldingen naar Slack te sturen of leads in een spreadsheet te loggen
Interne systemen – gespreks- en contactgegevens realtime doorsturen naar dashboards, datawarehouses of ticketsystemen
Meldingen – je team waarschuwen wanneer gesprekken worden beoordeeld of wanneer het afleveren van een bericht mislukt
Tip: Webhooks zijn beschikbaar vanaf het Plus-pakket – Plus bevat 1 webhook, Expert bevat er 3 en Ultimate biedt een limiet op maat. Pakketten vergelijken →
Een webhook aanmaken
Een webhook instellen kost maar een paar stappen in je Smartsupp-dashboard:
1. Open Instellingen en ga naar de sectie Webhooks.
2. Klik om een nieuwe webhook toe te voegen en vul je endpoint-URL in – het adres waar Smartsupp de gebeurtenisgegevens naartoe stuurt.
3. Selecteer de gebeurtenissen die je wilt ontvangen (zie de volledige lijst in de volgende sectie).
4. Sla de webhook op. Vanaf dat moment worden de geselecteerde gebeurtenissen afgeleverd als HTTP POST-verzoeken met een JSON-payload.
Let op: Eerder ingestelde webhooks blijven gewoon werken. We werken eraan om alle bestaande webhooks zichtbaar en beheerbaar te maken vanuit de nieuwe sectie in het dashboard.
⚠️ Heb je in het verleden webhooks aangemaakt? Oudere webhooks verschijnen nog niet in deze sectie – ze blijven werken zoals voorheen. We voegen het oude en het nieuwe systeem samen, zodat je alles op één plek kunt beheren.
Beschikbare gebeurtenissen
Smartsupp kan je endpoint informeren over gebeurtenissen in drie categorieën. Selecteer alleen de gebeurtenissen die je workflow echt nodig heeft – zo houd je je endpoint overzichtelijk en voorkom je onnodig verkeer.
Contacten
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Gesprekken
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Bezoekers
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Gerelateerde bronnen: Smartsupp-documentatie voor ontwikkelaars – volledige JSON-payloadschema's voor elk type gebeurtenis.
Je webhook testen
Gebruik voordat je live gaat de ingebouwde testfunctie om te controleren of je endpoint bereikbaar is en of je scenario in Make of n8n goed is ingesteld.
Klik in de webhook-instellingen in je dashboard op Test versturen. Smartsupp stuurt dan een voorbeeld-payload naar je endpoint-URL. Controleer in je ontvangende dienst of de gegevens in het verwachte formaat zijn aangekomen.
Tip: In Make moet je scenario actief zijn en luisteren voordat je de test verstuurt. Zet in n8n de Webhook-node op de productie-URL en zorg dat de workflow actief is.
Aflevering, nieuwe pogingen en beveiliging
Smartsupp is erop gebouwd om webhook-gebeurtenissen betrouwbaar af te leveren, ook wanneer je endpoint tijdelijk onbereikbaar is.
Formaat – alle gebeurtenissen worden verstuurd als HTTP POST-verzoeken met een JSON-body die de gebeurtenis en de bijbehorende gegevens beschrijft
Reactie – je endpoint moet zo snel mogelijk antwoorden met een 2xx HTTP-statuscode; trage reacties kunnen nieuwe pogingen vertragen
Nieuwe pogingen – als de aflevering mislukt, probeert Smartsupp het opnieuw met oplopende tussenpozen, tot 3 dagen lang
Automatisch uitschakelen – endpoints die blijvend falen, worden automatisch uitgeschakeld; je kunt ze op elk moment weer inschakelen in het dashboard
Beveiliging – elk webhook-verzoek is ondertekend, zodat je kunt verifiëren dat het echt van Smartsupp komt; zie docs.smartsupp.com voor de details over het verifiëren van de handtekening
Let op: Is je endpoint uitgeschakeld door herhaalde fouten? Schakel het na het oplossen van de oorzaak weer in via Instellingen → Webhooks. Smartsupp begint dan meteen weer met het versturen van gebeurtenissen.
Smartsupp koppelen aan Make of n8n
Smartsupp koppelen aan een automatiseringsplatform kost vier stappen. Het proces is hetzelfde voor Make en n8n – alleen de trigger-node verschilt.
1. Voeg in Make een trigger Webhooks → Custom webhook toe en kopieer de gegenereerde URL. Voeg in n8n een Webhook-triggernode toe en kopieer de productie-URL.
2. Ga in Smartsupp naar Instellingen → Webhooks, maak een nieuwe webhook aan en plak de gekopieerde URL.
3. Selecteer de gebeurtenissen die je nodig hebt en sla de webhook op.
4. Klik op Test versturen, zodat Make of n8n de datastructuur vastlegt – bouw daarop vervolgens de rest van je scenario of workflow.
Tip: Activeer in Make je scenario voordat je de test verstuurt – anders worden de webhookgegevens niet vastgelegd. Gebruik in n8n de productie-URL (niet de test-URL) bij het instellen van de Smartsupp-webhook.
Wat is de volgende stap?
Smartsupp REST API – ontdek de volledige API om Smartsupp-gegevens programmatisch te lezen en te schrijven.
Automatiseringen – stel automatiseringen op basis van regels in die rechtstreeks binnen Smartsupp worden getriggerd, zonder externe tool.
Overzicht van integraties – bekijk alle beschikbare native integraties met CRM's, e-commerceplatformen en meer.
💡 Meer hulp nodig? Neem contact op met ons supportteam – we helpen je graag!