Integración con Zapier

La integración de Zapier de Shade te permite conectar tu espacio de trabajo con miles de herramientas y servicios externos. Puedes usar Shade como desencadenante —escuchando eventos como subidas o transcripciones completadas— o como destino de una acción, realizando operaciones en Shade en respuesta a eventos en otro lugar. Esto facilita crear flujos de trabajo automatizados sin escribir código.

Primeros pasos

Antes de conectar Shade a Zapier, necesitarás tres cosas de la configuración de tu espacio de trabajo:

• Clave de integración de Zapier — Se encuentra en Configuración → Para desarrolladores. Esta clave es exclusiva de tu espacio de trabajo.

• ID de la aplicación — También disponible en la sección Para desarrolladores. Este es el ID de tu espacio de trabajo.

• Clave de API — Generada por separado a través de Configuración → Claves de API.

Cuando conectes tu cuenta de Shade dentro de Zapier, se te pedirá que introduzcas las tres. Una vez conectado, tu espacio de trabajo de Shade estará disponible tanto como fuente de desencadenamiento como destino de acción en tus Zaps.

Configuración de webhooks

El panel de control de webhooks (Configuración → Para desarrolladores) es donde administras los eventos que Shade envía a servicios externos. Desde esta página, puedes configurar una URL de endpoint (como una URL de webhook de Zapier) para recibir eventos emitidos por tu espacio de trabajo.

Los eventos se emiten en momentos clave de tu flujo de trabajo, como cuando se sube un archivo o cuando finaliza una transcripción. Cada evento incluye metadatos relevantes sobre el recurso involucrado, que los servicios posteriores pueden usar para realizar acciones adicionales.

Desencadenantes y acciones

Dentro de Zapier, Shade admite tanto desencadenantes como acciones, dándote flexibilidad en cómo construyes tus flujos de trabajo.

Desencadenantes escuchan eventos en Shade e inician un Zap cuando sucede algo, como la subida de un nuevo archivo o la finalización de una transcripción.

Acciones permiten que otras apps impulsen la actividad dentro de Shade, como generar un enlace para compartir de un recurso específico.

Ejemplos de flujos de trabajo

• Generar un enlace para compartir al subir: Cuando se sube un archivo a Shade, genera y comparte automáticamente un enlace público, útil para distribuir recursos a partes interesadas externas sin pasos manuales.

• Enviar transcripciones a un servicio externo: Cuando se completa una transcripción, reenvía el contenido de la transcripción a otra herramienta, como un editor de documentos, un CRM o un servicio de notificaciones.

Encontrar recursos en flujos de trabajo de Zapier

Cuando un archivo se sube por primera vez a Shade, su ID de recurso no se conoce de inmediato para los sistemas externos. Para hacer referencia a un recurso específico en una acción posterior, usa la ruta, que se incluye en la carga útil del webhook de subida. La ruta identifica de forma única la ubicación del recurso dentro de tu unidad y puede usarse para buscar o actuar sobre el recurso en Shade desde tu Zap. También puedes usar el ID del recurso en una acción separada.

Cosas a tener en cuenta

• Tu clave de integración de Zapier es específica del espacio de trabajo. Si administras varios espacios de trabajo de Shade, cada uno tendrá su propia clave.

• Las claves de API se administran por separado de la clave de integración y pueden generarse o revocarse a través de Configuración → Claves de API.

• Los endpoints de webhook deben configurarse en el panel de control de webhooks antes de que Shade comience a enviar eventos a un servicio externo.

Para obtener más información sobre cómo configurar automatizaciones de Zapier, consulta la documentación de Zapier aquí: https://help.zapier.com/hc/en-us/articles/22234847450893-Zaps-quick-start-guide