Webhooks

Webhooks ermöglichen es Ihnen, Echtzeit-Benachrichtigungen über Ihre Links zu erhalten — 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 Analytik: Senden Sie Klickdaten an Ihr eigenes Analysesystem
• CRM-Updates: Aktualisieren Sie Kundendatensätze, wenn diese auf Links klicken
• Slack-Benachrichtigungen: Erhalten Sie Benachrichtigungen in Slack, wenn wichtige Links angeklickt werden
• Lead-Tracking: Verfolgen Sie, wann 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 von Webhooks unterstützt werden, ohne dass Code erforderlich ist.

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

Ereignisse

Jeder Webhook empfängt alle Ereignistypen für seinen Bereich — ein Link-Level-Webhook ruft Ereignisse für diesen Link ab, ein Workspace-Level-Webhook ruft Ereignisse für jeden Link in Ihrem Workspace ab. Ü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 das 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": []
  }
}

Integrationen mit Automatisierungsplattformen

Für eine einfachere Einrichtung ohne benutzerdefinierten Code 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 verwenden Webhooks im Hintergrund, aber die gesamte Einrichtung erfolgt automatisch.

Best Practices

Mehrere Webhooks

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

Fehlerbehandlung

• Webhooks sind Fire-and-Forget — Linkly versucht fehlgeschlagene Lieferungen nicht erneut
• Webhook-Fehler beeinträchtigen die Umleitung nicht — Benutzer erreichen immer ihr Ziel
• 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 für die Verifizierung hinzuzufügen

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
   Wechseln Sie nach der Überprüfung zu Ihrer produktiven Webhook-URL

API-Zugriff

Sie können Webhooks auch programmatisch ü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 Informationen finden Sie in der API-Dokumentation.