# Zapier-Integration

Mit Zapier können Sie Dateien aus Dropbox, Gmail, Slack, Google Drive und Tausenden weiteren Apps ohne eigenen Code an Transloadit senden. Transloadit führt dann für jede Zapier-Aktion ein gespeichertesTemplate aus, beispielsweise um ein Video zu konvertieren, Text aus einem Dokument zu extrahieren, ein Bild zu optimieren oder eine fertige Datei in Ihrem Cloud-Bucket zu speichern.

Verwenden Sie für neue Workflows die Zapier-Aktion **Create Assembly**. Sie funktioniert mit jedem gespeicherten Transloadit-Template. Die voreingestellten Aktionen der Integration wie**Optimize Video** bleiben für ältere Zaps verfügbar, mit Templates steuern Sie jedoch den gesamten Workflow zur Dateiverarbeitung.

Das wichtigste Grundprinzip lautet:

1. Erstellen und testen Sie zuerst den Workflow zur Dateiverarbeitung in Transloadit.
2. Speichern Sie diesen Workflow als Template.
3. Verbinden Sie Zapier mit dem Transloadit-Workspace, dem das Template gehört.
4. Wählen Sie in Zapier das Template aus und ordnen Sie Dateien oder Felder aus dem vorherigen Zap-Step zu.

Ein vollständiges Workflow-Beispiel finden Sie in unserem Tutorial zum[automatischen Einbrennen von Logos in Videos, sobald diese zu Google Drive hinzugefügt werden](/blog/2019/10/automatically-burn-logos-into-newly-added-files/).

### Der schnellste Weg zu einem erfolgreichen Zap

Prüfen Sie mit dieser Checkliste die Verbindung, bevor Sie Ihren produktiven Workflow erstellen:

1. [Erstellen Sie ein Template](/c/templates/new/) namens `zapier-smoke-test` mit dem unten stehenden JSON.
2. [Erstellen Sie einen Auth Key](/c/template-credentials/) im selben Workspace mit den Berechtigungen`templates:read`, `assemblies:read` und `assemblies:write`. Vollständiger Zugriff funktioniert ebenfalls, gewährt jedoch mehr Zugriff, als diese Integration benötigt.
3. Erstellen und testen Sie in Zapier den Trigger Ihrer Quell-App mit einer neuen, kleinen Datei.
4. Fügen Sie die Transloadit-Aktion **Create Assembly** hinzu und verbinden Sie den Auth Key mit dem zugehörigen Auth Secret.
5. Wählen Sie unter **Template ID** den Eintrag `zapier-smoke-test` aus und ordnen Sie die Quelldatei**File(s)** zu.
6. Testen Sie die Aktion. Prüfen Sie anschließend, ob die Assembly auf Ihrer [Assemblies-Seite](/c/assemblies/)erscheint und `ASSEMBLY_COMPLETED` erreicht.

