Webhooks einrichten, um Dokumentstatusaktualisierungen zu erhalten

Verwendung von Webhooks zum Abrufen von Dokumentstatusaktualisierungen

🔔 Erhalten Sie automatische Benachrichtigungen, sobald Ihr Dokument fertig ist

Möchten Sie in Echtzeit über den Bearbeitungsstatus Ihrer Dokumente informiert werden? Nutzen Sie Webhooks , um Ihr System automatisch zu benachrichtigen, sobald eine Datei fertiggestellt ist.


🔑 Generieren Sie Ihren Webhook-Geheimschlüssel

  1. Gehen Sie zu Einstellungen > API-Integration

  2. Klicken Sie unter „Webhook-Geheimschlüssel generieren“ auf „Geheimschlüssel generieren“ .

  3. Dieser Schlüssel dient zum Signieren und Validieren eingehender Webhook-Benachrichtigungen.

Bewahren Sie Ihren Schlüssel sicher auf. Wenn Sie ihn neu generieren, stellen Sie sicher, dass Sie ihn in Ihrem Webhook-Verarbeitungssystem aktualisieren.


🔧 Webhook über die API einrichten

Um Dokumentabschlussereignisse zu empfangen, verwenden Sie den Abschnitt Webhooks unter Einstellungen > API-Dokumentation .

🔹 Webhook erstellen

POST /v1/admin/company/webhooks

Beispieltext:

Beispiel für einen Körper

  • Die url muss ein sicherer HTTPS Endpunkt sein, der POST Anfragen akzeptieren kann.

  • Das event sollte "file_processed" sein (derzeit ist dies das verfügbare Ereignis).

🔹 Alle Webhooks auflisten

GET /v1/admin/company/webhooks
Gibt die Liste der bereits in Ihrem Unternehmenskonto konfigurierten Webhooks zurück.

🔹 Einen Webhook löschen

DELETE /v1/admin/company/webhooks/{id}
Verwenden Sie diesen Endpunkt, um einen Webhook anhand seiner ID zu entfernen.

✅ Anwendungsbeispiel

Sobald Ihr Webhook registriert ist, erhalten Sie eine POST Anfrage, wenn die Verarbeitung eines Dokuments abgeschlossen ist.
Beispielantwort:

Stellen Sie sicher, dass Ihr Endpunkt die Anfrage mithilfe Ihres Webhook-Geheimschlüssels verarbeiten und verifizieren kann.