Met webhooks kan Smartsupp realtime notificaties naar een URL naar keuze sturen — zodra een gesprek wordt geopend, een contact wordt aangemaakt of een bericht wordt afgeleverd, weet je systeem ervan. Dit artikel legt uit wat webhooks zijn, hoe je ze in je dashboard instelt en hoe je ze verbindt met automatiseringsplatforms zoals Make en n8n.
We hebben het artikel in een aantal onderdelen verdeeld:
Waarvoor kun je webhooks gebruiken?
Een webhook is een automatisch HTTP-bericht dat Smartsupp naar een URL naar keuze stuurt wanneer een geselecteerde gebeurtenis plaatsvindt. In plaats van steeds op wijzigingen te controleren, ontvangen je tools de gegevens direct zodra er iets gebeurt.
Veelvoorkomende toepassingen zijn:
Automatiseringsplatforms — start workflows in Make, n8n of vergelijkbare tools om contacten aan een CRM toe te voegen, notificaties in Slack te plaatsen of leads in een spreadsheet vast te leggen
Interne systemen — stuur gespreks- en contactgegevens in realtime naar dashboards, datawarehouses of ticketsystemen
Notificaties — waarschuw je team wanneer gesprekken worden beoordeeld of wanneer het afleveren van berichten mislukt
Tip: Webhooks zijn beschikbaar bij het Plus-pakket en hoger — Plus bevat 1 webhook, Expert bevat 3 en Ultimate biedt een aangepaste limiet. Pakketten vergelijken →
Een webhook aanmaken
Je stelt een webhook in met slechts 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 voer je Endpoint-URL in — het adres waarnaar Smartsupp gebeurtenisgegevens stuurt.
3. Selecteer de Gebeurtenissen die je wilt ontvangen (zie de volledige lijst in het volgende onderdeel).
4. Sla de webhook op. Vanaf dat moment worden de geselecteerde gebeurtenissen afgeleverd als HTTP POST-verzoeken met JSON-payloads.
Opmerking: Eerder geconfigureerde webhooks blijven normaal werken. Er wordt aan gewerkt om alle bestaande webhooks zichtbaar en beheerbaar te maken vanuit de nieuwe dashboardsectie.
⚠️ Heb je eerder webhooks aangemaakt? Oudere webhooks worden nog niet in deze sectie weergegeven — 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 op de hoogte stellen van gebeurtenissen in drie categorieën. Selecteer alleen de gebeurtenissen die je workflow daadwerkelijk nodig heeft — zo beperk je de belasting van je endpoint 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-ontwikkelaarsdocumentatie — volledige JSON-payloadschema's voor elk gebeurtenistype.
Je webhook testen
Gebruik voordat je live gaat de ingebouwde testfunctie om te controleren of je endpoint bereikbaar is en je Make- of n8n-scenario correct is ingesteld.
Klik in de webhookinstellingen in het dashboard op Test verzenden. Smartsupp stuurt een voorbeeldpayload naar je endpoint-URL. Controleer in je ontvangende service of de gegevens in het verwachte formaat zijn aangekomen.
Tip: In Make moet je scenario actief zijn en luisteren voordat je de test verzendt. Schakel in n8n de Webhook-node over naar de productie-URL en zorg dat de workflow actief is.
Aflevering, nieuwe pogingen en beveiliging
Smartsupp is ontworpen om webhookgebeurtenissen betrouwbaar af te leveren, ook wanneer je endpoint tijdelijk niet beschikbaar is.
Formaat — alle gebeurtenissen worden verzonden als HTTP POST-verzoeken met een JSON-body die de gebeurtenis en de bijbehorende gegevens beschrijft
Reactie — je endpoint moet zo snel mogelijk reageren met een 2xx HTTP-statuscode; trage reacties kunnen nieuwe pogingen vertragen
Nieuwe pogingen — als de aflevering mislukt, probeert Smartsupp het opnieuw met steeds langere tussenpozen, gedurende maximaal 3 dagen
Automatisch uitschakelen — endpoints die aanhoudend falen, worden automatisch uitgeschakeld; je kunt ze op elk moment opnieuw inschakelen in het dashboard
Beveiliging — elk webhookverzoek wordt ondertekend, zodat je kunt controleren of het daadwerkelijk van Smartsupp afkomstig is; zie docs.smartsupp.com voor details over de verificatie van de handtekening
Opmerking: Als je endpoint is uitgeschakeld vanwege herhaalde fouten, schakel het dan opnieuw in via Instellingen → Webhooks nadat je het onderliggende probleem hebt opgelost. Smartsupp hervat het verzenden van gebeurtenissen onmiddellijk.
Smartsupp verbinden met Make of n8n
Je verbindt Smartsupp met een automatiseringsplatform in vier stappen. Het proces is hetzelfde voor Make en n8n — alleen de triggernode verschilt.
1. In Makevoeg je een Webhooks → Aangepaste webhook -trigger toe en kopieer je de gegenereerde URL. In n8nvoeg je een Webhook -triggernode toe en kopieer je de productie-URL ervan.
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 verzenden zodat Make of n8n de gegevensstructuur vastlegt — bouw vervolgens de rest van je scenario of workflow daarop voort.
Tip: Activeer in Make je scenario voordat je de test verzendt — anders worden de webhookgegevens niet vastgelegd. Gebruik in n8n de productie -URL (niet de test-URL) wanneer je de Smartsupp-webhook instelt.
Wat nu?
Smartsupp REST API — ontdek de volledige API om Smartsupp-gegevens programmatisch te lezen en te schrijven.
Automatisaties — stel regelgebaseerde automatisaties in die rechtstreeks binnen Smartsupp worden geactiveerd, zonder externe tool.
Integratieoverzicht — bekijk alle beschikbare native integraties met CRM's, e-commerceplatforms en meer.
💡 Meer hulp nodig? Neem contact op met ons Supportteam — we helpen je graag!