> 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/guides/guides-es/automatizaciones/conecta-shade-a-otras-herramientas-con-webhooks.md).

# Conecta Shade a otras herramientas con webhooks

Inicia automatizaciones de Shade desde cualquier herramienta con un webhook, y envía datos desde Shade a cualquier API con una solicitud HTTP.

**Resultado:** conexiones bidireccionales entre Shade y el resto de tu pila. Tu herramienta de proyectos puede iniciar una automatización de Shade, y Shade puede enviar actualizaciones de vuelta, sin que tengas que escribir un servicio propio.

**Para quién es:** productores con mentalidad operativa y miembros del equipo técnico que conectan Shade a un rastreador de proyectos, un CMS, Slack o una herramienta interna. Si prefieres escribir código, consulta las [Desarrolladores](/guides/guides-es/desarrolladores.md) guías.

**Tiempo:** unos 20 minutos por conexión.

## Antes de empezar

* Crea [tu primera automatización](/guides/guides-es/automatizaciones/tu-primera-automatizacion.md) primero si no has usado el editor de automatizaciones.
* Ten abierta la documentación de la otra herramienta. Necesitarás sus ajustes de webhook saliente o el endpoint de API al que quieras llamar.

## Parte 1: inicia una automatización desde otra herramienta

Este ejemplo crea una carpeta de proyecto cada vez que se crea un nuevo proyecto en tu rastreador.

{% stepper %}
{% step %}

### Añade un disparador Webhook Received

Crea una automatización y elige **Webhook Received**. Shade muestra una URL de webhook para esta automatización. Deja **Requerir autenticación** activado. Shade genera un **token de autenticación**, y las solicitudes entrantes deben enviarlo como token bearer.
{% endstep %}

{% step %}

### Apunta la otra herramienta hacia él

En la configuración de webhook saliente o automatización de la otra herramienta, pega la URL y añade un encabezado `Authorization` con el valor `Bearer` seguido del token. Haz que envíe un cuerpo JSON, por ejemplo:

```json
{ "project_name": "ACME Spring Campaign" }
```

{% endstep %}

{% step %}

### Usa la carga útil en tus pasos

Añade **Crear carpeta**. En **Ruta**, escribe `Proyectos/`, luego escribe `{` y elige `project_name` de la carga útil del disparador **carga útil**. Elige una **plantilla de carpeta** para construir la estructura estándar dentro de la nueva carpeta.

Envía una solicitud de prueba desde la otra herramienta antes de terminar este paso. Los campos de la carga útil son más fáciles de seleccionar una vez que Shade ha visto una real.
{% endstep %}

{% step %}

### Guardar y activar

Haz clic en **Guardar**, luego **Activar**, y crea un proyecto de prueba en la otra herramienta.
{% endstep %}
{% endstepper %}

## Parte 2: envía datos desde Shade a otra herramienta

Este ejemplo publica un mensaje en un webhook entrante de Slack cada vez que se resuelve un comentario.

{% stepper %}
{% step %}

### Elige el evento de Shade

Crea una automatización y elige el evento que importa, aquí **Comentario resuelto**.
{% endstep %}

{% step %}

### Añade Enviar solicitud HTTP

* **Método:** POST
* **URL:** el endpoint de la otra herramienta, aquí la URL de webhook entrante de Slack
* **Encabezados:** lo que requiera la API, por ejemplo un `Authorization` encabezado con una clave API
* **Cuerpo:** JSON, con variables del disparador. Para Slack:

```json
{ "text": "Se resolvió un comentario en ASSET_NAME" }
```

Reemplaza `ASSET_NAME` con una variable: elimínalo, escribe `{`, y elige el nombre del activo desde el disparador. Inserta otros valores de pasos anteriores de la misma manera.
{% endstep %}

{% step %}

### Usa la respuesta si la necesitas

La respuesta de la solicitud está disponible para pasos posteriores. Por ejemplo, puedes guardar un ID que devuelva la otra herramienta en un campo de metadatos de Shade con **Actualizar metadatos del activo**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Una respuesta distinta de 2xx de la otra herramienta no detiene la automatización por sí sola. Si los pasos posteriores dependen de que la solicitud tenga éxito, añade un **Si / Si no** en la **salida de** estado.
{% endhint %}

## Variantes

* **Conector sin código:** si la otra herramienta está en Zapier, quizá no necesites webhooks en absoluto. Consulta [Integración con Zapier](https://academy.shade.inc/workspaces-and-drives/zapier-integration).
* **Suscripciones a eventos para desarrolladores:** para recibir eventos de Shade en tu propio servicio, consulta [Webhooks](https://academy.shade.inc/developers/webhooks).

## Guías relacionadas

* [Crea una carpeta para cada proyecto nuevo](/guides/guides-es/objetos-personalizados-y-metadatos/crea-una-carpeta-para-cada-proyecto-nuevo.md)
* [Usa Shade MCP con Claude o Cursor](/guides/guides-es/busqueda-ia-y-archivos/usa-shade-mcp-con-claude-o-cursor.md)
* [Desarrolladores](/guides/guides-es/desarrolladores.md)


---

# 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/guides/guides-es/automatizaciones/conecta-shade-a-otras-herramientas-con-webhooks.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.