Webhooks

Webhooks ermöglichen es Ihnen, Echtzeit-Benachrichtigungen zu erhalten, wenn Ihre Links angeklickt werden. Wenn ein Klick erfolgt, sendet Linkly eine POST-Anfrage an Ihre angegebene(n) URL(s) mit detaillierten Informationen über den Klick.

• Automatisierungsplattformen: Lösen Sie Workflows in Make oder Zapier aus, wenn Links angeklickt werden
• Benutzerdefinierte Analysen: Senden Sie Klickdaten an Ihr eigenes Analysesystem
• CRM-Updates: Aktualisieren Sie Kundendatensätze, wenn diese auf Links klicken
• Slack-Benachrichtigungen: Lassen Sie sich in Slack benachrichtigen, wenn wichtige Links angeklickt werden
• Lead-Tracking: Verfolgen Sie, wann Interessenten mit Ihren Links interagieren

Tipp: Für die meisten Automatisierungsanwendungen sind unsere Make-Integration oder Zapier-Integration einfacher einzurichten als benutzerdefinierte Webhooks. Sie enthalten sofortige Klick-Trigger, die von Webhooks unterstützt werden, ohne dass Programmierung erforderlich ist.

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

Wenn ein Klick erfolgt, 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"
    }
  }
}

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

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

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

Beide Integrationen verwenden im Hintergrund Webhooks, übernehmen aber automatisch die gesamte Einrichtung.

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

• Webhooks sind Fire-and-Forget - Linkly wiederholt fehlgeschlagene Zustellungen nicht
• Webhook-Fehler beeinträchtigen niemals die Weiterleitung - Benutzer erreichen immer ihr Ziel
• Stellen Sie sicher, dass Ihr Webhook-Endpunkt schnell antwortet (< 5 Sekunden empfohlen)

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

1. 1Richten Sie eine Webhook-URL mit einem Dienst wie webhook.site oder RequestBin ein
2. 2Klicken Sie auf Ihren Link
3. 3Untersuchen Sie die empfangene Payload
4. 4Wechseln Sie nach der Verifizierung zu Ihrer Produktions-Webhook-URL

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

Siehe die API-Dokumentation für Details.