> 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/de/aktionen/playbooks/triggers.md).

# Playbook-Trigger

Starte Playbooks automatisch mit Zeitplan-, Webhook-, Monitor- und AEO-Insight-Triggern

Playbook-Trigger starten veröffentlichte Playbooks automatisch. Verwenden Sie sie, wenn ein Playbook nach einem Zeitplan ausgeführt werden, auf eine HTTP-Anfrage reagieren, eine Bedingung überwachen oder auf ein aktiviertes AirOps-Signal reagieren soll.

## Übersicht

Trigger führen eine ausgewählte Playbook-Version aus und übergeben konfigurierte Eingabewerte an den Lauf. Durch Trigger gestartete Läufe werden im **Ausführungsverlauf**angezeigt. Läufe, die eine menschliche Überprüfung erfordern, erscheinen auch im Posteingang.

| Trigger         | So funktioniert es                                                                                                                                                  | Optimal für                                                                                |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| **Zeitplan**    | Wird regelmäßig ausgeführt, zum Beispiel jeden Montag um 9 Uhr.                                                                                                     | Wöchentliche Content-Prüfungen, Aktualitätsprüfungen des Brand Kits, regelmäßige Berichte. |
| **Webhook**     | Wird gestartet, wenn ein externes System eine HTTP-Anfrage an die Webhook-URL des Playbooks sendet.                                                                 | CMS-Veröffentlichungsereignisse, Formularübermittlungen, Integrationen von Drittanbietern. |
| **Überwachung** | Verwendet Parallel Web Systems, um alle 12 Stunden eine Überwachungsabfrage auszuführen, und startet das Playbook, sobald die Bedingung erkannt wird.               | Wettbewerbswarnungen, Marktüberwachung, Überwachung der Content-Qualität.                  |
| **AEO Insight** | Wird gestartet, wenn aktivierte AEO-Insight-Schwellenwerte erreicht werden, etwa bei einer Änderung der Erwähnungsrate, des Share of Voice oder der Zitierungsrate. | Programmatische Aktualisierung, Reaktion auf Wettbewerber, Lücken bei der AEO-Abdeckung.   |

{% hint style="info" %}
AEO-Insight-Trigger sind nur verfügbar, wenn sie für Ihren Workspace aktiviert sind.
{% endhint %}

