Integración con Zapier

Zapier te permite enviar archivos desde Dropbox, Gmail, Slack, Google Drive y miles de otras aplicaciones a Transloadit sin escribir código. Luego, Transloadit ejecuta un Template guardado para cada acción de Zapier, como convertir un video, extraer texto de un archivo, optimizar una imagen o almacenar un archivo terminado en tu bucket en la nube.

Para los flujos de trabajo nuevos, usa la acción Create Assembly de Zapier. Funciona con cualquier Template guardado de Transloadit. Las acciones preconfiguradas de la integración, como Optimize Video, siguen disponibles para los Zaps antiguos, pero los Templates te dan control sobre todo el flujo de procesamiento de archivos.

El modelo mental que debes tener presente es el siguiente:

1. Crea y prueba primero el flujo de procesamiento de archivos en Transloadit.
2. Guarda ese flujo como un Template.
3. Conecta Zapier con el Workspace de Transloadit al que pertenece el Template.
4. En Zapier, elige el Template y asigna los archivos o campos del paso anterior del Zap.

Para consultar un ejemplo completo de un flujo de trabajo, revisa nuestro tutorial sobre cómo insertar logotipos automáticamente en los videos a medida que se agregan a Google Drive EN (English).

La ruta más rápida para crear un Zap correctamente

Usa esta lista de verificación para validar la conexión antes de crear tu flujo de trabajo de producción:

1. Crea un Template llamado zapier-smoke-test con el JSON que aparece a continuación.
2. Crea un Auth Key en el mismo Workspace con los permisos templates:read, assemblies:read y assemblies:write. El acceso completo también funciona, pero concede más acceso del que necesita esta integración.
3. En Zapier, crea y prueba el activador de tu aplicación de origen con un archivo nuevo y pequeño.
4. Agrega la acción Create Assembly de Transloadit y conecta el Auth Key y el Auth Secret correspondiente.
5. Selecciona zapier-smoke-test en Template ID y asigna el archivo de origen a File(s).
6. Prueba la acción y verifica que la Assembly aparezca en tu página de Assemblies y alcance el estado ASSEMBLY_COMPLETED.

Cuando esto funcione, selecciona tu Template de producción. Si un paso posterior del Zap necesita el archivo procesado, sigue las indicaciones de Usa un resultado terminado en otra aplicación antes de activar el flujo de trabajo.

Crea un Template para la prueba rápida

Crea un Template llamado zapier-smoke-test con estas Instructions:

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

Este Template acepta una subida y lee sus metadatos sin almacenarla ni transformarla. Es una forma rápida y económica de aislar la autenticación de Zapier y la asignación de archivos de la complejidad de tu flujo de trabajo real.

Antes de abrir Zapier

Prepara estos valores antes de abrir Zapier:

• Un Workspace de Transloadit con un Auth Key y un Auth Secret activos. Puedes encontrarlos en la página de credenciales. Una clave con alcance limitado necesita templates:read para que Zapier pueda completar el menú desplegable de Templates, assemblies:read para que pueda probar la conexión y consultar los activadores de finalización, y assemblies:write para que pueda crear Assemblies.
• Un Template guardado en el mismo Workspace. Zapier ejecuta el Template; no sustituye al Template Editor.
• Un archivo de prueba de la aplicación que inicia el Zap, como un archivo de Dropbox, un archivo de Google Drive, un archivo adjunto de email o una URL de subida de un formulario. Usa datos nuevos para probar el activador y mantén el primer archivo muy por debajo de 100 MB para que Zapier pueda recuperarlo de forma confiable.

Si usas Workspaces de Transloadit separados para staging y producción, asigna a la conexión de Zapier el nombre del entorno. Por ejemplo, usa Transloadit staging para un Auth Key de staging y Transloadit production para un Auth Key de producción. Esto reduce considerablemente la posibilidad de probar un Zap con un Workspace y luego preguntarte por qué falta el Template de producción.

Conecta Zapier con Transloadit

En Zapier, agrega una acción de Transloadit⁠ y elige Create Assembly. Cuando Zapier te pida conectar una cuenta de Transloadit, haz clic en Sign in to Transloadit.

Luego, Zapier abre una pequeña ventana de autenticación. Según la versión de la aplicación de Transloadit que muestre Zapier, los campos usan etiquetas específicas o etiquetas genéricas anteriores:

• Transloadit Auth Key o Key es tu Auth Key de Transloadit.
• Transloadit Auth Secret o Secret es el Auth Secret correspondiente de Transloadit.

Transloadit no solicita a Zapier la contraseña de tu cuenta de Transloadit. El Auth Secret tampoco es el slug de tu Workspace, el Template ID ni tu contraseña de Zapier.

