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 zum Klick.

Anwendungsfälle

• Automatisierungsplattformen: Triggern Sie Workflows in Make oder Zapier, wenn auf Links geklickt wird
• Benutzerdefinierte Analytik: Senden Sie Klickdaten an Ihr eigenes Analysesystem
• CRM-Aktualisierungen: Aktualisieren Sie Kundendatensätze, wenn diese auf Links klicken
• Slack-Benachrichtigungen: Erhalten Sie Benachrichtigungen in Slack, wenn auf wichtige Links geklickt wird
• 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 eine Codierung erforderlich ist.

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

Webhook-Payload

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"
    }
  }
}

Payload-Felder

Ereignisinformationen

Link-Objekt

Click-Objekt

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

Integrationen von Automatisierungsplattformen

Für eine 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, aber handhaben alle Konfigurationen 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 erfolgt.

Fehlerbehandlung

• Webhooks sind fire-and-forget – Linkly versucht fehlgeschlagene Zustellungen nicht erneut
• 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, um die Verifizierung durchzuführen

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
   Inspizieren Sie die erhaltene Payload
4. 4
   Wechseln Sie nach der Verifizierung zu Ihrer Production-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 Informationen finden Sie in der API-Dokumentation.