Wie erstellt man Webhooks in Papermark?

Webhooks-Einstellungsseite

Müssen Sie Automatisierungen auslösen, wenn etwas in Papermark passiert? Mit Webhooks können Sie Ereignisse wie link.viewed oder document.created in Echtzeit an jeden externen Dienst senden.

Webhooks sind im Business-Plan verfügbar (oder während Ihrer kostenlosen Testphase). Sie müssen Workspace-Besitzer oder Administrator sein, um sie zu verwalten.

Bevor Sie beginnen

• Entscheiden Sie, wo Sie die Ereignisse empfangen möchten (z.B. Slack, Zapier, benutzerdefinierter Endpunkt).
• Stellen Sie sicher, dass das Ziel POST-Anfragen mit JSON-Inhalten akzeptieren kann.
• Generieren Sie Ihre Empfangs-URL oder haben Sie Zugriff darauf.

Schritt für Schritt

Einstellungen öffnen – Klicken Sie auf das Einstellungen-Symbol in der linken Seitenleiste und wählen Sie dann Webhooks im Menü.

Webhooks-Einstellungen Seitenleiste

Webhook erstellen – Drücken Sie Webhook erstellen in der oberen rechten Ecke.

Webhook-Erstellungsformular

Benennen Sie es – Geben Sie einen aussagekräftigen Namen ein, z. B. Slack-Benachrichtigungen (mind. 3 Zeichen).
Fügen Sie Ihre Endpunkt-URL ein – Hierhin sendet Papermark die POST-Anfragen.
Kopieren Sie das Secret – Ein eindeutiges Signatur-Secret wird automatisch generiert. Speichern Sie es, damit Sie Signaturen verifizieren können.
Wählen Sie Trigger aus – Wählen Sie ein oder mehrere Ereignisse zum Senden aus. Sie können Trigger aus mehreren Kategorien kombinieren:
- Team-Ebene – document.created, document.updated, document.deleted, dataroom.created
- Dokument-Ebene – link.created, link.updated
- Link-Ebene – link.viewed, link.downloaded

Neue Webhook-Trigger: link.created und document.created

Zwei Trigger sind besonders nützlich für die Automatisierung:

link.created wird ausgelöst, sobald ein neuer Link für ein Dokument oder einen Datenraum erstellt wird
document.created wird ausgelöst, sobald ein neues Dokument hochgeladen wird

Typische Automatisierungen, die damit möglich sind:

CRM-Synchronisierung: Wenn ein neuer Link für einen Investor erstellt wird, wird ein Datensatz in HubSpot oder Salesforce übertragen
Slack-Benachrichtigungen: Benachrichtige einen Vertriebskanal, wenn ein neuer Pitch-Deck-Link erstellt wird
Zapier-Workflows: Starte eine mehrstufige Automatisierung, sobald ein Dokument hochgeladen wird
Internes Tracking: Protokolliere jeden Link und jedes Dokument in deinem eigenen Data Warehouse für Analysen

Beispiel-Payload für link.created:

{
  "event": "link.created",
  "data": {
    "id": "link_abc123",
    "url": "https://docs.acme.com/aB3kP9xQ7m",
    "documentId": "doc_xyz456",
    "name": "Investor pitch v3",
    "createdAt": "2026-05-29T12:34:56Z"
  }
}

Beispiel-Payload für document.created:

{
  "event": "document.created",
  "data": {
    "id": "doc_xyz456",
    "name": "Q1 2026 financials.xlsx",
    "type": "spreadsheet",
    "teamId": "team_789",
    "createdBy": "user@acme.com",
    "createdAt": "2026-05-29T12:34:56Z"
  }
}

Auswahl der Webhook-Trigger

Webhook speichern – Klicke auf Erstellen. Du siehst den neuen Webhook in der Liste mit seinem Status.
Zustellung testen – Führe eine Aktion durch, die einem deiner Trigger entspricht, und überprüfe deinen Endpunkt oder das Zustellungsprotokoll.

Signaturen verifizieren

Jede Anfrage enthält einen X-Papermark-Signature-Header mit einem HMAC-SHA-256-Hash des Payloads. Hashe das rohe JSON mit deinem gespeicherten Secret und vergleiche den Hex-Wert, um sicherzustellen, dass der Aufruf wirklich von Papermark stammt.

X-Papermark-Signature: 3a1d5f…

Webhooks verwalten

• Bearbeiten – Klicke auf einen Webhook in der Liste, um ihn umzubenennen, Trigger hinzuzufügen/zu entfernen oder die URL zu ändern.
• Protokolle anzeigen – Öffne einen Webhook und wechsle zum Zustellungsprotokoll, um jeden Versuch und den jeweiligen Antwort-Code einzusehen.
• Löschen – Verwende die Schaltfläche Löschen auf der Webhook-Detailseite, um Zustellungen zu stoppen.

Tipps

Halte deinen Endpunkt hochverfügbar; Papermark wiederholt fehlgeschlagene Zustellversuche für 24 Stunden.
Verwende Warteschlangen (z. B. AWS SQS, RabbitMQ), um die Verarbeitung von der Empfangnahme zu entkoppeln.
Filtere Ereignisse nach dem Feld event, um sie an verschiedene Handler weiterzuleiten.