Intégration Zapier

Zapier vous permet d’envoyer des fichiers depuis Dropbox, Gmail, Slack, Google Drive et des milliers d’autres applications vers Transloadit sans écrire de code. Transloadit exécute ensuite un Template enregistré pour chaque action Zapier, par exemple pour convertir une vidéo, extraire le texte d’un document, optimiser une image ou stocker un fichier terminé dans votre bucket cloud.

Pour les nouveaux flux de travail, utilisez l’action Create Assembly de Zapier. Elle fonctionne avec n’importe quel Template Transloadit enregistré. Les actions prédéfinies de l’intégration, comme Optimize Video, restent disponibles pour les anciens Zaps, mais les Templates vous permettent de contrôler l’ensemble du flux de travail de traitement des fichiers.

Le principe à retenir est le suivant :

Créez et testez d’abord le flux de travail de traitement des fichiers dans Transloadit.
Enregistrez ce flux de travail en tant que Template.
Connectez Zapier au Workspace Transloadit qui possède le Template.
Dans Zapier, choisissez le Template et mappez les fichiers ou les champs de l’étape précédente du Zap.

Pour un exemple complet de flux de travail, consultez notre tutoriel expliquant comment incruster automatiquement des logos dans les vidéos dès leur ajout à Google Drive (English).

Le chemin le plus rapide vers un Zap fonctionnel

Utilisez cette liste de contrôle pour valider la connexion avant de construire votre flux de travail de production :

Créez un Template nommé zapier-smoke-test à l’aide du JSON ci-dessous.
Créez une Auth Key dans le même Workspace avec les autorisations templates:read, assemblies:read et assemblies:write. Un accès complet fonctionne aussi, mais accorde plus d’accès que nécessaire pour cette intégration.
Dans Zapier, créez et testez le déclencheur de votre application source avec un petit fichier récent.
Ajoutez l’action Create Assembly de Transloadit et connectez l’Auth Key et l’Auth Secret correspondant.
Sélectionnez zapier-smoke-test sous Template ID et mappez le fichier source dans File(s).
Testez l’action, puis vérifiez que l’Assembly apparaît sur votre page des Assemblies et atteint ASSEMBLY_COMPLETED.

Une fois que cela fonctionne, sélectionnez votre Template de production. Si une étape ultérieure du Zap a besoin du fichier traité, suivez Utiliser un résultat terminé dans une autre application avant d’activer le flux de travail.

Créer un Template de test de fumée

Créez un Template nommé zapier-smoke-test avec ces Instructions :

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

Ce Template accepte un seul fichier envoyé et lit ses métadonnées sans le stocker ni le transformer. C’est un moyen économique et rapide d’isoler l’authentification Zapier et le mappage des fichiers de la complexité de votre véritable flux de travail.

Avant d’ouvrir Zapier

Préparez ces valeurs avant d’ouvrir Zapier :

Un Workspace Transloadit avec une Auth Key active et un Auth Secret. Vous les trouverez sur la page des identifiants. Une clé aux droits restreints a besoin de templates:read pour que Zapier puisse remplir la liste déroulante des Templates, de assemblies:read pour tester la connexion et faire fonctionner par interrogation les déclencheurs de fin de traitement, et de assemblies:write pour créer des Assemblies.
Un Template enregistré dans le même Workspace. Zapier exécute le Template ; il ne remplace pas le Template Editor.
Un fichier de test provenant de l’application qui démarre le Zap, par exemple un fichier Dropbox, un fichier Google Drive, une pièce jointe d’e-mail ou l’URL d’un envoi par formulaire. Utilisez des données de test récentes pour le déclencheur et gardez le premier fichier bien en dessous de 100 MB pour que Zapier puisse le récupérer de manière fiable.

Important

Utilisez des identifiants du Workspace qui possède le Template. Si vous connectez Zapier avec une Auth Key d’un autre Workspace, Zapier peut s’authentifier avec succès, mais ne verra pas le Template attendu et ne pourra pas l’exécuter.

