> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-es/automatizaciones-y-objetos-personalizados/automations.md).

# Automatizaciones

Automations es un creador de flujos de trabajo sin código integrado directamente en Shade. Definís reglas sobre lo que debe suceder cuando ocurre algo en tu unidad, y Shade las ejecuta automáticamente en segundo plano: sin herramientas de terceros y sin necesidad de código.

Cada automatización está compuesta por un **disparador** (el evento que la inicia) y una o más **acciones** (lo que hace Shade en respuesta). Creas automatizaciones usando un editor visual basado en bloques.

{% embed url="<https://youtu.be/PIK9cQBpcSE?si=f7nBru4WD7SK9zjY>" %}

### Cómo funcionan las automatizaciones

* Elige un **disparador** - el evento que inicia la automatización
* Añade una o más **acciones** - encadenadas para ejecutarse en orden
* Guárdalo, y la automatización se ejecuta automáticamente cada vez que se active el disparador

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F1Cs5qy7BCtq7vD9CF9ws%2FAutomations%200.gif?alt=media&#x26;token=2405d772-6b17-475a-bf76-1d790e788786" alt=""><figcaption></figcaption></figure>

### Disparadores

Los disparadores son eventos en tu unidad. En el editor se agrupan así:

* **Manual:** Disparador manual
* **Archivos:** Activo subido, activo descargado, activo actualizado (cuando cambian los metadatos, opcionalmente un campo y un valor específicos), activo renombrado, activo eliminado, activo borrado
* **Colecciones:** Activo añadido a la colección, activo eliminado de la colección, colección creada, colección actualizada, colección eliminada
* **Objetos personalizados:** Registro creado, registro actualizado
* **Enlaces para compartir:** Enlace para compartir creado, enlace para compartir eliminado
* **Comentarios:** Comentario añadido, comentario actualizado, comentario eliminado, comentario resuelto, reacción al comentario
* **Personas:** Persona reconocida
* **Proxies, vistas previas y transcripción:** Transcripción completada, proxy de video completado, proxy de audio completado, metadatos extraídos
* **Red:** Webhook recibido

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FgJ0O6bl6f3RcYwf7OiQT%2FAutomations%201.gif?alt=media&#x26;token=c75a9235-0f85-4406-8a86-46711e69e581" alt=""><figcaption></figcaption></figure>

### Acciones

Las acciones son, en general, las cosas que ya puedes hacer en Shade manualmente. Incluyen:

* **Lógica:** Filtrar, Si / Si no, Selector
* **Archivos:** Crear carpeta, renombrar activo, mover activo, actualizar metadatos del activo
* **Enlaces para compartir:** Generar enlace para compartir, generar enlace para compartir de carpeta, generar enlace para compartir de colección
* **Colecciones:** Añadir a la colección, quitar de la colección, renombrar colección, crear colección, eliminar colección
* **Objetos personalizados:** Crear registro, buscar registro, actualizar registro, eliminar registro, obtener registro
* **Texto:** Transformar texto
* **Cálculos:** Número aleatorio, ajustar tiempo
* **Red:** Enviar solicitud HTTP
* **Otros:** Enviar correo electrónico, guardar archivos en la unidad

**Enviar correo electrónico** envía un mensaje a un destinatario con el asunto y el cuerpo que escribas. El cuerpo admite formato HTML básico.

**Webhook recibido** inicia una automatización cuando otro servicio envía una solicitud a su URL de webhook, y **Enviar solicitud HTTP** llama a una URL externa desde cualquier paso. Para la configuración, la autenticación y los detalles de la solicitud, consulta [Webhooks en automatizaciones](https://academy.shade.inc/developers/webhooks#webhooks-in-automations).

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F95JU1hzganNGVCaP7Pgc%2FAutomations%202.gif?alt=media&#x26;token=bea74699-1295-47a0-bb5f-75eb3a05b6e7" alt=""><figcaption></figcaption></figure>

### Creación de una automatización

Crea una automatización con el editor visual basado en bloques:

* Crea una nueva automatización
* Selecciona tu disparador (por ejemplo, **Activo añadido a la colección**) y asígnalo a la colección correspondiente
* Añade tus acciones en el orden en que deben ejecutarse (por ejemplo, **Generar enlace para compartir** -> **Enviar correo electrónico**)
* Guardar

### Ejemplos de flujos de trabajo

* **Aprobaciones en dos etapas:** Cuando el activo **Estado de aprobación** cambia a **En revisión**, genera automáticamente un enlace para compartir y envía un correo electrónico al revisor interno. Cuando cambie a **Aprobado**, envía el enlace para compartir final al revisor externo: dos etapas, cero traspaso manual.
* **Generador de paquetes de entrega:** Cuando los activos pasan a **Listo para entregar** (o se añaden a una colección de entrega), genera automáticamente el/los enlace(s) correctos para compartir y envía un correo electrónico de entrega que contiene los enlaces, los activos incluidos y cualquier nota. Esto convierte “exportar + enviar enlaces” en un solo cambio de estado.
* **Enrutamiento de entrada:** Cuando se sube un archivo a una carpeta de entrada, usa un **Si / Si no** bloque para comprobar sus metadatos, luego muévelo a la carpeta de proyecto correcta, actualiza sus metadatos y añádelo a una colección de revisión, de modo que el nuevo material llegue donde corresponde sin clasificación manual.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-es/automatizaciones-y-objetos-personalizados/automations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
