Webhooks

Mit Webhooks erhalten Sie Echtzeit-Benachrichtigungen über Ihre Links — sowohl wenn sie angeklickt werden als auch wenn sie erstellt, aktualisiert oder gelöscht werden. Linkly sendet eine POST-Anfrage an Ihre angegebene(n) URL(s) mit detaillierten Informationen zu jedem Ereignis.

Anwendungsfälle

• Automatisierungsplattformen: Workflows in Make oder Zapier auslösen, wenn Links angeklickt werden
• Benutzerdefinierte Analysen: Klickdaten an Ihr eigenes Analysesystem senden
• CRM-Updates: Kundendatensätze aktualisieren, wenn diese auf Links klicken
• Slack-Benachrichtigungen: Erhalten Sie Benachrichtigungen in Slack, wenn wichtige Links angeklickt werden
• Lead-Tracking: Verfolgen Sie, wenn Interessenten mit Ihren Links interagieren

Tipp: Für die meisten Automatisierungsanwendungsfälle sind unsere Make-Integration oder Zapier-Integration einfacher einzurichten als benutzerdefinierte Webhooks. Sie enthalten sofortige Click-Trigger, die durch Webhooks gesteuert werden, und erfordern keine Codierung.

Hinweis: Wenn Sie Webhooks auf beiden Ebenen konfigurieren, werden beide bei Klicks auf diesen Link ausgelöst.

Ereignisse

Jeder Webhook empfängt alle Ereignistypen für seinen Umfang — ein Link-Level-Webhook erhält Ereignisse für diesen Link, ein Workspace-Level-Webhook erhält Ereignisse für jeden Link in Ihrem Workspace. Überprüfen Sie das Feld event auf der obersten Ebene, um sie zu unterscheiden:

Webhook-Nutzlast

Click-Nutzlast

Wenn ein Klick auftritt, sendet Linkly eine POST-Anfrage mit der folgenden JSON-Nutzlast:

{
  "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"
    }
  }
}

Nutzlastfelder

Ereignisinformationen

Link-Objekt

Click-Objekt

Datenschutzhinweis: IP-Adressen sind niemals in Webhook-Nutzlasten enthalten.

Link-Lifecycle-Nutzlast

Die Ereignisse link.created, link.updated und link.deleted haben die gleiche Form. Es gibt kein click-Objekt — Sie erhalten event, einen timestamp und den vollständigen 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": []
  }
}

Automatisierungsplattform-Integrationen

Für eine einfachere Einrichtung ohne benutzerdefinierte Codierung verwenden Sie unsere nativen Integrationen:

• Make-Integration - Visuelle Automatisierungsplattform mit sofortigen Click-Triggern
• Zapier-Integration - Verbinden Sie Linkly mit Tausenden von Apps ohne Code

Beide Integrationen nutzen Webhooks im Hintergrund, verwalten aber die gesamte Einrichtung automatisch.

Best Practices

Mehrere Webhooks

Sie können mehrere Webhook-URLs hinzufügen (eine pro Zeile). Alle URLs erhalten die gleiche Nutzlast, wenn ein Klick auftritt.

Fehlerbehandlung

• Webhooks sind Fire-and-Forget — Linkly versucht nicht, fehlgeschlagene Lieferungen erneut durchzuführen
• Webhook-Fehler beeinflussen die Umleitung niemals — Benutzer erreichen ihr Ziel immer
• Stellen Sie sicher, dass Ihr Webhook-Endpunkt schnell antwortet (< 5 Sekunden empfohlen)

Sicherheit

• Verwenden Sie HTTPS-Endpunkte für Webhook-URLs
• Validieren Sie eingehende Anfragen in Ihrem Webhook-Handler
• Erwägen Sie, einen geheimen Parameter zu Ihrer Webhook-URL hinzuzufügen, um die Verifizierung zu gewährleisten

Testen

1. 1
   Richten Sie eine Webhook-URL mit einem Service wie webhook.site oder RequestBin ein
2. 2
   Klicken Sie auf Ihren Link
3. 3
   Überprüfen Sie die empfangene Nutzlast
4. 4
   Nach der Verifizierung wechseln Sie zu Ihrer produktiven Webhook-URL

API-Zugriff

Sie können Webhooks auch programmgesteuert über die API verwalten:

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

Weitere Details finden Sie in der API-Dokumentation.