Geplante Aktionen werden deaktiviert, wenn ein Workspace von einem kostenpflichtigen Tarif auf Free wechselt. Ein späteres Upgrade aktiviert sie nicht automatisch wieder. Weitere Informationen finden Sie unter [Geplante Aktionen nach einem Downgrade auf Free](https://docs.airops.com/docs/de/dein-workspace/settings/billing.md#scheduled-actions-after-a-free-downgrade).

## Konfiguration

Konfigurieren Sie einen Trigger, nachdem Sie die Playbook-Version veröffentlicht haben, die nachgelagerte Systeme ausführen sollen.

1. Öffnen Sie das veröffentlichte Playbook.
2. Klicken Sie auf **Trigger hinzufügen**.
3. Wählen Sie den Trigger-Typ aus.
4. Wählen Sie **Standard** oder eine angeheftete Playbook-Version aus.
5. Konfigurieren Sie die Trigger-Einstellungen.
6. Legen Sie alle erforderlichen Eingabewerte fest, die vom Trigger übergeben werden sollen.
7. Speichern Sie den Trigger.
8. Überprüfen Sie die erste durch einen Trigger gestartete Sitzung im **Ausführungsverlauf**.

<figure><img src="https://1960680173-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>Wählen Sie einen Trigger-Typ für ein veröffentlichtes Playbook aus.</p></figcaption></figure>

Neu **Zeitplan** Trigger sind standardmäßig auf **Mittwoch um 3:00 Uhr** in Ihrer lokalen Zeitzone eingestellt. Prüfen Sie vor dem Speichern den Wochentag, die Uhrzeit und die Zeitzone. Bei bestehenden Zeitplänen bleiben die konfigurierten Werte erhalten.

Kopieren Sie bei Webhook-Triggern die Webhook-URL, nachdem Sie den Trigger gespeichert haben. Senden Sie eine `POST` -Anfrage mit dem unten angegebenen Payload-Format an diese URL.

<figure><img src="https://1960680173-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>Kopieren Sie die Webhook-URL, nachdem Sie einen Webhook-Trigger gespeichert haben.</p></figcaption></figure>

## Parameter

| Parameter            | Gilt für     | Beschreibung                                                                                                                                                                                                        |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Trigger-Typ          | Alle Trigger | Die Bedingung, die das Playbook startet, zum Beispiel **Zeitplan**, **Webhook**, **Monitor**, oder **AEO Insight**.                                                                                                 |
| Version              | Alle Trigger | Die Version des Playbooks, die der Trigger ausführt. **Standard** folgt der aktuell veröffentlichten Version. Bei einer festgelegten Version wird die ausgewählte Version weiterhin ausgeführt, bis du sie änderst. |
| Eingabekonfiguration | Alle Trigger | Werte, die der Trigger an die Playbook-Ausführung übergibt. Erforderliche Eingaben benötigen einen Wert aus der Triggerkonfiguration oder der Webhook-Nutzlast.                                                     |
| Webhook-URL          | Webhook      | Die URL, die externe Systeme aufrufen, um das Playbook zu starten. Kopiere diese URL aus der Konfiguration des Webhook-Triggers.                                                                                    |
| Anfragetext          | Webhook      | JSON-Text mit einem `inputs` -Objekt, dessen Schlüssel den Variablennamen der Playbook-Eingaben entsprechen.                                                                                                        |

{% hint style="warning" %}
Wenn eine neue Playbook-Version die Eingaben ändert, aktualisiere alle Grid-Spaltenzuordnungen und die Eingabekonfiguration des Triggers, bevor du den Vorgang in großem Umfang ausführst. Neue erforderliche Eingaben ohne zugeordnete oder konfigurierte Werte können dazu führen, dass Ausführungen die Validierung nicht bestehen oder übersprungen werden.
{% endhint %}

## Webhook-Nutzlastformat

Der Anfragetext muss ein `inputs` -Objekt enthalten. Jeder Schlüssel darin `inputs` sollte einem Variablennamen einer Playbook-Eingabe entsprechen.

Um den Namen einer Eingabevariablen zu finden oder zu bearbeiten, öffne die Eingabe und klicke auf **Erweiterte Einstellungen anzeigen**.

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

| Feld                           | Erforderlich             | Beschreibung                                                                                                                                                                                                                                                                                                                |
| ------------------------------ | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `inputs`                       | Ja                       | Objekt mit den Werten der Playbook-Eingaben für die Ausführung.                                                                                                                                                                                                                                                             |
| `inputs.<input_variable_name>` | Hängt von der Eingabe ab | Wert für eine Playbook-Eingabe. Verwende den Variablennamen der Eingabe, nicht die angezeigte Bezeichnung. Erforderliche Eingaben benötigen einen Wert aus der Triggerkonfiguration oder der Webhook-Nutzlast. Optionale Eingaben können ausgelassen werden, sofern du sie nicht für die Ausführung überschreiben möchtest. |

## Trigger über MCP verwalten

Ein mit AirOps MCP verbundener Agent kann `list_playbook_triggers`, `create_playbook_trigger`, `update_playbook_trigger` und `delete_playbook_trigger` verwenden, um Zeitplan-, Webhook-, Monitor- und AEO-Insight-Trigger zu verwalten. Es gelten dieselben Playbook-Berechtigungen und Eingabevalidierungen wie in der App.

Bitte den Agenten, zuerst vorhandene Trigger zu prüfen. Gib dann den Trigger-Typ, die Eingaben und an, ob die veröffentlichte Version verwendet oder eine Version festgelegt werden soll. Bei einem AEO-Insight-Trigger lautet der Konfigurationsparameter `insight_config`. Diese Tools verwalten Playbook-Trigger, nicht aber Workflow- oder Grid-Trigger.

## Beispiele

### Webhook-Anfrage

Ersetze `WEBHOOK_TRIGGER_URL` durch die URL, die AirOps dir bei der Konfiguration des Webhook-Triggers bereitstellt.

```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/de/aktionen/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.