Sobald dies funktioniert, wählen Sie Ihr produktives Template aus. Wenn ein späterer Zap-Step die verarbeitete Datei benötigt, folgen Sie vor dem Aktivieren des Workflows der Anleitung[Ein fertiges Ergebnis in einer anderen App verwenden](#ein-fertiges-ergebnis-in-einer-anderen-app-verwenden).

### Ein Smoke-Test-Template erstellen

Erstellen Sie ein Template namens `zapier-smoke-test` mit diesen Instructions:

![](/_next/static/media/copy.04p1cju9qekk_.svg?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

```json
{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "metadata": {
      "use": ":original",
      "robot": "/meta/read",
      "result": true
    }
  }
}

```

Dieses Template akzeptiert einen Upload und liest dessen Metadaten, ohne ihn zu speichern oder zu transformieren. Damit können Sie die Zapier-Authentifizierung und Dateizuordnung schnell und kostengünstig von der Komplexität Ihres eigentlichen Workflows isolieren.

### Bevor Sie Zapier öffnen

Bereiten Sie diese Werte vor, bevor Sie Zapier öffnen:

* Einen Transloadit-Workspace mit einem aktiven Auth Key undAuth Secret. Sie finden beide auf der[Seite „Zugangskonfigurationen“](/c/template-credentials/). Ein eng begrenzter Schlüssel benötigt`templates:read`, damit Zapier die Template-Auswahlliste füllen kann, `assemblies:read`, damit die Verbindung getestet und der Abschluss über Trigger abgefragt werden kann, sowie `assemblies:write`, damit Assemblies erstellt werden können.
* Ein gespeichertes Template im selben Workspace. Zapier führt das Template aus; es ersetzt nicht den Template Editor.
* Eine Testdatei aus der App, die den Zap startet, beispielsweise eine Dropbox-Datei, eine Google-Drive-Datei, einen E-Mail-Anhang oder eine URL zu einem Formular-Upload. Verwenden Sie neue Trigger-Testdaten und halten Sie die erste Datei deutlich unter 100 MB, damit Zapier sie zuverlässig abrufen kann.

###### Wichtig

Verwenden Sie Zugangsdaten aus demselben Workspace, dem das Template gehört. Wenn Sie Zapier mit einem Auth Key aus einem anderen Workspace verbinden, kann sich Zapier erfolgreich authentifizieren, das erwartete Template jedoch weder sehen noch ausführen.

Wenn Sie getrennte Transloadit-Workspaces für Staging und Produktion verwenden, benennen Sie die Zapier-Verbindung nach der Umgebung. Verwenden Sie beispielsweise `Transloadit staging` für einen Auth Key für Staging und `Transloadit production` für einen produktiven Auth Key. Dadurch ist es deutlich schwieriger, einen Zap mit einem Workspace zu testen und sich später zu fragen, warum das produktive Template fehlt.

### Zapier mit Transloadit verbinden

[Fügen Sie in Zapier eine Transloadit-Aktion hinzu](https://zapier.com/apps/transloadit/integrations) und wählen Sie**Create Assembly**. Wenn Zapier Sie auffordert, ein Transloadit-Konto zu verbinden, klicken Sie auf**Sign in to Transloadit**.

###### Hinweis

Zapier aktualisiert seinen Editor regelmäßig, daher kann das Layout von diesen Screenshots abweichen. Die Aktions- und Feldbezeichnungen in dieser Anleitung entsprechen der aktuellen Transloadit-Integration.

![Zapier mit der Schaltfläche „Bei Transloadit anmelden“](/_next/static/media/Screenshot_2019-10-29_at_13.47.59.15ehcjx3406un.png?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

Zapier öffnet anschließend ein kleines Authentifizierungsfenster. Abhängig von der von Zapier angezeigten Version der Transloadit-App verwenden die Felder entweder die spezifischen oder die älteren allgemeinen Bezeichnungen:

* **Transloadit Auth Key** oder**Key** ist Ihr Transloadit-Auth Key.
* **Transloadit Auth Secret** oder**Secret** ist das zugehörige Transloadit-Auth Secret.

Transloadit fragt Zapier nicht nach dem Passwort Ihres Transloadit-Kontos. Das Auth Secret ist auch nicht der Workspace-Slug, die Template ID oder Ihr Zapier-Passwort.

Zapier speichert diese Verbindung in Ihrem Zapier-Konto. Künftige Zaps können sie wiederverwenden. Geben Sie der Verbindung daher einen Namen, der den Workspace eindeutig erkennen lässt, beispielsweise`Transloadit production` oder `Transloadit staging`.

![Zapier mit einer ausgewählten Transloadit-Kontoverbindung](/_next/static/media/Screenshot_2019-10-29_at_13.50.36.16dxo9i6u4l--.png?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

Wenn Sie den Auth Key in Transloadit rotieren, deaktivieren oder löschen, verbinden Sie das Zapier-Konto mit einem neuen Schlüsselpaar. Bestehende Zaps, die die alte Verbindung verwenden, können keine Assemblies mehr erstellen.

### Die Aktion **Create Assembly** konfigurieren

Nach der Authentifizierung fragt Zapier, wie die Transloadit-Assembly erstellt werden soll.

![Einrichtung der Zapier-Aktion „Assembly erstellen“](/_next/static/media/zapier-action-setup.07vn5mifqm~kh.png?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

Konfigurieren Sie mindestens Folgendes:

* **Template ID**: Wählen Sie das gespeicherte Transloadit-Template aus, das die Datei verarbeiten soll.
* **File(s)**: Ordnen Sie bei Upload-basierten Templates das Dateiobjekt oder die direkte Download-URL aus dem vorherigen Zap-Step zu. Lassen Sie dieses Feld nur leer, wenn das Template seine Eingabe selbst bezieht, beispielsweise über einen Import-Robot oder einen Robot zur KI-Generierung.
* **Assembly Fields**: Übergeben Sie optional Werte wie Kunden-IDs, Bestell-IDs oder Dateinamen an die Assembly, damit sie im Assembly Status JSON erscheinen.

Zapier-Apps stellen häufig mehrere ähnlich aussehende Felder bereit, beispielsweise eine Vorschau-URL, eine Webansichts-URL, ein Dateiobjekt und eine direkte Download-URL. Wählen Sie für Transloadit das Feld, das auf die tatsächlichen Dateibytes verweist. Eine Vorschauseite im Browser reicht nicht aus. Bevorzugen Sie das Dateiobjekt der Quell-App; Zapier zeigt dessen Testwert möglicherweise als\*\*(Exists but not shown)\*\* an. Wenn Sie eine URL verwenden, muss sie öffentlich zugänglich sein und direkt auf die Datei statt auf eine Vorschauseite verweisen. Weitere Informationen finden Sie in Zapiers Anleitung zum[Senden von Dateien in Zap-Workflows](https://help.zapier.com/hc/en-us/articles/8496288813453-Send-files-in-Zap-workflows).

**File(s)** ist ein Listenfeld. Ordnen Sie jeden Anhang einem separaten Listenelement zu, wenn eine einzelne Assembly mehrere Uploads benötigt. Fügen Sie nicht mehrere durch Kommas getrennte URLs in ein Listenelement ein, da Zapier möglicherweise unbemerkt nur die erste sendet. Eine Aktion**Create Assembly** erstellt immer genau eine Assembly. Verwenden Sie vor der Aktion eine Zapier-Schleife, wenn jede Quelldatei eine separate Assembly erstellen soll.

![Einrichtung einer Zapier-Aktion mit der Transloadit-Aktion „Assembly erstellen“](/_next/static/media/zapier-create-assembly.067qsxo6~67c-.png?dpl=dpl_3z41v8VuCJJKgtsQfSKB6o2uiSXL)

Führen Sie den Zapier-Test-Step einmal aus. Öffnen Sie anschließend im selben Workspace die[Assemblies-Seite](/c/assemblies/) von Transloadit und prüfen Sie, ob eine neue Assembly erschienen ist. Sie wird möglicherweise noch ausgeführt, wenn die Zapier-Aktion zurückkehrt. Warten Sie, bis sie`ASSEMBLY_COMPLETED` erreicht. Ist dies der Fall, funktionieren Authentifizierung, Template-Auswahl und Dateizuordnung.

Die Aktion gibt die **Assembly ID**, den aktuellen**Assembly Status** und die**Assembly Status URL** zurück. Speichern Sie die Assembly ID im ursprünglichen Datensatz, wenn Sie eine dauerhafte Referenz für Audits oder Support benötigen. Diese Ausgaben identifizieren die Assembly, enthalten aber keine verarbeitete Datei, solange die asynchrone Arbeit noch läuft.

Die Test-Assembly ist die maßgebliche Referenz. Wenn der Zapier-Test erfolgreich ist, Sie aber keine neue Assembly sehen, ist der Zap wahrscheinlich mit einem anderen Workspace als dem geprüften verbunden.

### Ein fertiges Ergebnis in einer anderen App verwenden

**Create Assembly** startet die Arbeit asynchron. Ordnen Sie eine Ergebnis-URL aus dieser Aktion nicht direkt dem nächsten Zap-Step zu. Ein reiner Metadatentest wird möglicherweise schnell genug abgeschlossen, sodass dies zuverlässig erscheint, während Workflows mit Videos, Dokumenten und größeren Bildern erst später fertig werden.

Verwenden Sie zwei Zaps, wenn eine andere App die verarbeitete Datei benötigt:

1. **Eingabe-Zap**: Trigger der Quell-App → Transloadit**Create Assembly**.
2. **Ergebnis-Zap**: Transloadit-Trigger **Assembly Result** → Aktion Ihrer Ziel-App.

Wählen Sie im Trigger **Assembly Result** dieselbe**Template ID** aus und geben Sie den exakten Namen des Ergebnis-Steps aus dem Template ein. Beim obigen Smoke-Test-Template lautet der Step `metadata`. Ordnen Sie den Wert**File** des Triggers dem Dateifeld der Ziel-App zu oder verwenden Sie**SSL URL**, wenn diese App eine öffentliche URL akzeptiert.

Verwenden Sie stattdessen den Transloadit-Trigger **Finished Assembly**, wenn der zweite Zap nur Abschlussmetadaten und keine bestimmte Ergebnisdatei benötigt. Da es sich um Polling-Trigger handelt, hängt die Verzögerung bis zum Start des Ergebnis-Zaps von Ihrem Zapier-Tarif ab und ist unabhängig von der Verarbeitungszeit bei Transloadit.

### Häufige Authentifizierungsprobleme

#### Zapier meldet ungültige Zugangsdaten

Prüfen Sie, ob Sie den Auth Key in Zapiers Feld**Transloadit Auth Key** oder **Key** und das zugehörige Auth Secret in**Transloadit Auth Secret** oder**Secret** kopiert haben. Das Auth Secret ist weder Ihr Kontopasswort noch der Workspace-Slug. Prüfen Sie außerdem, ob der Schlüssel aktiv ist und über den Zugriff `assemblies:read`verfügt, den Zapier zum Testen der Verbindung verwendet.

#### Zapier stellt eine Verbindung her, aber das Template fehlt oder schlägt fehl

Die häufigste Ursache ist ein nicht übereinstimmender Workspace. Zapier authentifiziert sich gegenüber dem Workspace, dem der Auth Key gehört. Stellen Sie sicher, dass auch das auszuführende Template zu diesem Workspace gehört.

Wenn die Template-Auswahlliste leer ist, verbinden Sie Transloadit in Zapier erneut mit einem Auth Key aus dem Workspace, dem Ihr Template gehört, und prüfen Sie, ob der Schlüssel über den Zugriff`templates:read` verfügt. Wenn das Template erscheint, Zapier aber keine Assembly erstellen kann, prüfen Sie den Zugriff `assemblies:write`. Wenn eine Assembly erstellt wird, aber fehlschlägt, öffnen Sie sie in Transloadit und prüfen Sie den ersten fehlerhaften Step. Die Authentifizierung hat dann funktioniert und das Problem liegt normalerweise an der Template-Konfiguration oder einem unbrauchbaren Eingabedateifeld.

#### Der Zap hat zuvor funktioniert, schlägt jetzt aber fehl

Prüfen Sie, ob der Auth Key rotiert, deaktiviert oder gelöscht wurde oder ob sich sein Berechtigungsumfang geändert hat. Verbinden Sie Transloadit nach Änderungen an der Zugangskonfiguration in Zapier erneut.

#### Der Zap erstellt eine Assembly, spätere Zap-Steps sehen die Ergebnisdatei jedoch nicht

Verwenden Sie die Zwei-Zap-Konfiguration unter[Ein fertiges Ergebnis in einer anderen App verwenden](#ein-fertiges-ergebnis-in-einer-anderen-app-verwenden). Prüfen Sie im Ergebnis-Zap, ob **Step** exakt mit dem Namen eines Ergebnis-Steps im Template übereinstimmt; dies ist weder ein Robot-Name noch ein Dateiname.

#### Dropbox oder Google Drive stellt keine nutzbare Datei-URL bereit

Einige App-Trigger stellen Metadaten bereit, bevor die Datei verfügbar ist, oder liefern eine URL, die Zapier nicht als herunterladbare Datei senden kann. Prüfen Sie im Testergebnisbereich von Zapier, ob das ausgewählte Feld auf die Binärdatei und nicht nur auf eine Vorschauseite verweist.

Wenn die Datei durch private App-Berechtigungen geschützt ist, verwenden Sie das Dateiobjekt, das Zapier vom Trigger-Step erhalten hat, und keine aus Dropbox oder Google Drive kopierte Browser-URL. Testen Sie den Trigger erneut, wenn sein Beispiel keine Datei oder eine abgelaufene Referenz enthält. Zapier weist darauf hin, dass bei Dateien über 100 MB eine Zeitüberschreitung auftreten kann und eine Datei innerhalb von 30 Sekunden abgerufen werden muss. Verwenden Sie daher für die Einrichtung eine kleinere Datei, auch wenn Transloadit selbst größere Uploads unterstützt.

### Was Sie vor der Kontaktaufnahme mit dem Support zusammenstellen sollten

Wenn Sie weiterhin nicht weiterkommen, senden Sie uns:

* die verwendete Zapier-App und den Trigger, beispielsweise Dropbox**New File in Folder**;
* den Namen des Transloadit-Workspaces;
* den Template-Namen oder die Template ID;
* die öffentliche ID des Auth Key, jedoch nicht das Auth Secret;
* die Assembly ID des fehlgeschlagenen Tests, falls eine Assembly erstellt wurde;
* die URL der Zap-Ausführung;
* das Zapier-Feld, das Sie **File(s)** zugeordnet haben.

Anhand dieser Angaben können wir feststellen, ob das Problem bei der Authentifizierung, der Workspace-Auswahl, der Template-Konfiguration, der asynchronen Ergebnisverarbeitung oder dem vorgelagerten Dateifeld liegt.

### Vorgefertigte Zaps

Wir bieten eine Liste sofort einsatzbereiter Zaps, mit denen Sie schnell beginnen können.

### Eigene Zaps erstellen

Diese älteren Anleitungen verwenden eine frühere Zapier-Oberfläche, veranschaulichen aber weiterhin die oben beschriebene Zwei-Zap-Architektur für Eingabe und Ergebnis.

1. Videos zur iPad-Optimierung von Dropbox an Transloadit senden:
2. Videos nach der iPad-Optimierung von Transloadit zurück an Dropbox senden:

Im Hintergrund fügt die Integration jeder Assembly ein Feld`zapier_action_type` hinzu. **Create Assembly** verwendet die Template ID als Wert, während die älteren voreingestellten Aktionen eine feste Aktionskennung verwenden. Abschluss-Trigger nutzen dieses Feld, um passende Assemblies zu finden. Eine Ausnahme ist der ungefilterte Trigger**Finished Assembly**. Dadurch werden Workflows wie „Wenn die iPad-Konvertierung fertig ist → Nachricht an Slack senden“ möglich.

### Fehlerbehebung

* Vermeiden Sie Zap-Schleifen: Um Zap-Schleifen zu vermeiden, dürfen Sie Aktionen für eineAssembly nicht in demselben Ordner auslösen, in dem die fertigen Dateien Ihrer Templates eingehen. Verwenden Sie bei Dropbox einen Ordner für die Eingabe und einen anderen für die Ausgabe. Weitere Informationen finden Sie auf dieser [Zapier-Hilfeseite](https://help.zapier.com/hc/en-us/articles/8496232045453-Zap-is-stuck-in-a-loop).
* Wenn Sie Probleme mit Dropbox und großen Dateien haben, lesen Sie:[Häufige Probleme mit Dropbox in Zapier](https://help.zapier.com/hc/en-us/articles/8495932691597-Common-Problems-With-Dropbox-on-Zapier).
* Die Verarbeitung durch Transloadit ist nicht blockierend. Verwenden Sie den Trigger**Assembly Result** in einem zweiten Zap, statt davon auszugehen, dass eine Ergebnisdatei im Step direkt nach **Create Assembly** bereitsteht.

### Dokumentation

Weitere Informationen finden Sie unter [Unterstützte Zapier-Trigger und -Aktionen von Transloadit](https://zapier.com/apps/transloadit/integrations)sowie in Zapiers [Dokumentation zu Dateifeldern](https://help.zapier.com/hc/en-us/articles/8496288813453-Send-files-in-Zap-workflows).