Si vous utilisez des Workspaces Transloadit distincts pour la préproduction et la production, nommez la connexion Zapier d’après l’environnement. Par exemple, utilisez Transloadit staging pour une Auth Key de préproduction et Transloadit production pour une Auth Key de production. Il devient ainsi beaucoup plus difficile de tester un Zap sur un Workspace puis de se demander plus tard pourquoi le Template de production est introuvable.

Connecter Zapier à Transloadit

Dans Zapier, ajoutez une action Transloadit et choisissez Create Assembly. Lorsque Zapier vous demande de connecter un compte Transloadit, cliquez sur Sign in to Transloadit.

Note

Zapier met régulièrement à jour son éditeur ; sa disposition peut donc différer de ces captures d’écran. Les libellés des actions et des champs de ce guide correspondent à l’intégration Transloadit actuelle.

Zapier ouvre ensuite une petite fenêtre d’authentification. Selon la version de l’application Transloadit affichée par Zapier, les champs utilisent soit les libellés spécifiques, soit les anciens libellés génériques :

Transloadit Auth Key ou Key désigne votre Auth Key Transloadit.
Transloadit Auth Secret ou Secret désigne l’Auth Secret Transloadit associé.

Transloadit ne demande pas à Zapier le mot de passe de votre compte Transloadit. L’Auth Secret n’est pas non plus le slug de votre Workspace, l’ID du Template ni votre mot de passe Zapier.

Zapier enregistre cette connexion dans votre compte Zapier. Les futurs Zaps peuvent la réutiliser ; donnez donc à la connexion un nom qui identifie clairement le Workspace, par exemple Transloadit production ou Transloadit staging.

Si vous renouvelez, désactivez ou supprimez l’Auth Key dans Transloadit, reconnectez le compte Zapier avec une nouvelle paire de clés. Les Zaps existants qui utilisent l’ancienne connexion ne peuvent plus créer d’Assemblies.

Configurer l’action Create Assembly

Après l’authentification, Zapier vous demande comment l’Assembly Transloadit doit être créée.

Configurez au minimum :

Template ID : choisissez le Template Transloadit enregistré qui doit traiter le fichier.
File(s) : pour les Templates basés sur l’envoi de fichiers, mappez l’objet fichier ou l’URL de téléchargement direct de l’étape précédente du Zap. Ne laissez ce champ vide que lorsque le Template obtient lui-même ses entrées, par exemple avec un Robot d’import ou un Robot de génération par IA.
Assembly Fields : transmettez facultativement à l’Assembly des valeurs telles que des ID client, des ID de commande ou des noms de fichiers, afin qu’elles apparaissent dans le Assembly Status JSON.

Les applications Zapier exposent souvent plusieurs champs d’apparence similaire, comme une URL d’aperçu, une URL d’affichage web, un objet fichier et une URL de téléchargement direct. Pour Transloadit, choisissez le champ qui pointe vers les octets réels du fichier. Une page d’aperçu dans le navigateur ne suffit pas. Privilégiez l’objet fichier de l’application source ; Zapier peut afficher sa valeur de test sous la forme (Exists but not shown). Si vous utilisez une URL, elle doit être accessible publiquement et pointer directement vers le fichier plutôt que vers une page d’aperçu. Consultez le guide de Zapier consacré à l’envoi de fichiers dans les flux de travail Zap.

File(s) est un champ de liste. Mappez chaque pièce jointe dans un élément de liste distinct lorsqu’une même Assembly nécessite plusieurs fichiers envoyés. Ne collez pas plusieurs URL séparées par des virgules dans un seul élément de liste, car Zapier peut n’envoyer que la première sans le signaler. Une action Create Assembly crée toujours une seule Assembly ; utilisez une boucle Zapier avant l’action si chaque fichier source doit créer une Assembly distincte.

