Met een ‘Webhook’ blok kun je een flow vanuit externe systemen triggeren.
In de globale instellingen kun je webhooks definiëren.
Klik op de button ‘Voeg nieuwe webhook toe’ om een nieuwe webhook toe te voegen. Webhooks die al eerder zijn toegevoegd zijn op dit tabblad zichtbaar. De webhook kan worden aangepast en verwijderd door op het tandwielicoon te klikken.
Let op: om een webhook blok te kunnen gebruiken is configuratie in de globale instellingen vereist.
Webhook toevoegen
Instellingen
Vul de instellingen in om een nieuwe webhook toe te voegen.
| Code | Unieke naam voor de webhook. |
| Methode | Selecteer de webhook-methode ( (GET, POST) |
| Webhook redirect URL (optioneel) | Aan/ uitzetten van ‘Webhook redirect URL’ |
Method
GET wordt gebruikt om data van een specifieke bron op te vragen.
POST wordt gebruikt om data naar een server te sturen om een bron te creëren/bij te werken.
Wanneer je de methode POST kiest, verschijnt de optie Log Body (POST). Als je deze optie aanvinkt wordt de Body van de POST gelogd. Dit kan je bijvoorbeeld gebruiken voor het testen van je POST. De body kan je inzien in de webhook log in het beheer menu van Campaign. Standaard staat de log aan op 1 dag.
Wanneer je de methode POST kiest, verschijnt het tabblad ‘Geavanceerd’.
Redirect URL
Wanneer een redirect URL is ingesteld wordt deze URL geladen nadat de webhook-URL is ingeladen. Binnen de redirect-URL is het ook mogelijk om webhook parameters op te nemen. Parameters kunnen makkelijk worden ingevoerd door {{naam parameter}} in te voeren.
Voorbeeld: http://www.ternair.com/?leadid={{leadid}}. Op het tabblad ‘Input’ kunnen parameternamen voor de webhook worden gedefinieerd.
Je kunt de redirect-URL bijvoorbeeld gebruiken om je eigen double opt-in proces volledig binnen Ternair Marketing Cloud in te richten. Stel een redirect-URL in op de webhook die verwijst naar de bedankpagina na het bevestigen van de double opt-in en plaats de URL van de webhook achter de bevestigingsbutton in de verstuurde email. De webhook geeft de mogelijkheid om een webservice blok in de flow te triggeren die de Ternair Interact API ‘bevestiging abonnement’ gebruikt om de bevestiging te voltooien. De redirect-URL stuurt de gebruiker dan door naar de bedankpagina nadat er op ‘bevestigen’ is geklikt.
Input
De mapping van het webhook blok kan worden ingesteld op het tabblad ‘Input’.
In het eerste veld kan je een naam geven.
In het tweede veld, kan je afhankelijk van je output formaat, een XPath of JSON selector invullen.
In het derde veld kies je een sleuteltype.
De maximale lengte van een waarde per kolom is 999 karakters.
Advanced
Op het tabblad ‘Geavanceerd’ kun je aangeven of de input body meerdere rijen bevat of niet.
