Webhooks

Du kan bruge vores API til at fortælle os hvornår der sker hændelser i dit system, så som din webshop, dit ordresystem m.v. Det kan f.eks. være, når en kontakt har sagt ja til at modtage marketingbeskeder fra dig, hvis en ordre er blevet lagt, eller hvis de har opdateret deres informationer.

Webhooks bliver brugt til at kommunikere i modsat retning. Når der sker en ændring i MarketingPlatform kan vi kontakte dit system via en webhook. I øjeblikket er funktionen begrænset til når en kontakt afmelder sig, men funktionen vil blive udvidet til atindeholde ting så som hvis en email kampagne er blevet åbnet eller andre hændelser, som måtte være interessante for dig. Hvor, hvornår og hvordan er helt op til dig.

Du kan opsætte en webhook ved at følge guiden nedenfor:

Webhooks kan findes under Integrations fanen i platformen

I Webhook Manager har du følgende muligheder:

• Choose an action [dropdown menu] – her er 3 muligheder:
  • Activate: Aktivér webhook
  • Deactivate: Deaktivér webhook
  • Delete: Slet webhook
• Tables
  • Name: Navnet på webhook
  • URL: URL på webhook
  • Event type: Typen af svar (Unsubscribe etc.)
  • Active – Angiver om vi fortsætte med at aflevere beskeder eller ej
    • Som udgangspunkt er webhooks sat som “Active”. Du kan vælge at deaktivere leveringen af webhooks ved at vælge “Active to Inactive”.
• Action
  • Edit [option]; Rediger webhook
  • Delete [option]; Slet webhook
• Show logs [åbner pop up] I loggen kan du finde data på alle eksekverede webhooks

• Time [sortérbar kolonne]
  • Hvornår eventet er indtruffet; day/month/year hour/minute/second
• Event type [sortérbar kolonne]
  • Vi understøtter i øjeblikket kun Unsubscribe
• Payload [sortérbar kolonne]
  • Viser hvlike kontakter på hvilken liste som har unsubscribed i følgende format
    • {“event”:”Unsubscribe”,”emailaddress”:”martin+otmupdaterjohnnymacka1xyzxo9@marketingplatform.com”,”subscriberid”:3512469,”listid”:”1514″}
• Response
  • Sent (er afsendt)
  • Failed (er fejlet)
• Show X entries [dropdown menu] Vælg nummeret af resultater som du vil have set på side 1
  • 5; 10; 20; 30; 50; 100

Opret Webhook

• Webhook name: [input felt]; [obligatorisk]; Navngiv din webhook
• Webhook URL: [input felt]; [obligatorisk] Linket til hvor en applikation vil modtage webhook data fra en anden app
• Verification token: [input felt]; [obligatorisk]
  • Indsæt din unikke verifikations-token (mellemrum er ikke tilladt)
  • Her indsætter du token oprettet i dit eget system
    • Token-baseret godkendelse virker ved at sikre at hver anmodning er fulgt af en signeret token som serveren verificerer for godkendelse og kun svarer på dette request
• Basic Auth: Grundlæggende godkendelse (Basic Auth) tillader brugerne at angive brugernavn og password associeret med dit HTTP endpoint når webhook bliver opsat
• Headers:
  • Du kan opsætte op til 10 headers. Header kan være tomme. Alle ændre felter skal være udfyldt.
• Select Events: I øjeblikket er kun ‘Unsubscribe’ tilgængelig. Flere events bliver snart tilføjet.
• Test Connection: Test at Webhook setup virker som ønsket.
  • Succesfuld forbindelse er angivet af grøn notifikation
  • Fejlet forbindelse er indikeret af rød notifikation. En forbindelse vil fejle hvis nogle obligatoriske felter er tomme