Integration via Webhook einrichten

Webhooks ermöglichen anderen Systemen, über eine einfache technische Schnittstelle Dokumente zu empfangen und dort weiter zu verwenden.

Voraussetzungen

Für die Verwendung für Webhooks benötigen Sie einen Web-Server, der die von uns gemachten Anfragen laut der folgenden Spezifikation verarbeiten kann:

Der Upload erfolgt ausschließlich über HTTPS.

Jeder Scan wird via POST-Anfrage als multipart/form-data Payload mit zwei Teilen geliefert: Die Binärdatei ‘document’ und einen ‘meta’-Teil, der sendungsrelevante Daten (JSON) enthält.

Als Antwort wird ein 20X-Status erwartet. Der Content-Type wird nicht geprüft.

Beispiel für eine angedeutete Anfrage:

--DropscanBoundary

Content-Disposition: form-data; name="metadata"; filename="metadata.json" Content-Length: 15

Content-type: application/json

Content_Transfer-Encoding: binary {"uuid":"de5ebcea-e509-44a8-b7e1-c429f4f75b1e", scanbox_id: 1234, scanned_at: }

--DropscanBoundary

Content-Disposition: form-data; name="document"; filename="scan.pdf"

Content-Length: 754771

Content-type: application/pdf

Content_Transfer-Encoding: binary

%PDF-1.5 […]

` –DropscanBoundary—`

Einrichtungsschritte bei Dropscan

1. Melden Sie Sich bei Ihrem Dropscan-Konto an. Dort klicken Sie oben rechts auf Ihre E-Mail-Adresse und dann auf Einstellungen.
2. Wählen Sie Webhook unter dem Menüpunkt Integrationen aus.
3. Tragen Sie die Webhook-URL ein, an die wir die Dokumente versenden sollen.
4. Klicken Sie auf Einrichten.

Zur Bestätigung der erfolgreichen Einrichtung senden wir ein erstes Test-Dokument. Sollte es Probleme bei der Einrichtung geben, werden Sie natürlich von uns informiert.

Nächste Schritte

Die Integration stellt nur die Verbindung zu Ihrem Webhook-Server her. Für das Teilen von gescannten Dokumenten mit dieser Integration haben Sie zwei Möglichkeiten:

• Dokumente manuell teilen

• Dokumente automatisch teilen mit einem Workflow

Informationen dazu finden Sie hier.