Contacten en tags ontvangen met een webhook

Bijgewerkt op 20 november 20264 minuten lezen

Met een webhook stuurt een ander systeem, zoals je webshop of formulierenbouwer, automatisch contacten en tags naar Inboxify. Een webhook is een vast webadres. Zodra er in dat systeem iets gebeurt, zoals een nieuwe bestelling of een ingevuld formulier, stuurt het een bericht naar dat adres. Inboxify maakt van dat bericht een contact of geeft een contact tags.

Je vindt webhooks onder Instellingen > Webhooks.

Wat kan een webhook doen?

  • Contact toevoegen: voegt een contact toe of werkt het bij, bijvoorbeeld na een bestelling of een formulier.
  • Tags toevoegen: geeft een bestaand contact tags, bijvoorbeeld na een aankoop. Het contact moet dan al in de lijst staan.

Klik op Nieuwe webhook om te beginnen. Je doorloopt vijf stappen.

Stap 1: Type

Kies wat de webhook moet doen. Kies daarna eventueel welk systeem je koppelt: Shopify, WooCommerce, Lightspeed eCom, Tally, Elementor, Zapier / Make of Zelf koppelen. Kies je een systeem, dan vult Inboxify de beveiliging en de velden alvast in. Bij stap 4 zie je dan ook precies wat je in dat systeem moet doen.

Stap 2: Lijst en bevestiging

Geef de webhook een naam en kies de Lijst. Bij Vaste tags vul je tags in die elk contact van deze webhook krijgt.

Bij Contact toevoegen kies je ook hoe nieuwe contacten worden bevestigd:

  • Altijd bevestigingsmail (standaard): nieuwe contacten krijgen eerst een mail om hun inschrijving te bevestigen. Kies de Bevestigingsmail. Kies je een standaardmail, vul dan ook de naam en het e-mailadres van de afzender in.
  • Direct inschrijven: kies dit alleen als het andere systeem al toestemming heeft gevraagd.
  • Uit het bericht: het bericht bepaalt per contact wat er gebeurt. Dat stel je in bij stap 5.

Stap 3: URL en beveiliging

Vanaf deze stap is de webhook opgeslagen. Je ziet de Webhook-URL. Kopieer die met Kopiëren.

Let op: Gebruik deze URL alleen tussen servers, nooit in een formulier op je website.

Ondersteunt je systeem een handtekening? Zet dan Handtekening controleren (HMAC) aan. Inboxify controleert bij elk bericht of het echt van jouw systeem komt en weigert berichten zonder geldige handtekening. Vul de Headernaam en het Geheim in. Het geheim vind je bij de webhook-instellingen van je systeem.

Tip: Kies je Direct inschrijven zonder handtekening, dan kan iedereen met de URL contacten inschrijven. Zet in dat geval HMAC aan.

Stap 4: Testbericht

Links staat wat je in je systeem moet doen, met de URL erbij. Stuur vanuit je systeem een testbericht, bijvoorbeeld met een testbestelling of door het formulier in te vullen. Zodra het bericht binnen is, gaat de pagina vanzelf verder. Het testbericht maakt nog geen contact aan: Inboxify verwerkt pas berichten die binnenkomen nadat je de webhook hebt aangezet.

Wil je niet wachten? Klik dan op Later verder. De webhook blijft op Wacht op test staan en je gaat later verder door hem in het overzicht aan te klikken.

Stap 5: Velden koppelen

Kies per Inboxify-veld welk veld uit het testbericht erbij hoort, of vul een Vaste waarde in. Het E-mailadres is verplicht.

  • Inboxify doet voorstellen, met een gestippelde rand. Accepteer een voorstel met het vinkje of weiger het met het kruisje. Of klik op Alle suggesties accepteren.
  • Met Bewerking pas je een waarde aan, bijvoorbeeld met Spaties weghalen, Kleine letters, Datum herkennen of Land herkennen.
  • Bij Tags krijgt een contact altijd de vaste tags. Met Regel toevoegen voeg je tags uit het bericht of een vaste tag toe. Alle uitkomsten worden samengevoegd.
  • Koos je bij stap 2 voor Uit het bericht? Kies dan bij Toestemming het veld met de nieuwsbriefkeuze en per waarde wat er gebeurt: Direct inschrijven, Bevestigingsmail sturen, Alleen bijwerken of Overslaan.

Rechts zie je bij Proefdraaien wat het testbericht zou opleveren. Klopt alles? Klik dan op Aanzetten. De webhook staat nu op Actief.

Let op: Bij Toestemming kun je klanten zonder nieuwsbriefakkoord toevoegen op basis van de klantrelatie. Dat mag alleen als het contact in dit bericht een bestelling heeft geplaatst, je alleen mailt over eigen, vergelijkbare producten of diensten, de klant bij het bestellen kon aangeven geen mail te willen en elke mail een afmeldlink heeft.

Tip: Lees in Een webhook beheren hoe je een webhook aanpast, uitschakelt of de berichten bekijkt die binnenkwamen.