Webhooks

Met webhooks kun je realtime meldingen ontvangen wanneer er op je links wordt geklikt. Wanneer er een klik plaatsvindt, stuurt Linkly een POST-verzoek naar je opgegeven URL('s) met gedetailleerde informatie over de klik.

• Automatiseringsplatforms: Activeer workflows in Make of Zapier wanneer er op links wordt geklikt
• Aangepaste analytics: Stuur klikgegevens naar je eigen analytics-systeem
• CRM-updates: Update klantgegevens wanneer ze op links klikken
• Slack-meldingen: Ontvang meldingen in Slack wanneer er op belangrijke links wordt geklikt
• Lead tracking: Volg wanneer prospects interactie hebben met je links

Tip: Voor de meeste automatiseringsgebruikssituaties zijn onze Make-integratie of Zapier-integratie eenvoudiger in te stellen dan aangepaste webhooks. Ze bevatten directe klik-triggers op basis van webhooks, zonder dat codering nodig is.

Opmerking: Als je webhooks op beide niveaus configureert, worden beide geactiveerd voor kliks op die link.

Wanneer er een klik plaatsvindt, stuurt Linkly een POST-verzoek met de volgende JSON-payload:

{
  "event": "click",
  "timestamp": "2025-01-15T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "Mijn campagnelink",
    "url": "https://example.com/landing-page",
    "full_url": "https://jouwdomein.com/abc123",
    "domain": "jouwdomein.com",
    "slug": "/abc123",
    "destination": "https://example.com/landing-page",
    "workspace_id": 1,
    "enabled": true,
    "cloaking": false,
    "forward_params": true,
    "block_bots": true,
    "public_analytics": false,
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-sale",
    "og_title": "Speciale aanbieding",
    "og_description": "Bekijk onze voorjaarsuitverkoop!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "country": "US",
    "is_eu_country": false,
    "platform": "desktop",
    "browser_name": "Chrome",
    "referer": "https://twitter.com/",
    "isp": "Comcast",
    "bot_name": null,
    "destination": "https://example.com/landing-page",
    "params": {
      "utm_source": "twitter"
    }
  }
}

Privacyopmerking: IP-adressen worden nooit opgenomen in webhook-payloads.

Voor eenvoudigere installatie zonder aangepaste codering, gebruik onze native integraties:

• Make-integratie - Visueel automatiseringsplatform met directe klik-triggers
• Zapier-integratie - Verbind Linkly met duizenden apps zonder code

Beide integraties gebruiken webhooks onder de motorkap maar verzorgen alle instellingen automatisch.

Je kunt meerdere webhook-URL's toevoegen (één per regel). Alle URL's ontvangen dezelfde payload wanneer er een klik plaatsvindt.

• Webhooks zijn fire-and-forget - Linkly probeert mislukte leveringen niet opnieuw
• Webhook-fouten hebben nooit invloed op de doorverwijzing - gebruikers bereiken altijd hun bestemming
• Zorg ervoor dat je webhook-eindpunt snel reageert (< 5 seconden aanbevolen)

• Gebruik HTTPS-eindpunten voor webhook-URL's
• Valideer inkomende verzoeken in je webhook-handler
• Overweeg een geheime parameter toe te voegen aan je webhook-URL voor verificatie

1. 1Stel een webhook-URL in met een dienst zoals webhook.site of RequestBin
2. 2Klik op je link
3. 3Inspecteer de ontvangen payload
4. 4Schakel na verificatie over naar je productie-webhook-URL

Je kunt webhooks ook programmatisch beheren via de API:

POST   /api/v1/link/:link_id/webhooks
DELETE /api/v1/link/:link_id/webhooks/:hook_id
GET    /api/v1/link/:link_id/webhooks

POST   /api/v1/workspace/:workspace_id/webhooks
DELETE /api/v1/workspace/:workspace_id/webhooks/:hook_id
GET    /api/v1/workspace/:workspace_id/webhooks

Zie de API-documentatie voor details.