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 Click-Daten 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, 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 beinhalten sofortige Click-Trigger powered by Webhooks, ohne dass Programmierung erforderlich ist.

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 Geltungsbereich – ein Link-Level-Webhook erhält Ereignisse für diesen Link, ein Workspace-Level-Webhook erhält Ereignisse für jeden Link im Workspace. Überprüfen Sie das Feld event auf der obersten Ebene, um sie zu unterscheiden:

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",
    "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-Felder

Ereignisinformationen

Link-Objekt

Click-Objekt

Datenschutzhinweis: IP-Adressen werden niemals in Webhook-Payloads enthalten.

Link-Lebenszyklus-Payload

Die Ereignisse link.created, link.updated und link.deleted teilen dieselbe 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": []
  }
}

Automatisierungsplattform-Integrationen

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

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

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

Fehlerbehandlung

• Webhooks sind fire-and-forget – Linkly wiederholt fehlgeschlagene Zustellungen nicht
• Webhook-Fehler beeinflussen die Umleitung nie – Benutzer erreichen immer ihr Ziel
• Stellen Sie sicher, dass Ihr Webhook-Endpoint schnell antwortet (< 5 Sekunden empfohlen)

Sicherheit

• Verwenden Sie HTTPS-Endpoints 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 Überprüfung

Testen

1. 1
   Richten Sie eine Webhook-URL ein mit einem Dienst wie webhook.site oder RequestBin
2. 2
   Klicken Sie auf Ihren Link
3. 3
   Untersuchen Sie die empfangene Payload
4. 4
   Nach der Überprüfung 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.