Hoe je webhooks gebruikt in Voluit Suite (Zapier)
Heb je informatie nodig uit een andere applicatie die je gebruikt? Webhooks zijn voor veel gebruikers vaak een van de eerste keuzes, omdat ze je mogelijkheden om informatie van de ene naar de andere plek te sturen enorm vergroten. Als onze krachtige Voluit Suite Workflow Automations een taak niet voor je kunnen uitvoeren - dan kan een webhook dat waarschijnlijk wel... Of komt in ieder geval een heel eind in de goede richting!
In dit artikel laten we je zien hoe je webhooks gebruikt in Voluit Suite.
Wat zijn webhooks?
HTTPS-verzoeken (of webhooks) zijn de motor achter bijna alles waarmee je op internet werkt. Webhooks maken het mogelijk dat applicaties zoals Voluit Suite communiceren met Stripe, Twilio, Mailgun, Zapier en meer. Je hebt in Voluit Suite volledige toegang tot webhooks om jouw zakelijke behoeften werkelijkheid te laten worden!
Webhooks zijn een uitstekende manier om applicaties met elkaar te verbinden. Webhooks zorgen ervoor dat platforms kunnen communiceren om unieke taken uit te voeren door applicaties aan elkaar te koppelen. Hieronder bespreken we veelgebruikte termen bij het werken met webhooks.
Handige definities:
- HTTPS-verzoek - De officiële term voor het type verzoek dat een webhook is. HTTP is de primaire manier om informatie te versturen tussen websites en webbrowsers. HTTPS is een veiligere versie, waarbij de data wordt versleuteld tijdens het verzenden.
- Trigger-event - De unieke gebeurtenis die plaatsvindt en een app signaleert om informatie te sturen naar de webhook-URL van een andere app.
- Webhook-URL - Een unieke URL die wordt aangemaakt door de app die een webhook-verzoek ontvangt. Het is een soort adres of telefoonnummer.
- Payload - Verwijst naar alle informatie die wordt verpakt en van de ene app naar de andere wordt verstuurd.
- Query Params - Net zoals UTM-parameters zijn query params een handige manier om informatie in kaart te brengen met behulp van de webhook-URL. Deze kunnen beter worden gebruikt door de ontvangende applicatie bij het mappen van de payload.
- Mapping - Net als het verbinden van de punten, is mapping het proces waarbij je de ontvangen payload 'mapt' naar de juiste velden voor gebruik in de ontvangende applicatie. Bijvoorbeeld: de payload bevat een contactnaam, e-mailadres en gekochte servicenaam. Je moet deze informatie uit de payload 'mappen' of verbinden met de juiste aangepaste velden voor het contact binnen de Voluit Suite Workflow.
Hoe werken webhooks?
Over het algemeen worden webhooks gebruikt om applicaties te verbinden. Ze hebben een trigger-event nodig dat signaleert dat de ene app het verzoek naar de andere app moet sturen. Bijvoorbeeld: er vindt een aankoop plaats in je betalingssoftware Stripe, die naar Voluit Suite wordt gestuurd. Stripe verpakt de informatie in een "payload" (of de informatie die wordt verstuurd) die naar Voluit Suite wordt gestuurd. In Voluit Suite kan de ontvangen informatie vervolgens worden gebruikt om taken uit te voeren.
Om webhooks te gebruiken, moet één applicatie de webhook-URL aanleveren. Een webhook-URL is een unieke URL die wordt aangemaakt door de app die een webhook-verzoek ontvangt. Het is een soort adres of telefoonnummer. Als je een bedrijf wilt bellen, heb je hun unieke telefoonnummer nodig en soms zelfs een toestel om bij de juiste afdeling te komen. Een webhook-URL werkt ongeveer hetzelfde - het is een uniek telefoonnummer waarmee je een verzoek doet.
Use case voorbeeld
Je hebt een Shopify e-commercewinkel die Stripe gebruikt om betalingen te verwerken. Je wilt Voluit Suite gebruiken om e-mails te sturen naar specifieke gebruikers die een specifieke cursus hebben gekocht. De informatie van de aankopen staat echter niet in Voluit Suite - dus je weet niet wie wat heeft gekocht. Om e-mails te sturen naar de juiste contacten in Voluit Suite, moet je een webhook-event aanmaken dat wordt geactiveerd in Voluit Suite elke keer dat het specifieke product wordt gekocht in Stripe. Voluit Suite kan deze informatie vervolgens gebruiken om specifieke taken uit te voeren, zoals het sturen van e-mails naar die specifieke contacten die het product hebben gekocht.
In dit scenario gebruik je de Voluit Suite Workflow-trigger "inkomende webhook" om de informatie van Stripe op te vangen. Om het makkelijker te maken, raden we aan dat je Zapier of andere automatiseringssoftware gebruikt om te triggeren wanneer de aankoop wordt gedaan in Stripe (als je geen Voluit Suite Order Formulier of Product gebruikt). Wanneer de aankoop wordt gedaan, wordt een payload verpakt met alle informatie die je nodig hebt in Voluit Suite. Voluit Suite vangt de informatie op en ontvangt deze, die wordt gebruikt om je specifieke taken uit te voeren. In dit geval het marketen naar je kopers die dat specifieke product hebben gekocht.
Dat is het overzicht van webhooks, maar er is nog VEEL meer te leren. Voor nu is dit genoeg om je op weg te helpen. Hieronder bespreken we de twee manieren waarop je webhooks kunt gebruiken in Voluit Suite.
Hoe je webhooks gebruikt in Voluit Suite
Er zijn twee manieren om webhooks te gebruiken in Voluit Suite. In mogelijk wat simplistische termen zijn er "opvangen" en "versturen" webhooks.
Twee manieren om webhooks te gebruiken in Voluit Suite:
(A) Inkomende webhook
"Opvangen" van een inkomend webhook-verzoek in een Voluit Suite Workflow-trigger.
Zoals de namen al aangeven, gaat "opvangen" over het ontvangen of "opvangen" van een webhook-verzoek dat wordt gedaan naar de Voluit Suite webhook-URL. In Voluit Suite is dit een Workflow-trigger genaamd "Inkomende webhook".
(B) Uitgaande webhook
"Versturen" van een uitgaand webhook-verzoek met een Voluit Suite Workflow-actie.
In tegenstelling tot de hierboven beschreven "opvang"-beweging... "Versturen" is wanneer je een verzoek doet naar een externe webhook-URL. In Voluit Suite is dit een Workflow-actie genaamd "Webhook".
Hieronder lopen we door elk scenario en hoe je dit uitvoert in Voluit Suite.
Volgorde: Trigger, actie, trigger, actie
Een andere handige manier om over webhooks te leren is door het patroon in de volgorde van bewerkingen te zien die plaatsvinden. Ongeacht of het een inkomende of uitgaande webhook is, hebben we over het algemeen een trigger en actie in één app die vervolgens informatie naar een andere app stuurt. In deze tweede app is er nog een trigger en dan de laatste actie.
Vandaar de titel... Volgorde: "trigger, actie, trigger, actie." Dit geeft de flow aan van webhooks die door beide apps worden gebruikt. Elk heeft een enkele trigger en actie die een verbinding tussen de twee veroorzaakt.
Je ziet hetzelfde patroon in de onderstaande voorbeelden, waarbij de eerste app een trigger en actie heeft --> die een payload stuurt naar de volgende app, wat een inkomende webhook-trigger is gevolgd door nog een actie.
(A) Inkomende webhook
"Opvangen" van een inkomend webhook-verzoek in een Voluit Suite Workflow-trigger.
In dit scenario willen we dat Voluit Suite informatie opvangt van een externe app. De externe app stuurt de payload naar de Voluit Suite webhook-URL die wordt verstrekt wanneer we een Workflow-trigger aanmaken - Inkomende webhook. Ons use case-voorbeeld hierboven is bijvoorbeeld een inkomend webhook-verzoek waarbij we informatie van een externe aankoop naar Voluit Suite sturen om te worden gebruikt voor het uitvoeren van unieke taken voor die specifieke contacten die het product hebben gekocht.
1. Activeer inkomende webhooks
Als dit nog niet geactiveerd is in jouw account, moet je "LC Premium Triggers & Actions" inschakelen om verder te gaan. Om een inkomend verzoek op te vangen, hebben we een "Inkomende webhook" nodig die alleen beschikbaar is bij LC Premium Triggers & Actions.
Wist je dat... De meeste Voluit Suite-gebruikers werken graag met integratie- en automatiseringssoftware zoals Zapier, Make of Pabbly. Deze komen met gebruiksvriendelijkere triggers en acties voor veel applicaties die je misschien al gebruikt. In veel gevallen is het eenvoudiger en krachtiger om een van deze platforms te gebruiken in combinatie met Voluit Suite Workflows.
2. Maak de webhook-URL aan in een Voluit Suite Workflow-trigger
Nu moeten we onze Voluit Suite Workflow openen en de webhook-URL aanmaken. Open/maak je workflow en selecteer "Inkomende webhooks" als de Workflow-trigger. Er wordt een Voluit Suite webhook-URL aangemaakt. Kopieer deze webhook-URL om in de volgende stap te gebruiken.
3. Maak in de externe app een webhook-actiestap aan
In je externe app naar keuze moet je een trigger en webhook-actiestap aanmaken. Bijvoorbeeld: In Zapier kun je een "Payment"-trigger gebruiken die wordt geactiveerd wanneer een betaling wordt gedaan. We kunnen de "Webhooks By Zapier" gebruiken om de payload te POSTen naar de Voluit Suite webhook-URL. Plak de Voluit Suite webhook-URL uit stap twee in de Zapier-actiestap.
Let op: Voluit Suite heet Leadconnector in Zapier
4. Stuur een test
Nu moeten we een voorbeeld-payload naar onze Voluit Suite webhook-URL sturen om verder te kunnen gaan. Ga binnen je externe app, Zapier in dit voorbeeld, naar het einde van de stap en klik op "Test Step". Voor het sturen van een test-payload in Voluit Suite voor een externe app, raadpleeg je de documentatie en support van je externe app. In Voluit Suite blijf je wachten en ververs je de sectie "Mapping Reference" totdat je een "Mapping Reference" in Voluit Suite beschikbaar hebt om te selecteren.
5. Maak/update contact aan
Voor Voluit Suite hebben we een contact nodig voor elke automatisering die draait. Daarom opent "Maak/update contact" automatisch. Je kunt ook de actie "Zoek contact" gebruiken om een contact te vinden op basis van een aangepast veld of een andere waarde. Het is vereist om dit in te vullen, anders werkt dit NIET en zal de Workflow niet functioneren. Maak/update dus minimaal het telefoonnummer of e-mailadres uit de payload van de inkomende webhook of vind een contact op basis van een aangepast veld of iets dergelijks. Een gevonden of gematcht contact is vereist om dit te laten werken.
Nu ben je klaar! Je hebt de informatie in Voluit Suite om te mappen en te gebruiken zoals je wilt binnen de Workflow.
Informatie mappen in Voluit Suite
Nu kun je deze informatie gebruiken binnen "Aangepaste waarden" > "Inkomende webhook-trigger" om de informatie uit de payload te mappen naar de juiste velden of acties in Voluit Suite. Wanneer het draait, wordt de juiste informatie uit de inkomende webhook op de juiste plek in Voluit Suite ingevuld.
(B) Uitgaande webhook
"Versturen" van een uitgaand webhook-verzoek met een Voluit Suite Workflow-actie.
In dit scenario sturen we informatie van een Voluit Suite Workflow-actie naar een externe app. Bijvoorbeeld: wanneer iemand een formulier invult in Voluit Suite, willen we dat deze contactinformatie naar een externe app gaat, zodat we daar de informatie over het contact hebben.
1. Zorg ervoor dat de externe applicatie het ontvangen van webhook-data toestaat
Voor sommige externe applicaties is het ontvangen van data van een webhook een premium-functie. Bij andere apps hoef je alleen de trigger in te schakelen. Je moet de documentatie van de applicatie raadplegen en upgraden indien nodig. In Zapier, dat we in dit voorbeeld gebruiken, moet je een betaald account hebben om inkomende webhooks (bekend als Catchhooks) by Zapier te gebruiken.
Zie je geen webhooks in je externe app?
In sommige gevallen zijn webhooks mogelijk niet beschikbaar in veel externe apps voor jou om te gebruiken. In deze gevallen kun je automatiserings-/integratiesoftware zoals Zapier, Pabbly of Make gebruiken om de informatiekloof tussen je apps te overbruggen.
2. Maak een webhook-URL aan in de externe app
Maak binnen je externe app een trigger aan voor de inkomende webhook. Na het aanmaken van deze trigger zou je een webhook-URL gegenereerd moeten hebben om in latere stappen te gebruiken. Bijvoorbeeld: In Zapier kun je de "Webhooks By Zapier"-trigger gebruiken met het "Catch Hook"-event. Ga verder naar de trigger-stap. Kopieer de webhook-URL die is gegenereerd door de externe app.
3. Voeg de externe webhook-URL toe aan je Voluit Suite Workflow-actie
Nu kunnen we de externe webhook-URL toevoegen aan een Voluit Suite Workflow-actie. Maak je Voluit Suite Workflow aan of open deze. Voeg de externe webhook-URL toe aan een Voluit Suite Workflow-actie. Sla de workflow op en publiceer deze.
4. Stuur een test van Voluit Suite naar de externe app
Nu hebben we wat voorbeeldinformatie nodig van Voluit Suite naar de externe app. Om dit te doen, moeten we de workflow triggeren. We kunnen bijvoorbeeld een testaankoop doen zodat de Workflow-trigger deze informatie naar Zapier stuurt. Het is het beste om de workflow-trigger uit te voeren alsof het een live-actie is van wat er zal gebeuren. Dit komt omdat je alle voorbeelddata in de payload wilt hebben wanneer je het gaat gebruiken in de externe app.
Blijf testen totdat je de informatie succesvol naar de externe app hebt gestuurd en deze is ontvangen door de externe app.
Goed gedaan! Nu elke keer dat de Voluit Suite Workflow triggert, stuurt deze informatie naar je externe app voor gebruik. Binnen Zapier kun je deze informatie nu gebruiken om spreadsheets te vullen of andere unieke taken uit te voeren.
Informatie mappen in Zapier
Selecteer een veld om bij te werken in je Zapier-actie, en dan verschijnt een pop-up met "Insert Data" waarmee je een placeholder (of aangepaste waarde zoals het bekend is in Voluit Suite) binnen de Zapier-actie kunt selecteren om de informatie in de payload te mappen. Dit stempelt de data die je wilt tijdens elke run van deze webhook, zodat de juiste informatie uit Voluit Suite de juiste plekken bijwerkt in Zapier of je andere externe app.
Veelgestelde vragen
Wat is Zapier, Make of Pabbly?
Zapier, Make of Pabbly zijn allemaal automatiserings- en integratiesoftware. Dat betekent dat ze bestaan om applicaties met elkaar te verbinden. Ze doen dit met vooraf gebouwde verbindingen naar apps die je erin kunt integreren. Na het integreren kun je een aantal triggers en acties gebruiken - net zoals je kunt in Voluit Suite Workflows. Dit zijn echter triggers en acties voor andere applicaties.
Wist je bijvoorbeeld dat we integraties hebben met deze software? Bezoek de onderstaande links van de meest gebruikte platforms die we Voluit Suite-gebruikers hebben zien gebruiken.
Let op: Voluit Suite heet Leadconnector in externe tools.
Wat deze krachtiger maakt, is het combineren van deze vooraf gebouwde triggers en acties met webhook-acties. Dit opent een hele wereld aan mogelijkheden. Je kunt zeker niet alles... Maar het is beter dan een custom integratie vanaf nul coderen met een API. Ze zijn tenminste vooraf gebouwd en met webhooks kunnen de meeste van je taken volledig (of gedeeltelijk) worden geautomatiseerd.
Aan de slag met Zapier
Zapier is een van de meest gebruikte automatiserings- en integratiesoftware. Met duizenden vooraf gebouwde triggers en acties tussen apps of platforms is het een handig hulpmiddel. Als je aan de slag gaat met Zapier en niet zeker weet hoe je het moet gebruiken, bekijk dan hun snelle en informatieve cursussen.
https://zapier.com/resources/guides/quick-start/automation-basics
https://learn.zapier.com/intro-to-automation
https://learn.zapier.com/path/a-complete-guide-to-lead-management
Bekijk deze links hierboven om vandaag nog aan de slag te gaan met Zapier!
Wat zijn query params?
Query params zijn een handige manier om informatie door te geven via een webhook. Het werkt vergelijkbaar met UTM-parameters, omdat ze informatie toevoegen die door de ontvangende applicatie wordt gebruikt. Bijvoorbeeld: ClickUp is een populaire taakbeheer-app. Wanneer je informatie van ClickUp naar Voluit Suite stuurt, komt het aangepaste veld niet netjes binnen. Dat is vervelend, want aangepaste velden zijn een cruciaal onderdeel van de informatie die we nodig hebben. Daarom kunnen we de informatie die we nodig hebben beter doorgeven met query params.
Je hoeft alleen maar een query key en de aangepaste waarde toe te voegen aan de webhook-URL. Bijvoorbeeld: onze webhook-URL is "https://services.leadconnectorhq.com/hooks/pgWooooooooG57D/webhook-trigger/ce000-800f-4bec-0090-f000000000"; en dan kunnen we een query key en waarde toevoegen aan de URL zoals "https://services.leadconnectorhq.com/hooks/pgWooooooooG57D/webhook-trigger/ce000-800f-4bec-0090-f000000000?custom_field={{click.up.custom.field.value}}"
Nadat je dit naar Voluit Suite hebt gestuurd, kun je de query parameter netjes selecteren. Je kunt er zoveel toevoegen als je wilt.
Wat zijn de verschillen tussen API en webhooks?
Application Programming Interface (API) is de backend (of achterdeur) verbinding tussen apps. Als je iets niet direct binnen de app kunt doen, is de kans groot dat je API-documentatie kunt vinden die je helpt het te bereiken of er dichtbij te komen. Het probleem is dat API complex is om te gebruiken, vandaar de term "taal". Het is een aparte (en complexe) taal die tussen apps wordt gesproken en die je zou moeten leren om te gebruiken. Om het nog ingewikkelder te maken, heeft elke app zijn eigen unieke dialect of manier om deze talen te spreken. API is moeilijk te gebruiken maar wel krachtig en het overwegen waard.
Webhooks daarentegen zijn wat gebruiksvriendelijker. Ze hebben een triggerende gebeurtenis nodig en worden gebruikt om informatie te versturen als reactie op een trigger - zoals het invullen van een formulier, klikken op een link, etc. Vergeleken met API vereisen webhooks veel minder kennis om te gebruiken. Webhooks zijn veel eenvoudiger te gebruiken dan API, daarom worden ze aanbevolen voordat je naar een API-verbinding zoekt.