Een webhook zorgt ervoor dat je real-time informatie kunt uitwisselen tussen je chatbot en externe applicaties. In dit artikel leggen we je uit hoe je kunt beginnen met webhooks.
Wat zijn webhooks?
Een webhook wordt ook wel een ‘HTTP push’ of een ‘web callback’ genoemd. Een webhook bouwt eigenlijk een bruggetje tussen twee programma's, en zorgt ervoor dat er automatisch real-time informatie uitgewisseld kan worden. In dit geval: tussen de chatbot en externe applicaties.
Hoe begin ik met webhooks?
Het is allereerst belangrijk dat je goed nadenkt over welke informatie je graag wilt terugzien, en vanuit welk systeem. Wil je bijvoorbeeld de orderstatus ophalen vanuit jouw CRM-systeem? Denk dan goed na welke gegevens de chatbot moet opvragen om dit te kunnen laten zien. Denk hierbij aan een ordernummer en/of een e-mailadres.
Voordat je aan de slag kunt gaan met webhooks, is het belangrijk dat je de juiste vrije velden aanmaakt in het Watermelon platform. Ten eerste een vrij veld wat de "trigger" veroorzaakt om de data op te halen. Wanneer dit veld wordt ingevuld (bijvoorbeeld "Postcode"), zal de informatie opgehaald worden vanuit het externe systeem. Ten tweede heb je een vrij veld nodig, die vervolgens de opgehaalde informatie kan weergeven.
Even kwijt hoe je vrije velden aanmaakt? In dit artikel leggen we je uit hoe je dit doet!
Let op: elke applicatie heeft een beveiliging op het ophalen van data. Het kan dus zijn dat er meerdere vrije velden nodig zijn als "trigger".
Hoe maak ik een webhook?
Om een webhook te kunnen maken, zul je eerst een API-key in het Watermelon platform moeten aanmaken. Een volledige uitleg hoe je dit doet, vind je hier.
Om verder te gaan met het bouwen van de webhook, moet je kunnen programmeren. Bespreek de mogelijkheden met jouw (externe) developer.
De volledige API documentatie voor het creëren van een webhook vind je hier. Stuur deze documentatie, inclusief de API- en Secret key door naar je developer.
Wanneer jouw (externe) developer de webhook heeft aangemaakt, kun je de vrije velden gebruiken in je dialogue builder. Hoe je dit doet, leggen we uit in dit artikel.
Help, ik vind de opmaak van de opgehaalde informatie niet mooi
De chatbot laat de opgehaalde data zien zoals het wordt opgehaald vanuit het externe systeem. Het kan zijn dat dit niet zo'n fraaie lay-out heeft. Jouw developer kan zelf bepalen hoe de opmaak van deze data is. Vraag je developer dit dus aan te passen!