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: Triggern Sie Workflows in Make oder Zapier, 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-Verfolgung: Verfolgen Sie, wann Prospects 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 angetrieben werden, ohne dass Codierung erforderlich ist.

1
2
3

Sie können mehrere Webhook-URLs hinzufügen. Alle URLs erhalten die gleiche Payload, wenn der Link angeklickt wird.

Geben Sie Ihre Webhook-URL(s) ein, eine pro Zeile.
Geben Sie Ihre Webhook-URL(s) ein, eine pro Zeile.
4

Link-Ebenen-Webhooks werden nur ausgelöst, wenn dieser spezifische Link angeklickt wird.

So richten Sie Workspace-Ebenen-Webhooks ein

1

Gehen Sie zu Einstellungen (Zahnradsymbol in der Seitenleiste).

2

Klicken Sie auf Workspace-Einstellungen

3

Geben Sie Ihre Webhook-URL(s) ein, eine pro Zeile.

Sie können mehrere Webhook-URLs hinzufügen. Alle URLs erhalten die gleiche Payload, wenn ein beliebiger Link in Ihrem Workspace angeklickt wird.

Geben Sie Ihre Webhook-URL(s) ein, eine pro Zeile.
Geben Sie Ihre Webhook-URL(s) ein, eine pro Zeile.
4

Klicken Sie auf Einstellungen speichern.

Workspace-Ebenen-Webhooks werden für jeden Klick auf einen beliebigen Link in Ihrem Workspace ausgelöst.

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-Ebenen-Webhook erhält Ereignisse für diesen Link, ein Workspace-Ebenen-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:

eventGesendet wenn
clickEin Kurzlink wird angeklickt. Enthält ein click-Objekt mit den Anfragedaten des Besuchers.
link.createdEin neuer Link wird im Workspace erstellt.
link.updatedDie Einstellungen eines Links werden geändert. Wird bei jedem Update ausgelöst, einschließlich automatisch gespeicherter Bearbeitungen, daher können Sie mehrere pro Bearbeitungssitzung erhalten.
link.deletedEin Link wird gelöscht. Das link-Objekt behält den Slug und die Domain bei, die es vor dem Löschen hatte.

Webhook-Payload

Click-Payload

Wenn ein Klick auftritt, sendet Linkly eine POST-Anfrage mit der folgenden 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",
    "metadata": {
      "order_id": "A-10293",
      "crm_contact_id": "3f2b8c1e-9a47-4d0e-b6a5-1c2d3e4f5a6b"
    },
    "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-Felder

Ereignisinformationen

FeldBeschreibung
eventclick, link.created, link.updated oder link.deleted
timestampISO 8601-Zeitstempel des Klicks
FeldBeschreibung
idEindeutige Link-Kennung
nameLink-Spitzname
urlUrsprüngliche Ziel-URL
full_urlDie Kurzlink-URL
domainBenutzerdefinierte Domain (falls konfiguriert)
slugURL-Pfad/Slug
metadataIhre eigenen Schlüssel-Wert-Daten, die dem Link angehängt sind, z.B. IDs aus Ihrem eigenen System. Immer ein Objekt, leer wenn keines gesetzt ist. Siehe Link-Metadaten
destinationTatsächliches Ziel für diesen Klick (kann sich von url unterscheiden, wenn Regeln angewendet werden)
workspace_idWorkspace-Kennung
enabledOb Link aktiv ist
rulesArray von Weiterleitungsregeln (Geo, Gerät, Rotator)
utm_*UTM-Parameter falls konfiguriert
og_*Open-Graph-Einstellungen falls konfiguriert

Click-Objekt

FeldBeschreibung
idEindeutige Kennung für diesen Klick, eine 26-stellige ULID. Die führenden Zeichen kodieren die Klickzeit, daher werden IDs chronologisch als einfache Strings sortiert
countryZwei-Buchstaben-Ländercode (z.B. "US", "GB")
is_eu_countryOb der Klick von der EU stammt
platformGeräteplattform (Desktop, iOS, Android, etc.)
browser_nameBrowsername (Chrome, Safari, Firefox, etc.)
refererReferer-URL (falls verfügbar)
ispInternet Service Provider
bot_nameBot-Kennung (null für menschliche Klicks)
destinationEndgültige Ziel-URL für diesen Klick
paramsAbfrageparameter, die an den Link übergeben werden

