Webhooks

Met webhooks kun je realtime meldingen ontvangen wanneer je links worden aangeklikt. Wanneer een klik plaatsvindt, stuurt Linkly een POST-aanvraag naar je opgegeven URL('s) met gedetailleerde informatie over de klik.

Gebruikssituaties

• Automatiseringsplatformen: Trigger workflows in Make of Zapier wanneer links worden aangeklikt
• Aangepaste analytics: Stuur klikdata 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 automatiseringssituaties zijn onze Make-integratie of Zapier-integratie gemakkelijker in te stellen dan aangepaste webhooks. Ze bevatten instant klik-triggers aangedreven door webhooks, zonder codering vereist.

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

Webhook-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": {
    "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

Opmerking over privacy: IP-adressen zijn nooit opgenomen in webhook-payloads.

Integraties met automatiseringsplatformen

Voor eenvoudiger instellen zonder aangepaste codering, gebruik je onze native integraties:

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

Beide integraties gebruiken webhooks achter de schermen, maar hanteren 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 klik plaatsvindt.

Foutafhandeling

• Webhooks zijn fire-and-forget - Linkly voert geen mislukte leveringen 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)

Beveiliging

• Gebruik HTTPS-eindpunten voor webhook-URL's
• Valideer inkomende aanvragen 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
   Schakel na verificatie 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.