Webhooks

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

Gebruiksgevallen

• Automatiseringsplatforms: Trigger workflows in Make of Zapier wanneer links worden aangeklikt
• Aangepaste Analytics: Stuur klikgegevens naar je eigen analyticssysteem
• CRM-updates: Werk klantrecords bij wanneer ze links aanklikken
• Slack-meldingen: Ontvang meldingen in Slack wanneer belangrijke links worden aangeklikt
• Lead Tracking: Track wanneer prospects interactie hebben met je links

Tip: Voor de meeste automatiseringsusecases zijn onze Make-integratie of Zapier-integratie gemakkelijker in te stellen dan aangepaste webhooks. Ze bevatten instant click-triggers powered by webhooks, zonder code nodig.

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

Gebeurtenissen

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

Webhook-payload

Click-payload

Wanneer een klik plaatsvindt, stuurt Linkly een POST-aanvraag 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

Click-object

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

Link-lifecyclus-payload

De link.created, link.updated en link.deleted-gebeurtenissen hebben dezelfde vorm. Er is geen click-object — je krijgt de 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 gemakkelijkere instelling zonder aangepast coderen, gebruik je onze native integraties:

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

Beide integraties gebruiken webhooks onder de motorkap, maar behandelen alle configuratie 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 probeert mislukte afleveringen niet opnieuw
• Webhookfouten hebben nooit invloed op de omleiding - gebruikers bereiken altijd hun bestemming
• Zorg ervoor dat je webhook-endpoint snel reageert (< 5 seconden aanbevolen)

Beveiliging

• Gebruik HTTPS-eindpunten voor webhook-URL's
• Valideer inkomende aanvragen in je webhook-handler
• Overweeg een geheim 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
   Schakel over naar je productie webhook-URL zodra dit is geverifieerd

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.