Zapier almacena esta conexión en tu cuenta de Zapier. Los Zaps futuros pueden reutilizarla, por lo que debes asignarle a la conexión un nombre que identifique claramente el Workspace, por ejemplo, Transloadit production o Transloadit staging.

Si rotas, desactivas o eliminas el Auth Key en Transloadit, vuelve a conectar la cuenta de Zapier con un nuevo par de claves. Los Zaps existentes que usan la conexión anterior ya no podrán crear Assemblies.

Configura la acción Create Assembly

Después de la autenticación, Zapier pregunta cómo debe crearse la Assembly de Transloadit.

Como mínimo, configura lo siguiente:

• Template ID: elige el Template guardado de Transloadit que debe procesar el archivo.
• File(s): en los Templates basados en subidas, asigna el objeto de archivo o la URL de descarga directa del paso anterior del Zap. Deja este campo vacío solo cuando el Template obtiene su propia entrada, por ejemplo, mediante un Import Robot o un Robot de generación con IA.
• Assembly Fields: de manera opcional, pasa valores como identificadores de clientes, identificadores de pedidos o nombres de archivos a la Assembly para que aparezcan en el Assembly Status JSON.

Las aplicaciones de Zapier suelen mostrar varios campos de aspecto similar, como una URL de vista previa, una URL de visualización web, un objeto de archivo y una URL de descarga directa. Para Transloadit, elige el campo que apunta a los bytes reales del archivo. Una página de vista previa en el navegador no es suficiente. Da preferencia al objeto de archivo de la aplicación de origen; Zapier puede mostrar su valor de prueba como (Exists but not shown). Si usas una URL, debe ser accesible públicamente y apuntar directamente al archivo, no a una página de vista previa. Consulta la guía de Zapier para enviar archivos en flujos de trabajo de Zap⁠.

File(s) es un campo de lista. Asigna cada archivo adjunto a un elemento independiente de la lista cuando una sola Assembly necesite varias subidas. No pegues varias URL separadas por comas en un mismo elemento de la lista, porque Zapier podría enviar silenciosamente solo la primera. Una acción Create Assembly siempre crea una sola Assembly; usa un bucle de Zapier antes de la acción si cada archivo de origen debe crear una Assembly independiente.

Ejecuta una vez el paso de prueba de Zapier. Luego, abre la página de Assemblies de Transloadit en el mismo Workspace y confirma que haya aparecido una Assembly nueva. Es posible que aún se esté ejecutando cuando la acción de Zapier responda; espera hasta que alcance ASSEMBLY_COMPLETED. Si lo hace, la autenticación, la selección del Template y la asignación de archivos funcionan correctamente.

La acción devuelve el Assembly ID, el Assembly Status actual y la Assembly Status URL. Guarda el Assembly ID en el registro de origen cuando necesites una referencia permanente para auditorías o soporte. Estos resultados identifican la Assembly, pero no contienen un archivo procesado mientras el trabajo asíncrono siga en ejecución.

La Assembly de prueba es la fuente confiable. Si la prueba de Zapier se completa correctamente, pero no ves una Assembly nueva, es probable que el Zap esté conectado a un Workspace diferente del que estás revisando.

Usa un resultado terminado en otra aplicación

Create Assembly inicia el trabajo de forma asíncrona. No asignes una URL de resultado de esa acción directamente al siguiente paso del Zap. Una prueba que solo procesa metadatos puede terminar lo suficientemente rápido como para que esto parezca confiable, mientras que los flujos con videos, archivos e imágenes más grandes terminan después.

Usa dos Zaps cuando otra aplicación necesite el archivo procesado:

1. Zap de entrada: activador de la aplicación de origen → Create Assembly de Transloadit.
2. Zap de resultados: activador Assembly Result de Transloadit → acción de tu aplicación de destino.

En el activador Assembly Result, selecciona el mismo Template ID e introduce el nombre exacto del Step de resultado del Template. Para el Template de prueba rápida anterior, el Step es metadata. Asigna el valor File del activador al campo de archivo de la aplicación de destino o usa SSL URL cuando esa aplicación acepte una URL pública.

Usa en su lugar el activador Finished Assembly de Transloadit si el segundo Zap solo necesita metadatos de finalización y no un archivo de resultado específico. Estos activadores funcionan mediante consultas periódicas, por lo que el retraso antes de que se inicie el Zap de resultados depende de tu plan de Zapier y es independiente del tiempo de procesamiento de Transloadit.

Problemas comunes de autenticación

Zapier indica que las credenciales no son válidas

Comprueba que hayas copiado el Auth Key en el campo Transloadit Auth Key o Key de Zapier y el Auth Secret correspondiente en Transloadit Auth Secret o Secret. El Auth Secret no es la contraseña de tu cuenta ni el slug del Workspace. Confirma también que la clave esté activa y tenga acceso assemblies:read, que Zapier usa para probar la conexión.

