Webhook instellen met KeyVue
Gebruik je KeyVue als CRM? Dan kun je je Heyloha AI Agent direct koppelen aan KeyVue via een webhook. Leads die je AI Agent verzamelt, worden dan automatisch als nieuwe lead in KeyVue aangemaakt, inclusief de juiste status, bron en prioriteit.
In dit artikel lees je hoe je eerst een webhook aanmaakt in KeyVue en deze vervolgens koppelt in Heyloha.
Lees eerst het artikel 'Een webhook-koppeling instellen' als je nog niet bekend bent met webhooks in Heyloha.
Stap 1: Webhook aanmaken in KeyVue
In KeyVue maak je een webhook aan onder Instellingen > Smart Marketing > Webhooks. Klik op 'Nieuwe webhook aanmaken' en stel het volgende in:
- Naam: een herkenbare naam voor intern gebruik (bijvoorbeeld 'Heyloha Chat Leads').
- Type lead: welk soort lead wil je aanmaken bij binnenkomst.
- Status: moet de lead binnenkomen als 'Nieuw' of als 'Kans'.
- Bron: waar komt de lead vandaan (bijvoorbeeld 'Website Chat' of 'AI Agent').
- Opmerking: een standaard opmerking die bij elke lead wordt geplaatst.
- Prioriteit: de prioriteit van de binnenkomende lead.
- Kans van slagen: een inschatting van de slagingskans voor dit type leads.
Klik op Opslaan. Je komt terug in het overzicht van webhooks.
Stap 2: Webhook-URL kopieren
In het overzicht van webhooks zie je de zojuist aangemaakte webhook. Klik op 'Kopieer webhook url'. De URL wordt naar je klembord gekopieerd. Deze URL bevat een unieke verwijzing naar de webhook die je hebt ingesteld, inclusief alle instructies voor KeyVue.
De webhook-URL ziet er bijvoorbeeld zo uit: https://app.keyvue.nl/webhook?company=jouwbedrijf&webhook=abc123. Bewaar deze URL goed, je hebt hem zo nodig in Heyloha.
Stap 3: Koppeling aanmaken in Heyloha
Open je AI Agent in Heyloha
Ga naar het Heyloha-dashboard en open de AI Agent die je wilt koppelen aan KeyVue.
Ga naar 'Koppelingen'
Klik in het zijmenu op 'Koppelingen' en klik op 'Integratie toevoegen'.
Plak de KeyVue webhook-URL
Plak de URL die je in stap 2 hebt gekopieerd. Heyloha herkent automatisch de 'company' en 'webhook' parameters en toont 'Link herkend'.
Geef de integratie een naam
Kies een duidelijke naam, bijvoorbeeld 'KeyVue Lead' of 'CRM Bezichtiging'. Deze naam wordt ook de functienaam die je AI Agent gebruikt.
Selecteer contactvelden
Kies welke gegevens je AI Agent moet verzamelen: voornaam, achternaam, e-mail, telefoon, adres, postcode, stad of land.
Beschrijf het gebruiksmoment
Leg uit wanneer je AI Agent deze koppeling moet activeren. Bijvoorbeeld: 'Stuur de contactgegevens naar KeyVue wanneer een bezoeker interesse toont in een woning en zijn gegevens achterlaat.'
Activeer en sla op
Zet de koppeling op 'Actief', klik op Opslaan, en sla daarna ook de AI Agent op.
Wat gebeurt er als een lead binnenkomt?
- Een bezoeker start een gesprek met je AI Agent op je website.
- De AI Agent verzamelt de contactgegevens tijdens het gesprek.
- Heyloha stuurt de gegevens via de webhook naar KeyVue.
- KeyVue maakt automatisch een nieuwe lead aan met de ingestelde status, bron en prioriteit.
- Je team ziet de lead direct in KeyVue en kan opvolgen.
Tips voor de praktijk
- Maak aparte webhooks in KeyVue voor verschillende typen leads, bijvoorbeeld een voor bezichtigingsaanvragen en een voor waardebepaling.
- Stel de bron in KeyVue in op iets herkenbaars, zoals 'Heyloha Chat' of 'AI Website Agent', zodat je in rapportages kunt zien waar leads vandaan komen.
- Test de koppeling door een gesprek te voeren met je AI Agent en te controleren of de lead correct in KeyVue verschijnt.
Veelgestelde vragen
Kan ik meerdere KeyVue webhooks koppelen aan dezelfde AI Agent?
Ja. Je kunt meerdere koppelingen instellen per AI Agent, elk met een eigen KeyVue webhook-URL. Zo kun je verschillende typen leads naar verschillende webhooks in KeyVue sturen.
Komen de leads direct in KeyVue binnen?
Ja. Zodra je AI Agent de gegevens heeft verzameld en de webhook wordt geactiveerd, verschijnt de lead vrijwel direct in KeyVue.
Wat als ik de webhook-instellingen in KeyVue wijzig?
De webhook-URL blijft hetzelfde. Als je in KeyVue de instellingen wijzigt (bijvoorbeeld status of bron), worden toekomstige leads met de nieuwe instellingen aangemaakt. Je hoeft in Heyloha niets aan te passen.
Een webhook-koppeling instellen