Exécutez une fois l’étape de test de Zapier. Ouvrez ensuite la page des Assemblies de Transloadit dans le même Workspace et vérifiez qu’une nouvelle Assembly est apparue. Elle peut encore être en cours d’exécution lorsque l’action Zapier renvoie son résultat ; attendez qu’elle atteigne ASSEMBLY_COMPLETED. Si c’est le cas, l’authentification, la sélection du Template et le mappage des fichiers fonctionnent.

L’action renvoie les valeurs Assembly ID, Assembly Status (état actuel) et Assembly Status URL. Conservez l’ID de l’Assembly dans l’enregistrement d’origine lorsque vous avez besoin d’une référence durable pour l’audit ou le support. Ces sorties identifient l’Assembly, mais ne contiennent pas de fichier traité tant que le traitement asynchrone est encore en cours.

L’Assembly de test fait foi. Si le test de Zapier réussit mais que vous ne voyez pas de nouvelle Assembly, le Zap est probablement connecté à un autre Workspace que celui que vous consultez.

Utiliser un résultat terminé dans une autre application

Create Assembly lance le traitement de manière asynchrone. Ne mappez pas une URL de résultat issue de cette action directement dans l’étape suivante du Zap. Un test limité aux métadonnées peut se terminer assez vite pour que cette approche semble fiable, alors que les flux de travail portant sur des vidéos, des documents ou des images plus volumineuses se terminent plus tard.

Utilisez deux Zaps lorsqu’une autre application a besoin du fichier traité :

Zap d’entrée : déclencheur de l’application source → Transloadit Create Assembly.
Zap de résultat : déclencheur Transloadit Assembly Result → action de votre application de destination.

Dans le déclencheur Assembly Result, sélectionnez le même Template ID et saisissez le nom exact du Step de résultat défini dans le Template. Pour le Template de test de fumée ci-dessus, le Step est metadata. Mappez la valeur File du déclencheur dans le champ de fichier de l’application de destination, ou utilisez SSL URL lorsque cette application accepte une URL publique.

Utilisez plutôt le déclencheur Finished Assembly de Transloadit si le second Zap n’a besoin que des métadonnées de fin de traitement plutôt que d’un fichier de résultat particulier. Il s’agit de déclencheurs par interrogation (polling) : le délai avant le démarrage du Zap de résultat dépend donc de votre forfait Zapier et est indépendant du temps de traitement de Transloadit.

Problèmes d’authentification courants

Zapier indique que les identifiants ne sont pas valides

Vérifiez que vous avez copié l’Auth Key dans le champ Transloadit Auth Key ou Key de Zapier, et l’Auth Secret correspondant dans Transloadit Auth Secret ou Secret. L’Auth Secret n’est ni le mot de passe de votre compte ni le slug du Workspace. Vérifiez également que la clé est active et dispose de l’accès assemblies:read, que Zapier utilise pour tester la connexion.

Zapier se connecte, mais le Template est introuvable ou échoue

La cause la plus fréquente est une incohérence de Workspace. Zapier s’authentifie auprès du Workspace qui possède l’Auth Key. Assurez-vous que le Template à exécuter appartient à ce même Workspace.

Si la liste déroulante des Templates est vide, reconnectez Transloadit dans Zapier avec une Auth Key du Workspace qui possède votre Template et vérifiez que la clé dispose de l’accès templates:read. Si le Template apparaît mais que Zapier ne parvient pas à créer d’Assembly, vérifiez l’accès assemblies:write. Si une Assembly est créée mais échoue, ouvrez-la dans Transloadit et examinez le premier Step en erreur. À ce stade, l’authentification a fonctionné, et le problème vient généralement de la configuration du Template ou d’un champ de fichier d’entrée inutilisable.

Le Zap fonctionnait auparavant, mais échoue désormais

Vérifiez si l’Auth Key a été renouvelée, désactivée ou supprimée, ou si ses portées ont été modifiées. Reconnectez Transloadit dans Zapier après toute modification des identifiants.

Le Zap crée une Assembly, mais les étapes suivantes du Zap ne voient pas le fichier de résultat

