Met het Webhook blok trigger je een campagneflow vanuit een extern systeem. Zodra er een specifieke gebeurtenis plaatsvindt in een derde partij applicatie, zoals het aanmaken van een lead, stuurt dat systeem automatisch een melding via een URL naar Ternair, waarna de flow wordt gestart.

Met het Webhook blok stel je een doelgroep samen op basis van contacten die worden doorgegeven uit de webhook.

Voorwaarden
Voordat je het Webhook blok kunt gebruiken, moet er minimaal één webhook zijn geconfigureerd in de Algemene Instellingen. Voor meer informatie over het configureren van webhooks kun je onderstaande link raadplegen.

Webhook blok toevoegen

Sleep het Webhook blok vanuit de categorie Kies ontvangers in het menu naar het werkblad; het blok opent automatisch.

Titel

Boven in je scherm zie je de titel van het blok (standaard: Webhook). Deze kun je aanpassen.

Geavanceerde modus

Rechtsboven in je scherm vind je de schakelaar Geavanceerde modus.

Als je de checkbox ‘Geavanceerde modus’ aanvinkt, verschijnt de mogelijkheid om het doelgroepblok op te slaan als template. Naast de button Opslaan verschijnen drie puntjes waarmee je een extra optie kunt openen om het blok op te slaan als template.

Selecteer Webhook

Selecteer via het dropdown menu Selecteer Uit: Webhook de webhook die je wilt gebruiken.

Tabbladen

Het instellingenscherm van het Webhook blok bevat de volgende twee tabbladen:

Tab	Omschrijving
Instellingen	De webhook selecteren die je wilt gebruiken.
Notificaties	Instellen wie een notificatie-e-mail ontvangt bij een fout-situatie.

Notificatie

Op het tabblad Notificaties geef je aan of er een notificatie-e-mail moet worden verstuurd wanneer er een fout optreedt in het Webhook blok. Geef bij Verstuur notificaties naar één of meerdere e-mailadressen op en vink vervolgens Verstuur notificatie bij een fout-situatie aan.

Na het aanvinken verschijnt een verplicht veld Onderwerp met een standaardtekst. Deze tekst kun je aanpassen. Velden tussen blokhaken worden bij verzending vervangen door de actuele waarden. Standaard is het onderwerp gevuld met het betreffende selectie- en bloknummer: Fout in selectie [SelectionId] blok [BlockNumber].

De volgende velden zijn beschikbaar: [ExecutionCode], [SelectionId], [BlockNumber], [BlockDescription], [CampaignCode], [User], [IsStart] en [ErrorMessageHtml].

Opslaan / annuleren

Het Leads blok wordt opgeslagen en berekend nadat je op de knop ‘Opslaan hebt geklikt. Gebruik de knop ‘Annuleren’ om je wijzigingen ongedaan te maken.

Webhook blok verbinden

Na het opslaan kun je het Leads blok gebruiken als input voor andere blokken. Verbind blokken door een lijn te trekken van het Leads blok naar een volgend kanaalblok.

Webhook blok openen

De eerste keer dat je een Webhook blok in de flow sleept, opent het blok automatisch. Als je een bestaand Webhook blok wilt openen, dubbelklik je op het blok of klik je op de drie puntjes rechtsboven in het blok.

Er verschijnt een contextmenu met de volgende opties:

Optie	Beschrijving
Webhook uitvoeren	Met deze knop voer je de webhook uit
Opslaan als template	Klik op de drie puntjes bij de knop Opslaan om op te slaan als template (Alleen beschikbaar als de ‘Geavanceerde modus’ is ingeschakeld)
Verwijder	Verwijder het blok uit de flowchart
Knippen	Knip het blok om het elders te plakken
Kopieer	Maak een kopie van het blok
Instellingen	Open de instellingen van het blok

Webhook preview (oog-icoon)

Nadat je het Webhook blok hebt opgeslagen, wordt het oog-icoon blauw.

