> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/acciones/playbooks/triggers.md).

# Disparadores de Playbook

Inicia Playbooks automáticamente con desencadenadores de programación, webhook, monitor e insight de AEO

Los disparadores de Playbook inician automáticamente los Playbooks publicados. Úsalos cuando un Playbook deba ejecutarse según una programación, responder a una solicitud HTTP, supervisar una condición o reaccionar a una señal de AirOps habilitada.

## Descripción general

Los disparadores ejecutan una versión seleccionada del Playbook y pasan los valores de Input configurados a la ejecución. Las ejecuciones activadas aparecen en **Historial de ejecuciones**. Las ejecuciones que necesitan revisión humana también aparecen en la bandeja de entrada.

| Activador              | Cómo funciona                                                                                                                                            | Mejor para                                                                                            |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Programación**       | Se ejecuta con una cadencia recurrente, como cada lunes a las 9:00.                                                                                      | Auditorías de contenido semanales, comprobaciones de frescura del Kit de marca, informes recurrentes. |
| **Webhook**            | Se inicia cuando un sistema externo envía una solicitud HTTP a la URL del webhook del Playbook.                                                          | Eventos de publicación en CMS, envíos de formularios, integraciones de terceros.                      |
| **Monitor**            | Usa Parallel Web Systems para comprobar una consulta de monitoreo cada 12 horas e inicia el Playbook cuando se detecta la condición.                     | Alertas competitivas, monitoreo del mercado, monitoreo de la salud del contenido.                     |
| **Información de AEO** | Se inicia cuando se cumplen los umbrales habilitados de Información de AEO, como cuando cambia la tasa de menciones, la cuota de voz o la tasa de citas. | Actualización programática, respuesta competitiva, brechas de cobertura de AEO.                       |

{% hint style="info" %}
Los disparadores de AEO Insight solo están disponibles cuando están habilitados para tu espacio de trabajo.
{% endhint %}

Las acciones programadas se desactivan cuando un espacio de trabajo pasa de un plan de pago a Free. Actualizar más adelante no las reactiva automáticamente. Consulta [Acciones programadas después de una degradación a Free](/docs/es/tu-espacio-de-trabajo/settings/billing.md#scheduled-actions-after-a-free-downgrade).

## Cómo configurar

Configura un disparador después de publicar la versión del Playbook que quieres que ejecuten los sistemas posteriores.

1. Abre el Playbook publicado.
2. Haz clic en **Agregar disparador**.
3. Selecciona el tipo de disparador.
4. Elige **Predeterminado** o una versión fijada del Playbook.
5. Configura los ajustes del disparador.
6. Define cualquier valor de Input requerido que deba provenir del disparador.
7. Guarda el disparador.
8. Revisa la primera sesión activada en **Historial de ejecuciones**.

Para los disparadores de webhook, copia la URL del webhook después de guardar el disparador. Envía una `POST` solicitud a esa URL con el formato de carga útil que aparece a continuación.

## Parámetros

| Parámetro              | Se aplica a            | Descripción                                                                                                                                                                                |
| ---------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Tipo de disparador     | Todos los disparadores | La condición que inicia el Playbook, como **Programación**, **Webhook**, **Monitor**, o **Información de AEO**.                                                                            |
| Versión                | Todos los disparadores | La versión del Playbook que ejecuta el disparador. **Predeterminado** sigue la versión publicada actual. Una versión fijada sigue ejecutando la versión seleccionada hasta que la cambies. |
| Configuración de Input | Todos los disparadores | Valores que el disparador pasa a la ejecución del Playbook. Los Inputs obligatorios necesitan un valor de la configuración del disparador o de la carga útil del webhook.                  |
| URL del webhook        | Webhook                | La URL que los sistemas externos llaman para iniciar el Playbook. Copia esta URL desde la configuración del disparador de webhook.                                                         |
| Cuerpo de la solicitud | Webhook                | Cuerpo JSON que contiene un `inputs` objeto con los nombres de variables de Input del Playbook como claves.                                                                                |

{% hint style="warning" %}
Si una nueva versión del Playbook cambia los Inputs, actualiza cualquier mapeo de columnas de la Grid y la configuración de Inputs del Trigger antes de ejecutar a gran escala. Los nuevos Inputs obligatorios sin valores asignados o configurados pueden hacer que las ejecuciones fallen en la validación o se omitan.
{% endhint %}

## Formato de la carga útil del webhook

El cuerpo de la solicitud debe incluir un `inputs` objeto. Cada clave dentro de `inputs` debe coincidir con un nombre de variable de Input del Playbook.

Para encontrar o editar el nombre de una variable de Input, abre el Input y haz clic en **Mostrar ajustes avanzados**.

```json
{
  "inputs": {
    "value": "valor de entrada sobrescrito",
    "non_req": "anulación opcional",
    "non_req_2": "otra anulación opcional"
  }
}
```

| Campo                                  | Obligatorio       | Descripción                                                                                                                                                                                                                                                                                                  |
| -------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `inputs`                               | Sí                | Objeto que contiene los valores de Input del Playbook para la ejecución.                                                                                                                                                                                                                                     |
| `inputs.<nombre_de_variable_de_input>` | Depende del Input | Valor para un Input del Playbook. Usa el nombre de la variable de Input, no la etiqueta visible. Los Inputs obligatorios necesitan un valor de la configuración del disparador o de la carga útil del webhook. Los Inputs opcionales pueden omitirse, a menos que quieras sobrescribirlos para la ejecución. |

## Ejemplos

### Solicitud de webhook

Reemplaza `WEBHOOK_TRIGGER_URL` con la URL que AirOps te proporciona cuando configuras el disparador de webhook.

```bash
curl --request POST \
  --url 'WEBHOOK_TRIGGER_URL' \
  --header 'content-type: application/json' \
  --data '{
    "inputs": {
      "value": "valor de entrada sobrescrito",
      "non_req": "anulación opcional",
      "non_req_2": "otra anulación opcional"
    }
  }'
```


---

# 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://docs.airops.com/docs/es/acciones/playbooks/triggers.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.