Synkronisering av data med webhooks

Webhook er et nyttig pub-sub verktøy for å samle inn informasjon om de endringene som skjer på kontaktene dine, inne i Make. Vi tilgjengeliggjør og publiserer utvalgt informasjon som du kan abonnere på. Hver gang det skjer en endring i denne dataen, vil vi gi deg beskjed, slik at du dermed kan holde dine andre systemer oppdatert og synkronisert.

Alt du trenger er å sette opp er en ressurs som aksepterer HTTP POST requester, og som kan ta imot statusoppdateringer fra Make.

Hva er en webhook

En webhook er en brukerdefinert callback i form av et HTTP POST request, som utløses av en eller annen form for hendelse. Disse hendelsene er predefinert og inkluderer aktivitet som at en e-post blir åpnet eller noen melder seg av SMS-tjenesten.

Dette trenger du for å komme i gang

  • En Make konto
  • Et sett med kontakter du ønsker å koble webhooks mot
  • En callback URL (endpoint) som kan ta imot HTTP POST requester

Når blir en webhook utløst og hvem kan utløse den

I Make kan en og samme webhook utløses på tre ulike måter

  • Når du som administrator foretar endringen
  • Når kontakten selv foretar endringen
  • Når endringen skjer via et API-kall (NB: Gjelder ikke ved bulk oppdateringer)

De overnevnte utløserne kan enkelt skrus av og på per webhook. Det betyr at dersom du ikke ønsker at endringer foretatt av administrator skal kringkastes, er det bare å skru denne utløseren av. Webhooks for åpning og klikk i e-postene kan ikke utløses av andre enn kontakten selv.

 

Tilgjengelige webhooks

Vi har webhook-støtte for mange forskjellige hendelser relatert til kontaktene dine.

– En kontakt melder seg av nyhetsbrevtjenesten

Webhook response: Email unsubscribe
POST /
Content-Type: application/x-www-form-urlencoded
Accept: */*

Form values
email: test_email@mail.com 
event_type: unsubscribe_email 
id: 1 
phone: 99999999 
time: yyyy-mm-dd hh:mm:ss +0200 
external_id: 1 

– En e-post kommer i retur (bounce)

Webhook response: Email bounce
POST /
Content-Type: application/x-www-form-urlencoded
Accept: */*

Form values
email: test_email@mail.com
event_type: bounce_email
id: 1
phone: 99999999
time: yyyy-mm-dd hh:mm:ss +0200 
external_id: 1

– En kontakt åpner en e-post

Webhook response: Email opened
POST /
Content-Type: application/x-www-form-urlencoded
Accept: */*

Form values
email: test_email@mail.com
event_type: open_email
ip: 00.000.000.000
sending_id: 1
time: yyyy-mm-dd hh:mm:ss +0200
ua_browser: Unknown Browser
ua_device: desktop
ua_platform: macOS
ua_version": 0.0
external_id: 1

– En kontakt klikker på en lenke i en e-post

Webhook response: Email clicked
POST /
Content-Type: application/x-www-form-urlencoded
Accept: */*

Form values
email: test_email@mail.com
event_type: click_email
ip: 00.000.000.000
link_id: 1
sending_id: 1
time: yyyy-mm-dd hh:mm:ss +0200
ua_browser: Chrome
ua_device: desktop
ua_platform: macOS
ua_version: 0.0
external_id: 1

– En kontakt melder seg av SMS-tjenesten

Webhook response: SMS unsubscribe
POST /
Content-Type: application/x-www-form-urlencoded
Accept: */*

Form values
email: test_email@mail.com
event_type: unsubscribe_phone
id: 1
phone: 99999999
time: yyyy-mm-dd hh:mm:ss +0200
external_id: 1


Debugging og testing av webhooks

RequestBin (Pipedream)
Ngrok – requests til localhost

Mer ressurser

Make Subscriber API
Make Newsletter API

About the author

Digital markedsfører & partner
Snakk med meg om denne artikkelen →

Related Posts