Via webhooks koppelen met Xendy

Inleiding

Met webhooks kun je automatisch gegevens vanuit andere systemen naar Xendy sturen. Denk aan inschrijvingen via een popup, een formulier of je CRM. Nieuwe contacten komen direct in een segment in Xendy terecht, zonder dat je handmatig iets hoeft te importeren.

Webhook instellen in Xendy

Zo maak je een webhook aan in Xendy:

1. Log in bij Xendy en kies in het linkermenu voor ‘Alle contacten’ en klik vervolgens rechts bovenin wederom op ‘Alle contacten’. Kies nu voor ‘Nieuw segment aanmaken’. Kies nu voor ‘Statisch’. Kies nu de naam voor het segment en kies ‘Segment aanmaken’ om het segment aan te maken.
2. Klik nu rechts bovenin op ‘Contacten toevoegen’ en kies ‘Via een webhook’. Er opent nu een pop-up met daarin een URL en een Authorization: Bearer token.

Deze gegevens gebruik je in je andere systeem (bijvoorbeeld Zapier, een popup-tool of een CRM) om contacten automatisch naar Xendy te sturen.

Gegevens meesturen

Bij het versturen van gegevens naar Xendy moet je minimaal één veld meesturen:

• email (verplicht).
  

Optioneel kun je ook andere velden meesturen:

• Voornaam: first_name
• Achternaam: last_name
• Eigen velden: gebruik een eigen naam, bijvoorbeeld bedrijf of telefoon.

Extra velden worden automatisch toegevoegd in Xendy en kun je gebruiken bij segmenten of personalisatie.

Voorbeeld JSON-payload:

{

  “email”: “klant@example.com”,

  “first_name”: “Jan”,

  “last_name”: “Jansen”,

  “telefoon”: “0612345678”

}

Authenticatie

Bij elke webhook-call moet je een beveiligingssleutel (token) meesturen. Deze token krijg je van Xendy bij het aanmaken van de webhook. Zonder deze token worden de gegevens niet geaccepteerd.

Gebruik altijd dit formaat in de headers van je verzoek: Authorization: Bearer abc123

Vervang abc123 door de token die je in Xendy hebt gekregen. Let erop dat je de tekst Authorization: Bearer altijd volledig meestuurt, gevolgd door de code. Dit zorgt ervoor dat alleen jouw systeem gegevens kan doorsturen naar jouw Xendy-account.

Koppeling testen

Om te controleren of alles goed werkt, kun je een test doen:

1. Verstuur data naar de webhook URL, bijvoorbeeld door een formulier of pop-up in te vullen of een contact te wijzigen in je CRM systeem.
2. Log in bij Xendy en kies in het linkermenu voor ‘Alle contacten’ en klik vervolgens rechts bovenin wederom op ‘Alle contacten’. Kies nu voor het segment dat je hebt aangemaakt. Zoek in de lijst of je het e-mailadres ziet verschijnen.

Veelgestelde vragen