Zum Hauptinhalt springen
Integrationen & API

Webhooks

Lass dich in anderen Systemen benachrichtigen, wenn sich bei einem Dokument in fynk etwas tut, zum Beispiel in Microsoft Teams oder deinem BI-Tool.

Zuletzt aktualisiert Vor 7 Tagen

Webhooks senden eine Nachricht an ein anderes System, sobald in fynk etwas passiert, zum Beispiel wenn ein Dokument unterzeichnet wird. Nutze sie, um Updates in Microsoft Teams zu posten, Automatisierungen auszulösen oder dein BI-Tool zu befüllen.

Verfügbar in Business und Pro · Einrichten: Eigentümer · Nutzen: alle

Einen Webhook einrichten

  1. Gehe zu Kontoeinstellungen → Webhooks.
  2. Klicke auf Webhook erstellen.
  3. Gib die URL ein, die die Ereignisse empfangen soll.
  4. Speichere.
  5. Lege fest, welche Benachrichtigungen an den Webhook gesendet werden: Gehe zu Kontoeinstellungen → Benachrichtigungen, klicke bei einer Benachrichtigung auf ⋯ und wähle den Webhook unter Webhooks in Benachrichtigung bearbeiten. Wiederhole das für jede Benachrichtigung, die du senden willst.

Die Liste unter Kontoeinstellungen → Webhooks zeigt für jeden Webhook den Namen mit Statuspunkt, die URL, das Zustellformat und die Signaturposition. Klicke auf einen Webhook, um die Details zu sehen: URL, Zustellformat (zum Beispiel Standard), Signaturposition (zum Beispiel Header), Erstellungsdatum und Signatur-Secret mit Kopier-Button. Dort kannst du den Webhook auch bearbeiten oder löschen.

Einen neuen Webhook konfigurieren.

Einen neuen Webhook konfigurieren.

Ereignisse

Jedes Ereignis, das die Standardbenachrichtigungen von fynk abdecken, kann auch an einen Webhook gesendet werden, zum Beispiel wenn ein Dokument in eine andere Phase wechselt oder unterzeichnet wird. Sobald ein Eigentümer einen Webhook eingerichtet hat, können alle im Konto ihn als Ziel nutzen.

Beispiele

  • Microsoft Teams: Poste eine Nachricht in einem Kanal, wenn ein Vertrag unterzeichnet wird, über einen eingehenden Webhook oder einen Teams-Workflow.
  • Zapier, Make oder n8n: Starte eine Automatisierung, wenn sich ein Dokument ändert, zum Beispiel um das signierte PDF in SharePoint zu speichern.
  • BI und Reporting: Sende Vertragsdaten an dein Data Warehouse.

Gut zu wissen

  • Anfragen enthalten Ereignisinformationen als JSON. Sie enthalten Signatur-Header nach der Standard-Webhooks-Spezifikation, signiert mit dem Signatur-Secret des Webhooks. So kann das empfangende System prüfen, ob eine Anfrage von fynk stammt.
  • Kombiniere Webhooks mit der API, um nach einem Ereignis weitere Details zu einem Dokument abzurufen. Siehe REST API: Erste Schritte.
  • Ein Ereignis „Dokument angesehen“ gibt es nicht.

Verwandte Artikel

War dies hilfreich?

Brauchen Sie noch Hilfe? Team fragen