Zapier
Zapier verbindet AIDA in beide Richtungen mit Tausenden von Apps wie Google Sheets, Gmail, Google Drive, Slack, Ihrem ERP und mehr (Beta):
- das Zapier-Ziel sendet jedes in AIDA freigegebene Dokument an einen Zap, damit Sie seine Daten und das PDF weiterleiten können (AIDA mit Zapier verbinden);
- der Zapier-Eingang empfängt Dateien aus einem Zap, damit Dokumente aus anderen Apps in AIDA hochgeladen und verarbeitet werden (Dokumente aus Zapier hochladen).
AIDA mit Zapier verbinden
- Öffnen Sie in AIDA den Dokumenttyp, fügen Sie das Ziel Zapier hinzu und speichern Sie.
- Kopieren Sie den Schlüssel des Ziels.
- Erstellen Sie in Zapier einen Zap mit dem Trigger AIDA → Document Approved. Fügen Sie den Schlüssel ein, wenn Sie zur Verbindung aufgefordert werden. Die Verbindung trägt den Namen des Dokumenttyps, zum Beispiel
Invoice (Zapier destination). - Testen Sie den Trigger: Zapier lädt die drei zuletzt verarbeiteten Dokumente dieses Typs als Beispiele. Geben Sie vorher mindestens ein Dokument frei.
- Fügen Sie die benötigten Aktionen hinzu, ordnen Sie die Felder zu und veröffentlichen Sie den Zap.
Ab dann wird jedes mit diesem Ziel freigegebene Dokument an den Zap gesendet. Die Schaltfläche Ihre Zaps öffnen im Ziel öffnet Ihre Zaps in Zapier.
note
Jedes Zapier-Ziel versorgt genau einen Zap: Wenn Sie einen neuen Zap mit demselben Schlüssel verbinden, wird der vorherige ersetzt. Um mehrere Zaps zu versorgen, fügen Sie mehrere Zapier-Ziele hinzu. Wenn Sie den Schlüssel neu generieren, wird der Zap getrennt.
Wird der Zap ausgeschaltet oder gelöscht, wird das Ziel getrennt, und neue Freigaben enden mit dem Fehler zapierNotConnected, bis wieder ein Zap verbunden ist.
Payload
Jedes freigegebene Dokument wird als JSON-Objekt gesendet. Die in Zapier angezeigten Beispieldatensätze haben dasselbe Format.
| Feld | Typ | Beschreibung |
|---|---|---|
id | string | Die ID des Dokuments in AIDA. |
documentName | string | Der Name des Dokuments. |
documentConfigurationName | string | Der Name des Dokumenttyps. |
documentURL | string | Ein dauerhafter Link, um das Dokument in der AIDA-Webanwendung anzuzeigen. |
downloadURL | string | Ein temporärer, sicherer Link zum Herunterladen des PDFs. Er läuft nach 7 Tagen ab. |
Die extrahierten Eigenschaften folgen denselben Regeln wie beim Webhook-Ziel: Der Schlüssel ist der Feldname in Integrationen der Eigenschaft oder, falls nicht gesetzt, ihre Bezeichnung, Werte werden in ihren JSON-Typ umgewandelt und Tabellen werden zu Arrays. Anders als beim Webhook sind Datumswerte ISO-8601-Zeichenketten in UTC (zum Beispiel 2025-10-14T00:00:00Z).
{
"Invoice number": "INV-2025-042",
"invoiceDate": "2025-10-14T00:00:00Z",
"total": 122.00,
"lines": [
{ "description": "Product A", "qty": 2, "unitPrice": 50.00 }
],
"id": "12345",
"documentName": "invoice-042.pdf",
"documentConfigurationName": "Invoice",
"documentURL": "https://www.aidacloud.com/app/web/archive/12345",
"downloadURL": "https://api.aidacloud.com/asset/document/generated-auth-token"
}
Dokumente aus Zapier hochladen
- Öffnen Sie in AIDA den Dokumenttyp, gehen Sie zu Eingang und aktivieren Sie den Eingang Zapier.
- Kopieren Sie den Schlüssel des Eingangs.
- Erstellen Sie in Zapier einen Zap mit dem benötigten Trigger (zum Beispiel Google Drive → New File in Folder oder Gmail → New Attachment) und fügen Sie die Aktion AIDA → Upload Document hinzu. Fügen Sie den Schlüssel ein, wenn Sie zur Verbindung aufgefordert werden. Die Verbindung trägt den Namen des Dokumenttyps, zum Beispiel
Invoice (Zapier input). - Ordnen Sie die Felder zu, testen Sie die Aktion und veröffentlichen Sie den Zap.
Jede Datei, die der Zap sendet, wird in den Dokumenttyp hochgeladen und wie ein Dokument aus jedem anderen Eingang verarbeitet. Die Schaltfläche Ihre Zaps öffnen im Eingang öffnet Ihre Zaps in Zapier.
| Feld | Pflicht | Beschreibung |
|---|---|---|
| File | ja | Die zu verarbeitende Datei (PDF oder Bild). |
| File Name | nein | Der Name des Dokuments. Standardmäßig der Name der Datei. |
| Property values | nein | Vorauszufüllende Werte, einer pro Eigenschaft: Der Schlüssel ist der Feldname in Integrationen der Eigenschaft oder ihre Bezeichnung. Unbekannte Schlüssel werden ignoriert. |
Die Aktion liefert das neue Dokument: id, documentConfigurationId, documentConfigurationName und documentName.
note
Der Zapier-Eingang und das Zapier-Ziel haben unterschiedliche Schlüssel: Verwenden Sie den Schlüssel des Eingangs für Upload Document und den des Ziels für Document Approved. Ein Schlüssel des falschen Typs wird mit einer Meldung abgelehnt, die den richtigen nennt. Solange der Eingang deaktiviert ist, schlagen Uploads mit dem Fehler inputFlowNotEnabled fehl.
Wenn ein Dokumenttyp keinen Zapier-Eingang hat, kontaktieren Sie uns .
API-Referenz
Die AIDA-App für Zapier verwendet die folgenden Endpunkte. Die Basis-URL ist https://api.aidacloud.com/api/v1/zapier.
Authentifizierung: Jede Anfrage sendet den Schlüssel des Zapier-Ziels oder des Zapier-Eingangs im Header X-API-Key. Ein fehlender oder unbekannter Schlüssel liefert 401 Unauthorized, ein Schlüssel des anderen Typs 403 Forbidden. GET /me akzeptiert beide Schlüssel, POST /documents den Schlüssel des Eingangs, die übrigen Endpunkte den des Ziels.
| Methode | Pfad | Zweck | Body | Antwort |
|---|---|---|---|---|
GET | /me | Testet die Verbindung. type ist destination oder input. | - | { "id", "documentConfigurationId", "documentConfigurationName", "username", "type", "connectionLabel" } |
POST | /hooks | Abonniert den Zap (REST-Hook). Die URL muss mit https://hooks.zapier.com/ beginnen, sonst 400. | { "hookUrl": "…" } | { "id" } |
DELETE | /hooks | Kündigt das Abonnement des Zaps. Das Ziel wird nur getrennt, wenn hookUrl der aktuell verbundene ist. | { "hookUrl": "…" } | leer |
GET | /documents/sample | Liefert bis zu drei kürzlich verarbeitete Dokumente des Dokumenttyps im Payload-Format. | - | Array von Payloads |
POST | /documents | Lädt eine Datei in den Dokumenttyp hoch. Ohne file 400, bei deaktiviertem Eingang 403 inputFlowNotEnabled. | multipart/form-data: file (mit Dateinamen) und ein Feld pro Eigenschaftswert | { "id", "documentConfigurationId", "documentConfigurationName", "documentName" } |
Zustellung: Wenn ein Dokument freigegeben wird, sendet AIDA einen HTTP POST mit dem Payload an den abonnierten Hook, mit Content-Type: application/json. Antwortet Zapier mit 410 Gone, trennt AIDA das Ziel.