Zapier se conecta, pero el Template no aparece o falla

El motivo más común es que los Workspaces no coinciden. Zapier se autentica en el Workspace al que pertenece el Auth Key. Asegúrate de que el Template que quieres ejecutar pertenezca al mismo Workspace.

Si el menú desplegable de Templates está vacío, vuelve a conectar Transloadit en Zapier con un Auth Key del Workspace al que pertenece tu Template y confirma que la clave tenga acceso templates:read. Si el Template aparece, pero Zapier no puede crear una Assembly, confirma que tenga acceso assemblies:write. Si se crea una Assembly, pero falla, ábrela en Transloadit e inspecciona el primer Step con errores. En ese punto, la autenticación funcionó y el problema suele deberse a la configuración del Template o a un campo de archivo de entrada que no se puede usar.

El Zap funcionaba antes, pero ahora falla

Comprueba si el Auth Key se rotó, desactivó o eliminó, o si se modificaron sus alcances. Vuelve a conectar Transloadit en Zapier después de realizar cambios en las credenciales.

El Zap crea una Assembly, pero los pasos posteriores no ven el archivo de resultado

Usa la configuración con dos Zaps descrita en Usa un resultado terminado en otra aplicación. En el Zap de resultados, comprueba que Step coincida exactamente con el nombre de un Step de resultado del Template; no es el nombre de un Robot ni un nombre de archivo.

Dropbox o Google Drive no proporcionan una URL de archivo utilizable

Algunos activadores de aplicaciones muestran los metadatos antes de que el archivo esté disponible o proporcionan una URL que Zapier no puede enviar como archivo descargable. Usa el panel de resultados de prueba de Zapier para confirmar que el campo seleccionado apunte al archivo binario y no solo a una página de vista previa.

Si el archivo está protegido por permisos privados de la aplicación, usa el objeto de archivo que Zapier recibió del paso del activador, no una URL del navegador copiada desde Dropbox o Google Drive. Vuelve a probar el activador si su muestra no presenta ningún archivo o muestra una referencia vencida. Zapier advierte que los archivos de más de 100 MB pueden agotar el tiempo de espera y que debe recuperar un archivo en un plazo de 30 segundos, por lo que debes usar un archivo más pequeño durante la configuración, aunque Transloadit admita subidas más grandes.

Qué debes recopilar antes de contactar con soporte

Si el problema persiste, envíanos lo siguiente:

• la aplicación y el activador de Zapier que estás usando, por ejemplo, New File in Folder de Dropbox;
• el nombre del Workspace de Transloadit;
• el nombre del Template o el Template ID;
• el identificador público del Auth Key, pero no el Auth Secret;
• el Assembly ID de la prueba fallida, si se creó una Assembly;
• la URL de la ejecución del Zap;
• el campo de Zapier que asignaste a File(s).

Con esos datos, podremos determinar si el problema está en la autenticación, la selección del Workspace, la configuración del Template, el manejo asíncrono de los resultados o el campo del archivo de origen.

Zaps listos para usar

Tenemos una lista de Zaps listos para usar con los que puedes comenzar rápidamente.

Crea tus propios Zaps

Estos tutoriales anteriores usan una interfaz previa de Zapier, pero siguen mostrando la misma arquitectura de dos Zaps para entrada y resultados descrita anteriormente.

1. Envío de videos desde Dropbox a Transloadit para optimizarlos para iPad:

2. Envío de videos de vuelta desde Transloadit a Dropbox después de optimizarlos para iPad:

En segundo plano, la integración agrega un campo zapier_action_type a cada Assembly. Create Assembly usa el Template ID como su valor, mientras que las acciones preconfiguradas anteriores usan un identificador fijo de acción. Los activadores de finalización usan este campo para encontrar Assemblies coincidentes, excepto el activador Finished Assembly sin filtros. Esto permite crear flujos de trabajo como «cuando la conversión para iPad esté lista → enviar un mensaje a Slack».

Solución de problemas

• Evita los bucles de Zap: para evitar los bucles de Zap, asegúrate de no activar acciones de Assembly en la misma carpeta donde se reciben los archivos completados de tus Templates. En el caso de Dropbox, usa una carpeta para la entrada y otra diferente para la salida. Para obtener más información, consulta esta página de ayuda de Zapier⁠.
• Si tienes problemas con Dropbox y archivos grandes, consulta: Problemas comunes con Dropbox en Zapier⁠.
• El procesamiento de Transloadit no es bloqueante. Usa el activador Assembly Result en un segundo Zap en lugar de asumir que un archivo de resultado está listo en el paso inmediatamente posterior a Create Assembly.

Documentación

Consulta los activadores y las acciones de Zapier compatibles con Transloadit⁠ y la documentación de Zapier sobre campos de archivo⁠.