> 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 activadores de Playbook inician automáticamente los Playbooks publicados. Úsalos cuando un Playbook deba ejecutarse según un horario, responder a una solicitud HTTP, supervisar una condición o reaccionar a una señal de AirOps habilitada.

## Descripción general

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

| Activador              | Cómo funciona                                                                                                                                              | Ideal para                                                                                                          |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Programación**       | Se ejecuta de forma recurrente, por ejemplo, todos los lunes a las 9:00.                                                                                   | Auditorías semanales de contenido, comprobaciones periódicas de actualización del Brand Kit e informes recurrentes. |
| **Webhook**            | Se inicia cuando un sistema externo envía una solicitud HTTP a la URL de webhook del Playbook.                                                             | Eventos de publicación del CMS, envíos de formularios e integraciones de terceros.                                  |
| **Supervisión**        | Usa Parallel Web Systems para comprobar una consulta de supervisión cada 12 horas e inicia el Playbook cuando detecta la condición.                        | Alertas de la competencia, supervisión del mercado y supervisión del estado del contenido.                          |
| **Información de AEO** | Se inicia cuando se alcanzan los umbrales de AEO Insight habilitados, por ejemplo, cuando cambia la tasa de menciones, la cuota de voz o la tasa de citas. | Actualización programática, respuesta competitiva y brechas en la cobertura de AEO.                                 |

{% hint style="info" %}
Los activadores de AEO Insight solo están disponibles si se habilitan para tu espacio de trabajo.
{% endhint %}

Las acciones programadas se desactivan cuando un espacio de trabajo pasa de un plan de pago al plan Free. Si actualizas el plan más adelante, no se reactivarán automáticamente. Consulta [Acciones programadas tras cambiar al plan Free](https://docs.airops.com/docs/es/tu-espacio-de-trabajo/settings/billing.md#scheduled-actions-after-a-free-downgrade).

## Cómo configurarlo

Configura un activador 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 **Añadir activador**.
3. Selecciona el tipo de activador.
4. Elige **Predeterminada** o una versión fijada del Playbook.
5. Configura los ajustes del activador.
6. Establece los valores de entrada necesarios que debe proporcionar el activador.
7. Guarda el activador.
8. Revisa la primera sesión activada en **Historial de ejecuciones**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-42e824543f378742c3d7bb7adbe94c6e08bedf14%2Ftriggers-01-add-trigger.png?alt=media" alt="Add Trigger menu on a published Playbook with Schedule, Webhook, Monitor, and AEO Insight"><figcaption><p>Elige un tipo de activador para un Playbook publicado.</p></figcaption></figure>

Nuevo **Programación** De forma predeterminada, los activadores están configurados para **los miércoles a las 3:00 a. m.** en tu zona horaria local. Revisa el día, la hora y la zona horaria antes de guardar. Las programaciones existentes conservan los valores configurados.

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

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-36a24626a1ed2992e15ebfd1d0fd28a6a313d960%2Ftriggers-02-webhook-config.png?alt=media" alt="Playbook Triggers panel with the saved Webhook Trigger URL, a copy button, and Read Docs"><figcaption><p>Copia la URL del webhook después de guardar un activador de Webhook.</p></figcaption></figure>

## Parámetros

| Parámetro                 | Se aplica a           | Descripción                                                                                                                                                                             |
| ------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo de activador         | Todos los activadores | La condición que inicia el Playbook, como **Programación**, **Webhook**, **Monitor**, o **AEO Insight**.                                                                                |
| Versión                   | Todos los activadores | La versión del Playbook que ejecuta el Trigger. **Predeterminada** sigue la versión publicada actual. Una versión fijada sigue ejecutando la versión seleccionada hasta que la cambies. |
| Configuración de entradas | Todos los activadores | Valores que el Trigger pasa a la ejecución del Playbook. Las entradas obligatorias necesitan un valor de la configuración del Trigger o de la carga útil del webhook.                   |
| URL del webhook           | Webhook               | La URL a la que llaman los sistemas externos para iniciar el Playbook. Copia esta URL de la configuración del Webhook Trigger.                                                          |
| Cuerpo de la solicitud    | Webhook               | Cuerpo JSON que contiene un `inputs` objeto con los nombres de las variables de entrada del Playbook como claves.                                                                       |

{% hint style="warning" %}
Si una nueva versión del Playbook cambia las entradas, actualiza las asignaciones de columnas de Grid y la configuración de entradas del Trigger antes de ejecutarlo a gran escala. Las nuevas entradas obligatorias sin valores asignados o configurados pueden hacer que las ejecuciones no superen 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 el nombre de una variable de entrada del Playbook.

Para buscar o editar el nombre de una variable de entrada, abre la entrada y haz clic en **Mostrar configuración avanzada**.

```json
{
  "inputs": {
    "value": "overridden value input",
    "non_req": "optional override",
    "non_req_2": "another optional override"
  }
}
```

| Campo                          | Obligatoria           | Descripción                                                                                                                                                                                                                                                                                                       |
| ------------------------------ | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `inputs`                       | Sí                    | Objeto que contiene los valores de entrada del Playbook para la ejecución.                                                                                                                                                                                                                                        |
| `inputs.<input_variable_name>` | Depende de la entrada | Valor de una entrada del Playbook. Usa el nombre de la variable de entrada, no la etiqueta visible. Las entradas obligatorias necesitan un valor de la configuración del Trigger o de la carga útil del webhook. Las entradas opcionales se pueden omitir, a menos que quieras sobrescribirlas para la ejecución. |

## Administrar Triggers mediante MCP

Un agente conectado al MCP de AirOps puede usar `list_playbook_triggers`, `create_playbook_trigger`, `update_playbook_trigger`, y `delete_playbook_trigger` para administrar los Triggers de Schedule, Webhook, Monitor y AEO Insight. Se aplican los mismos permisos de Playbook y la misma validación de entradas que en la aplicación.

Pide al agente que primero revise los Triggers existentes y, después, especifica el tipo de Trigger, las entradas y si debe seguir la versión publicada o fijar una versión. Para un AEO Insight Trigger, el parámetro de configuración es `insight_config`. Estas herramientas administran los Playbook Triggers; no administran los Workflow Triggers ni los Grid Triggers.

## Ejemplos

### Solicitud de webhook

Reemplaza `WEBHOOK_TRIGGER_URL` por la URL que te proporciona AirOps al configurar el Webhook Trigger.

```bash
curl --request POST \
  --url 'WEBHOOK_TRIGGER_URL' \
  --header 'content-type: application/json' \
  --data '{
    "inputs": {
      "value": "overridden value input",
      "non_req": "optional override",
      "non_req_2": "another optional override"
    }
  }'
```


---

# 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.