Utilisez la configuration à deux Zaps décrite dans Utiliser un résultat terminé dans une autre application. Dans le Zap de résultat, vérifiez que Step correspond exactement au nom d’un Step de résultat du Template ; il ne s’agit ni d’un nom de Robot ni d’un nom de fichier.

Dropbox ou Google Drive ne fournit pas d’URL de fichier exploitable

Certains déclencheurs d’application exposent des métadonnées avant que le fichier soit disponible, ou fournissent une URL que Zapier ne peut pas envoyer comme fichier téléchargeable. Utilisez le panneau des résultats de test de Zapier pour vérifier que le champ sélectionné pointe vers le fichier binaire, et pas seulement vers une page d’aperçu.

Si le fichier est protégé par des autorisations privées de l’application, utilisez l’objet fichier que Zapier a reçu de l’étape de déclenchement, et non une URL copiée depuis le navigateur dans Dropbox ou Google Drive. Testez de nouveau le déclencheur si son échantillon n’affiche aucun fichier ou une référence expirée. Zapier signale que les fichiers de plus de 100 MB peuvent dépasser le délai d’attente et qu’il doit récupérer un fichier dans un délai de 30 secondes ; utilisez donc un fichier plus petit pour la configuration, même si Transloadit prend lui-même en charge des envois plus volumineux.

Informations à rassembler avant de contacter le support

Si vous rencontrez toujours des difficultés, envoyez-nous :

l’application et le déclencheur Zapier que vous utilisez, par exemple Dropbox New File in Folder ;
le nom du Workspace Transloadit ;
le nom ou l’ID du Template ;
l’ID public de l’Auth Key, mais pas l’Auth Secret ;
l’ID de l’Assembly issue du test ayant échoué, si une Assembly a été créée ;
l’URL de l’exécution du Zap ;
le champ Zapier que vous avez mappé dans File(s).

Avec ces informations, nous pourrons déterminer si le problème concerne l’authentification, la sélection du Workspace, la configuration du Template, la gestion des résultats asynchrones ou le champ de fichier en amont.

Zaps prêts à l’emploi

Parcourez les flux de travail prêts à l’emploi dans le répertoire des intégrations Transloadit sur Zapier. Choisissez-y un flux de travail, puis suivez les étapes de configuration ci-dessus pour connecter votre compte.

Créer vos propres Zaps

Ces anciennes démonstrations utilisent une interface Zapier précédente, mais illustrent toujours la même architecture à deux Zaps (entrée/résultat) décrite ci-dessus.

Envoi de vidéos depuis Dropbox vers Transloadit pour l’optimisation iPad :
Renvoi des vidéos de Transloadit vers Dropbox après l’optimisation iPad :

En coulisses, l’intégration ajoute un champ zapier_action_type à chaque Assembly. Create Assembly utilise l’ID du Template comme valeur, tandis que les anciennes actions prédéfinies utilisent un identifiant d’action fixe. Les déclencheurs de fin de traitement utilisent ce champ pour trouver les Assemblies correspondantes, sauf le déclencheur non filtré Finished Assembly. Cela rend possibles des flux de travail tels que « lorsque la conversion iPad est prête → envoyer un message sur Slack ».

Dépannage

Éviter les boucles de Zaps : pour éviter les boucles de Zaps, veillez à ne pas déclencher d’actions d’Assembly dans le dossier où vous recevez les fichiers terminés de vos Templates. Dans le cas de Dropbox, utilisez un dossier pour l’entrée et un autre pour la sortie. Pour en savoir plus, consultez cette page d’aide de Zapier.
En cas de problèmes avec Dropbox et des fichiers volumineux, consultez : Problèmes courants avec Dropbox sur Zapier.
Le traitement de Transloadit est non bloquant. Utilisez le déclencheur Assembly Result dans un second Zap au lieu de supposer qu’un fichier de résultat est prêt à l’étape qui suit immédiatement Create Assembly.

Documentation

Consultez les déclencheurs et actions Zapier pris en charge par Transloadit et la documentation de Zapier sur les champs de fichier.