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.
So richten Sie Link-Ebenen-Webhooks ein
Gehen Sie zu Links und klicken Sie auf den Link, den Sie konfigurieren möchten.
Scrollen Sie nach unten zum Abschnitt Webhooks.
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 der Link angeklickt wird.

Klicken Sie auf Speichern.
Link-Ebenen-Webhooks werden nur ausgelöst, wenn dieser spezifische Link angeklickt wird.
So richten Sie Workspace-Ebenen-Webhooks ein
Gehen Sie zu Einstellungen (Zahnradsymbol in der Seitenleiste).
Klicken Sie auf Workspace-Einstellungen
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.

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:
event | Gesendet wenn |
|---|---|
click | Ein Kurzlink wird angeklickt. Enthält ein click-Objekt mit den Anfragedaten des Besuchers. |
link.created | Ein neuer Link wird im Workspace erstellt. |
link.updated | Die 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.deleted | Ein 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
| Feld | Beschreibung |
|---|---|
event | click, link.created, link.updated oder link.deleted |
timestamp | ISO 8601-Zeitstempel des Klicks |
Link-Objekt
| Feld | Beschreibung |
|---|---|
id | Eindeutige Link-Kennung |
name | Link-Spitzname |
url | Ursprüngliche Ziel-URL |
full_url | Die Kurzlink-URL |
domain | Benutzerdefinierte Domain (falls konfiguriert) |
slug | URL-Pfad/Slug |
metadata | Ihre 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 |
destination | Tatsächliches Ziel für diesen Klick (kann sich von url unterscheiden, wenn Regeln angewendet werden) |
workspace_id | Workspace-Kennung |
enabled | Ob Link aktiv ist |
rules | Array von Weiterleitungsregeln (Geo, Gerät, Rotator) |
utm_* | UTM-Parameter falls konfiguriert |
og_* | Open-Graph-Einstellungen falls konfiguriert |
Click-Objekt
| Feld | Beschreibung |
|---|---|
id | Eindeutige Kennung für diesen Klick, eine 26-stellige ULID. Die führenden Zeichen kodieren die Klickzeit, daher werden IDs chronologisch als einfache Strings sortiert |
country | Zwei-Buchstaben-Ländercode (z.B. "US", "GB") |
is_eu_country | Ob der Klick von der EU stammt |
platform | Geräteplattform (Desktop, iOS, Android, etc.) |
browser_name | Browsername (Chrome, Safari, Firefox, etc.) |
referer | Referer-URL (falls verfügbar) |
isp | Internet Service Provider |
bot_name | Bot-Kennung (null für menschliche Klicks) |
destination | Endgültige Ziel-URL für diesen Klick |
params | Abfrageparameter, die an den Link übergeben werden |
Datenschutzhinweis: IP-Adressen sind nie in Webhook-Payloads enthalten.
Link-Lebenszyklus-Payload
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:
- 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, 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
- 1Richten Sie eine Webhook-URL mit einem Service wie webhook.site oder RequestBin ein
- 2Klicken Sie auf Ihren Link
- 3Überprüfen Sie die empfangene Payload
- 4Wechseln 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.
Kann ich Webhooks auf einen Link und den Workspace haben?
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
Verfolgen Sie 500 monatliche Klicks kostenlos.