Een webhook-koppeling instellen
Met een webhook-koppeling stuur je contactgegevens die je AI Agent verzamelt automatisch door naar een extern systeem, zoals je CRM, marketingtool of intern platform. Zo hoef je niets meer handmatig over te nemen en komen leads direct op de juiste plek terecht.
In dit artikel leggen we stap voor stap uit hoe je een webhook-koppeling instelt vanuit Heyloha.
Wat is een webhook?
Een webhook is een manier om automatisch gegevens van het ene systeem naar het andere te sturen. Zodra je AI Agent de benodigde contactgegevens heeft verzameld, stuurt Heyloha die gegevens via een HTTP POST-verzoek naar de URL die jij hebt ingesteld. Het ontvangende systeem verwerkt de gegevens vervolgens, bijvoorbeeld door een nieuw contact aan te maken in je CRM.
Wat heb je nodig?
- Een actief Heyloha-account met minimaal een AI Agent.
- Een extern systeem dat webhooks ondersteunt (bijvoorbeeld een CRM, marketingplatform of eigen applicatie).
- De webhook-URL van het ontvangende systeem, inclusief eventuele parameters.
De webhook-functie moet ingeschakeld zijn op bedrijfsniveau. Zie je de optie 'Koppelingen' niet in het menu van je AI Agent? Neem dan contact op met je beheerder.
Webhook-koppeling instellen
Ga naar je AI Agent
Open het Heyloha-dashboard en klik op de AI Agent waarvoor je de koppeling wilt instellen.
Open het menu 'Koppelingen'
In het zijmenu van je AI Agent vind je de optie 'Koppelingen'. Klik hierop om het overzicht te openen.
Klik op 'Integratie toevoegen'
Je komt nu in een stapsgewijs formulier om een nieuwe webhook-koppeling aan te maken.
Plak de webhook-URL
Kopieer de volledige webhook-URL uit het ontvangende systeem en plak deze in het veld. De URL bevat vaak parameters zoals 'company' en 'webhook'. Heyloha herkent de URL en de bijbehorende parameters automatisch.
Geef de integratie een naam
Kies een herkenbare naam, bijvoorbeeld 'CRM Lead doorsturen' of 'Offerte-aanvraag'. Deze naam wordt ook gebruikt als interne functienaam voor je AI Agent.
Selecteer contactvelden
Kies welke gegevens je AI Agent moet verzamelen en doorsturen. Je kunt kiezen uit: voornaam, achternaam, e-mailadres, telefoonnummer, adres, postcode, stad en land.
Beschrijf wanneer de koppeling gebruikt moet worden
Geef een korte beschrijving van wanneer je AI Agent deze koppeling moet activeren, bijvoorbeeld: 'Gebruik deze koppeling wanneer een bezoeker interesse toont in een bezichtiging en zijn contactgegevens achterlaat.'
Sla op en activeer
Zet de koppeling op 'Actief' en klik op Opslaan. Vergeet niet om daarna ook de AI Agent zelf op te slaan, zodat de wijzigingen actief worden.
Wijzigingen aan koppelingen worden pas actief nadat je de AI Agent opslaat. Vergeet deze stap niet!
Welke contactgegevens kun je doorsturen?
Je bepaalt zelf welke velden je AI Agent verzamelt en doorstuurt via de webhook. De beschikbare velden zijn:
- Voornaam
- Achternaam
- E-mailadres
- Telefoonnummer
- Adres
- Postcode
- Stad
- Land
Selecteer minimaal een veld. De AI Agent vraagt deze gegevens op een natuurlijke manier uit tijdens het gesprek en stuurt ze automatisch door zodra het doel is bereikt.
Hoe werkt het in de praktijk?
Zodra een bezoeker in gesprek is met je AI Agent en de juiste gegevens achterlaat, stuurt Heyloha automatisch een bericht naar de ingestelde webhook-URL. Het ontvangende systeem verwerkt de contactgegevens, zodat je team direct kan opvolgen.
- Een websitebezoeker start een gesprek met je AI Agent.
- De AI Agent herkent het doel (bijvoorbeeld: lead doorsturen) en vraagt de benodigde gegevens.
- Na het verzamelen van de gegevens stuurt Heyloha ze via de webhook naar het externe systeem.
- Het ontvangende systeem verwerkt de gegevens (bijvoorbeeld: nieuw contact aanmaken).
- Je team krijgt direct een melding en kan de lead opvolgen.
Koppelingen beheren
In het overzicht 'Koppelingen' zie je al je actieve en inactieve webhook-koppelingen. Hier kun je:
- Een koppeling bewerken (URL, naam, velden of beschrijving aanpassen).
- Een koppeling (de)activeren via de statusschakelaar.
- Een koppeling verwijderen als je deze niet meer nodig hebt.
Je kunt meerdere webhook-koppelingen per AI Agent instellen, elk met een eigen doel en set contactvelden. Zo kun je bijvoorbeeld een koppeling voor bezichtigingen en een aparte koppeling voor offerteaanvragen configureren.
Voorbeelden van webhook-koppelingen
- CRM-systeem: Leads automatisch doorsturen naar je klantenbeheersysteem.
- E-mailmarketingtool: Nieuwe contacten toevoegen aan een mailinglijst.
- Intern platform: Bezichtigingsaanvragen of offerteaanvragen doorsturen naar het juiste team.
- Helpdesk: Supporttickets aanmaken op basis van gesprekken met je AI Agent.
Veelgestelde vragen
Kan ik de webhook testen?
Ja. Sla de koppeling op en sla je AI Agent op. Start vervolgens een testgesprek met je AI Agent en laat de benodigde gegevens achter. Controleer in het ontvangende systeem of de gegevens correct zijn binnengekomen.
Wat als de webhook niet werkt?
Controleer of de webhook-URL correct is, de koppeling op 'Actief' staat, en of je de AI Agent hebt opgeslagen na het aanmaken van de koppeling. Controleer ook in het ontvangende systeem of de webhook daar actief is.
Welke systemen worden ondersteund?
De webhook-koppeling werkt met elk systeem dat een HTTP POST-verzoek kan ontvangen met formulierdata. Denk aan CRM-systemen, marketingtools, interne applicaties en meer.
Hoeveel koppelingen kan ik instellen?
Er is geen limiet. Je kunt meerdere koppelingen per AI Agent instellen, elk met een eigen doel en contactvelden.
Doelen instellen voor je AI AgentWebhook instellen met KeyVue