Door op het oog-icoon te klikken, verschijnt er een preview van de geselecteerde doelgroep.

De preview toont de volgende informatie:

Aantal rijen

Het aantal contacten in de doelgroep.

Data van doelgroep

Gegevens van de geselecteerde contacten, zoals e-mailadres.

NL---Webhook---Oogje---Bijbehorende-data-zonder-rood1.png

Bekijk meer data

Klik op de knop ‘Bekijk meer data’ om een uitgebreid overzicht met aanvullende gegevens van de doelgroep te openen.

Data verversen

Klik op het ververs-icoon om de data opnieuw op te halen (bijvoorbeeld na recente wijzigingen).

Scherm sluiten

Sluit de preview door op het kruisje rechtsboven te klikken of via de knop Sluiten.

Webhook URL (driehoek icoon)

Klik op het driehoek icoon om de URL te kopiëren die vanuit de webhook wordt aangeroepen. Het Webhook blok maakt het mogelijk om een campagneflow in Ternair te starten op basis van gebeurtenissen uit een extern systeem. Wanneer daar bijvoorbeeld een lead wordt aangemaakt, stuurt dat systeem automatisch een melding via de URL naar Ternair, waarna de flow direct wordt geactiveerd.

De popup toont de volgende informatie:

Naam webhook

De naam van de geselecteerde webhook

URL

Onder de naam van de webhook wordt de aangeroepen URL weergegeven. Je kunt deze URL openen, selecteren en eenvoudig kopiëren.

Kopiëren

Naast de URL staat een icoon waarop je kunt klikken om de volledige URL in één keer te kopiëren.

Scherm sluiten

Sluit de pop-up door op het kruisje rechtsboven te klikken.

Veelgestelde vragen

Wat is het verschil tussen een webhook doelgroep en het Webhook blok?
Beide opties vind je in de Campagne Manager onder Kies ontvangers. De webhook doelgroep is een optie binnen het Doelgroep blok. Als je Geavanceerde modus aanvinkt, kun je in plaats van een doelgroep een webhook selecteren, waarna de doelgroep vanuit de webhook wordt gevuld. Het Webhook blok is een apart blok waarmee een extern systeem via een URL je campagneflow start, bijvoorbeeld wanneer er een lead wordt aangemaakt. In dit blok kun je de webhook ook uitvoeren en de URL kopiëren. Voor het Webhook blok moet er een webhook zijn geconfigureerd in de Algemene Instellingen.
Wanneer kies je het Doelgroep blok en wanneer het Webhook blok?
Kies het Webhook blok als een gebeurtenis in een extern systeem je campagne direct moet starten. Zodra het externe systeem de URL van het Webhook blok aanroept, bijvoorbeeld wanneer er een lead wordt aangemaakt, wordt de campagneflow uitgevoerd.
Kies de Webhook Doelgroep als je de contacten uit een webhook eerst in de Doelgroep Manager wilt verwerken en de campagne op een vast moment wilt versturen. Maak hiervoor in de Doelgroep Manager een selectie met een Webhook blok, koppel die aan een doelgroep en maak de doelgroep beschikbaar voor campagnes. In de Campagne Manager selecteer je deze doelgroep via de webhook-optie in het Doelgroep blok, met Geavanceerde modus ingeschakeld. Verbind het Doelgroep blok met een kanaalblok, bijvoorbeeld een e-mail blok, en koppel dat aan een Schedule blok. De aanroep van de webhook start de campagne namelijk niet. Een voorbeeld is een dagelijkse mail op een vast tijdstip aan de contacten die het externe systeem als laatste heeft aangeleverd. De doelgroep bevat alleen de contacten van de laatste aanroep.

In dit artikel

Webhook Webhook blok toevoegen Selecteer Webhook Webhook blok openen Webhook preview (oog-icoon) Webhook URL (driehoek icoon) Veelgestelde vragen