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: Activeer workflows in Make of Zapier wanneer links worden aangeklikt
• Aangepaste analyse: Stuur clickgegevens naar je eigen analyticssysteem
• CRM-updates: Werk klantgegevens bij 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 automatiseringscases zijn onze Make-integratie of Zapier-integratie makkelijker in te stellen dan aangepaste webhooks. Ze bevatten directe click-triggers aangedreven door webhooks, zonder codering nodig.

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

Gebeurtenissen

Elke webhook ontvangt alle gebeurtenistypen voor het bereik ervan — een link-niveau webhook krijgt gebeurtenissen voor die link, een workspace-niveau webhook krijgt gebeurtenissen voor elke link in de workspace. Controleer het top-level veld event om ze uit elkaar te houden:

Webhook-payload

Click-payload

Wanneer een click optreedt, 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": {
    "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 worden nooit opgenomen in webhook-payloads.

Link-lifecycle payload

De gebeurtenissen link.created, link.updated en link.deleted 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 gemakkelijker instellen zonder aangepaste codering, gebruik onze native integraties:

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

Beide integraties gebruiken webhooks onder de motorkap, maar verwerken alle setup automatisch.

Best practices

Meerdere webhooks

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

Foutafhandeling

• Webhooks zijn fire-and-forget - Linkly voert mislukte leveringen niet opnieuw uit
• Webhook-fouten beïnvloeden de omleiding nooit — gebruikers bereiken altijd hun bestemming
• Zorg ervoor dat je webhook-eindpunt snel reageert (< 5 seconden aanbevolen)

Veiligheid

• Gebruik HTTPS-eindpunten voor webhook-URL's
• Valideer inkomende verzoeken in je webhook-handler
• Overweeg een geheime parameter aan je webhook-URL toe te voegen 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
   Nadat geverifieerd, schakel je over naar je productie 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.