Datenschutzhinweis: IP-Adressen sind nie in Webhook-Payloads enthalten.

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,
    "metadata": {
      "order_id": "A-10293"
    },
    "rules": []
  }
}

Integrationen mit Automatisierungsplattformen

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

Beide Integrationen verwenden 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 Payload, wenn ein Klick auftritt.

Fehlerbehandlung

  • Webhooks sind fire-and-forget – Linkly versucht nicht, fehlgeschlagene Lieferungen erneut zu versuchen
  • Webhook-Fehler beeinflussen die Weiterleitung nie – 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 hinzuzufügen zur Verifizierung

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 Payload
  4. 4
    Wechseln Sie nach der Verifizierung 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

Siehe die API-Dokumentation für Details.

Webhooks FAQs

Welche Ereignisse können Webhooks senden?

Webhooks werden bei vier Ereignissen ausgelöst, die durch das Feld „event" in der Payload identifiziert werden. Sie erhalten „click", wenn ein Link angeklickt wird, sowie „link.created", „link.updated" und „link.deleted", wenn Links sich ändern. Jeder Webhook empfängt alle Ereignistypen für seinen Bereich, daher branchen Sie beim Feld „event", um jeden zu bearbeiten.

Warum werden meine Webhooks nicht ausgelöst?

Überprüfen Sie, dass Ihre Webhook-URL gültig und erreichbar ist und dass Webhooks auf dem Link oder Workspace gespeichert sind. Bei Click-Ereignissen beachten Sie, dass Webhooks nur ausgelöst werden, wenn ein Klick tatsächlich aufgezeichnet wird – ausgeschlossene IPs oder übersprungene Crawler lösen sie nicht aus.

Warum sind einige Felder in der Webhook-Payload null?

Einige Felder können null sein, wenn die Informationen nicht verfügbar waren (z.B. keine Referrer), Datenschutzeinstellungen die Erfassung verhinderten, oder der Klick von einem Bot stammt (in diesem Fall wird bot_name stattdessen gefüllt).

Versucht Linkly, fehlgeschlagene Webhook-Lieferungen erneut zu versuchen?

Nein. Webhooks sind fire-and-forget. Fehlgeschlagene Lieferungen werden nicht erneut versucht, und Linkly verfolgt den Webhook-Lieferstatus nicht. Webhook-Anfragen werden nach 5 Sekunden zurückgewiesen.

Unterstützt Linkly Postbacks für Conversion Tracking?

Nein. Linkly-Webhooks sind nur ausgehend und werden ausgelöst, wenn Klicks auftreten. Wir können keine Postback-Daten von Affiliate-Netzwerken oder Ad-Plattformen empfangen. Für Conversion Tracking verwenden Sie das native Tracking der Zielplattform, übergeben Sie eine Click-ID über Query-Parameter-Weiterleitung, oder nutzen Sie unsere BigQuery-Integration, um Click-Daten mit Ihren Conversion-Daten zu verbinden.

Sollte ich Webhooks oder Make/Zapier verwenden?

Für die meisten Automatisierungsanwendungsfälle sind unsere Make- oder Zapier-Integrationen einfacher einzurichten. Sie verwenden Webhooks im Hintergrund, verwalten aber die gesamte Konfiguration automatisch. Verwenden Sie benutzerdefinierte Webhooks, wenn Sie Daten an Ihre eigenen Systeme senden müssen oder mehr Kontrolle über die Integration benötigen.

Ja. Wenn Sie Webhooks auf beiden Ebenen konfigurieren, werden beide ausgelöst, wenn dieser Link angeklickt wird. Dies ist nützlich, wenn Sie workspace-weites Logging sowie spezifische Aktionen für bestimmte Links möchten.

Wer kann Webhooks einrichten?

Webhooks auf einem einzelnen Link benötigen die Rolle „Schreiben“ oder höher. Arbeitsbereich-Webhooks benötigen die Rolle „Admin“ oder „Inhaber“. Siehe Benutzerrollen und Berechtigungen.

Tarifverfügbarkeit

Verfügbar ab Business

Tarife vergleichen →

Verfolgen Sie 500 monatliche Klicks kostenlos.