Zapier API events

Via Zapier is het mogelijk events naar onze API te versturen zonder dat je hierbij zelf een server moet inrichten. Onderstaand is een voorbeeld gebaseerd op Facebook leads, waarbij je data uit formulieren in Facebook naar Spotler Activate doorstuurt.

Trigger configureren

Eerst maak je in Zapier een nieuwe Zap aan, met hierbij de relevante app, in dit geval Facebook Lead Ads. Afhankelijk van de app zijn er verschillende events mogelijk, hier willen we een nieuwe lead als trigger selecteren:

Vervolgens selecteer je het correcte account, pagina en formulier. Afhankelijk van je gekozen app kan de configuratie verschillen, maar je zou het relevante formulier met data bij de ‘set up trigger’ stap moeten selecteren. Bij test trigger kan je kijken, indien het formulier al live staat, of de data die Zapier ontvangt datgene is wat je verwacht.

Actie configureren

Vervolgens maak je een actie aan. De app hier is ‘Webhooks by Zapier’ en het Action Event is een Custom Request:

Bij de actie zelf is de methode ‘POST’, de URL is https://api.Spotler Activate.tech/v1/track (afkomstig uit onze API documentatie) en Data Pass-Through zet je op false.

Vervolgens komt het gedeelte wat je zelf moeten inrichten, adhv welke gegevens je precies wilt overzetten vanuit het formulier. Ook kan je statische gegevens doorsturen, bij onderstaand voorbeeld halen we het e-mailadres, naam en geslacht op maar vullen we de taal en bron met een vaste string in. De naam van het event is ‘FBLeads’ maar dit kan je zelf kiezen.

{
  "events": [
    {
      "event": "FBLead",
      "firstname": "{{Voornaam}}",
      "lastname":"{{Achternaam}}",
      "email":"{{E-mailadres}}",
      "gender":"{{Geslacht}}",
      "custom_taal":"nl",
      "custom_bronnb":"facebook"
    }
  ]
}

Je kopieert bovenstaande code, en elk stuk wat tussen {-tekens staat, zijn dynamische waardes die je automatisch door Zapier kan laten opvullen. Onderaan het invoerveld staat “Insert Data” waarmee je altijd een variabele kan invoegen. Let wel op: zowel variabelen als statische strings moeten door “-tekens afgesloten worden.

Vervolgens kan je de ‘Unflatten’ en Basic auth optie standaard laten en extra headers configureren. Dat zijn er drie, waarvan de eerste twee afhankelijk van je merchant zijn:

X-AUTH-ACCOUNT: Account ID in settings
X-AUTH-APIKEY: API key in settings
Content-Type: application/json

Wanneer je op continue drukt, kan je vervolgens met een ontvangen voorbeeldformulier de Zap testen. Normaal zie je dan in Zapier bevestiging dat het succesvol is, en zie je het event in Spotler Activate onder ‘Data’ verschijnen alsook op het profiel wat dan is aangemaakt / aangevuld.

Krijg je foutmeldingen, kijk dan in onze API documentatie:

Activate: API Documentation - Spotler Activate