Webhooks für Benachrichtigungen bei neuen PDF-Formulareinreichungen konfigurieren

Benjamin André-Micolon

Eine leistungsstarke Möglichkeit, Einreichungen an Ihre Anwendung zu senden oder SimplePDF mit anderen Diensten wie Zapier oder Activepieces zu verbinden, sind Webhooks.

Webhooks?

Webhooks ermöglichen es, Anwendungen miteinander zu verbinden, indem sie Daten in Echtzeit von einer Anwendung an die andere(n) senden, sobald ein bestimmtes Ereignis eintritt.

In SimplePDF wird jedes Mal, wenn ein PDF eingereicht wird - über Ihr Unternehmensportal, entweder über Formular-Links oder eingebettet in Ihre Website - ein Event gesendet, das unter anderem den Dokumentnamen und die Einreichungs-URL enthält.

Von dort an sind die Möglichkeiten grenzenlos und Sie können Ihrer Fantasie freien Lauf lassen.

Sie könnten zum Beispiel diese Informationen in einem Google Sheet speichern oder mit Zapier oder Activepieces integrieren und noch mehr Möglichkeiten erschließen!

Webhooks in SimplePDF konfigurieren

Die Konfiguration von Webhooks ist mit dem BASIC-Tarif verfügbar

• Melden Sie sich in Ihrem Konto an
• Navigieren Sie zur Kontoeinstellungen-Ansicht

• Klicken Sie auf Update configuration
• Geben Sie die Webhook-URL des Dienstes oder der Anwendung ein, an die Sie Events senden möchten

• Optional: Geben Sie die Header an, die als Teil des Webhooks gesendet werden sollen

Das war's! Ein Event wird bei jeder neuen Einreichung gesendet

Webhook-Events

Nachfolgend finden Sie die Events, die SimplePDF an den von Ihnen konfigurierten Webhook sendet.

• Neue Einreichung

Payload

type: "submission.created",
data: {
  document: {
    id: "b7615a68-9e1f-4eac-bd20-5e80632a4d9e",
    name: "your_document.pdf",
  },
  submission: {
    id: "80146d5b-a068-490f-8eb9-fe393ba11396",
    submitted_at: "2023-06-04T11:54:58.995Z",
    url: "short_lived_15min_url",
  },
  context: {
    environment: "production",
    customer_id: "123"
  }
}

Über den Kontext

Wenn Sie SimplePDF in Ihre Website integrieren, möchten Sie möglicherweise zusätzliche Informationen an Einreichungen knüpfen.

Zum Beispiel möchten Sie vielleicht:

• Wissen, ob die Einreichung aus einer Entwicklungsumgebung (environment) oder einer Produktionsumgebung (production) stammt.
• Zusätzliche Details darüber senden, wer das Formular eingereicht hat (z. B. ein angemeldeter Nutzer), um die Verarbeitung der Einreichung zu erleichtern.

Erfahren Sie, wie Sie einen context angeben, in der Dokumentation von SimplePDF Embed

Playground

Bei SimplePDF mögen wir Beispiele - wie wäre es also mit einem Praxisbeispiel, wie Webhooks aussehen?

1. Passen Sie den Kontext unten an (klicken Sie, um den Inhalt zu bearbeiten)

{"environment":"production","customer_id":"123"}

2. Reichen Sie dieses Formular ein

3. Der von SimplePDF gesendete Webhook erscheint hier

Wenn Sie Fragen haben, wenden Sie sich gerne an support@simplepdf.com