Webhooks

Webhooks stellen je in staat om real-time meldingen te ontvangen over je links — zowel wanneer ze worden aangeklikt als wanneer ze worden gemaakt, bijgewerkt of verwijderd. Linkly stuurt een POST-verzoek naar je opgegeven URL('s) met gedetailleerde informatie over elke gebeurtenis.

Gebruiksscenario's

• Automatiseringsplatforms: Trigger workflows in Make of Zapier wanneer links worden aangeklikt
• Aangepaste analytics: Verzend klikgegevens naar je eigen analyseersysteem
• CRM-updates: Update klantrecords wanneer ze op links klikken
• Slack-meldingen: Ontvang meldingen in Slack wanneer belangrijke links worden aangeklikt
• Lead tracking: Volg wanneer prospects met je links omgaan

Tip: Voor de meeste automatiseeringsuse cases zijn onze Make-integratie of Zapier-integratie gemakkelijker in te stellen dan aangepaste webhooks. Ze bevatten instant click-triggers aangestuurd door webhooks, zonder codeerwerk nodig.

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

Gebeurtenissen

Elke webhook ontvangt alle gebeurtenistypes voor zijn bereik — een webhook op linkniveau krijgt gebeurtenissen voor die link, een webhook op workspace-niveau krijgt gebeurtenissen voor elke link in de werkruimte. Controleer het veld event op het hoogste niveau om ze uit elkaar te houden:

Webhook-payload

Klik-payload

Wanneer 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": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.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": "Special Offer",
    "og_description": "Check out our spring sale!",
    "rules": [
      {
        "what": "country",
        "matches": "US",
        "url": "https://example.com/us-landing"
      }
    ]
  },
  "click": {
    "id": "01KYPGEEPJSPR3S564QRBDGA1W",
    "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"
    }
  }
}

Payload-velden

Gebeurtenisinformatie

Link-object

Klik-object

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

Link lifecycle-payload

De link.created-, link.updated- en link.deleted-gebeurtenissen hebben dezelfde vorm. Er is geen click-object — je krijgt event, een timestamp en de volledige link:

{
  "event": "link.created",
  "timestamp": "2026-06-20T10:30:00Z",
  "link": {
    "id": 12345,
    "name": "My Campaign Link",
    "url": "https://example.com/landing-page",
    "full_url": "https://yourdomain.com/abc123",
    "domain": "yourdomain.com",
    "slug": "/abc123",
    "workspace_id": 1,
    "enabled": true,
    "rules": []
  }
}

Integraties met automatiseringsplatforms

Voor eenvoudigere instellingen zonder aangepaste code, gebruik onze native integraties:

• Make-integratie - Visueel automatiseringsplatform met instant click-triggers
• Zapier-integratie - Verbind Linkly met duizenden apps zonder code

Beide integraties gebruiken webhooks achter de schermen, maar verwerken alle instellingen automatisch.

Best practices

Meerdere webhooks

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

Foutafhandeling

• Webhooks zijn fire-and-forget — Linkly voert geen nieuwe pogingen uit voor mislukte deliveries
• Webhookfouten beïnvloeden nooit de omleiding — gebruikers bereiken altijd hun bestemming
• Zorg ervoor dat je webhook-eindpunt snel reageert (< 5 seconden aanbevolen)

Beveiliging

• 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

Testen

1. 1
   Stel een webhook-URL in met behulp van een service zoals webhook.site of RequestBin
2. 2
   Klik op je link
3. 3
   Inspecteer de ontvangen payload
4. 4
   Zodra geverifieerd, schakel je over naar je production webhook-URL

API-toegang

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.