> 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/fr/actions/playbooks/triggers.md).

# Déclencheurs de Playbook

Lancez automatiquement des Playbooks avec des déclencheurs de Planification, Webhook, Surveillance et AEO Insight

Les déclencheurs de playbook lancent automatiquement les playbooks publiés. Utilisez-les lorsqu’un playbook doit s’exécuter selon un calendrier, répondre à une requête HTTP, surveiller une condition ou réagir à un signal AirOps activé.

## Présentation

Les déclencheurs exécutent une version sélectionnée du playbook et transmettent à l’exécution les valeurs d’entrée configurées. Les exécutions déclenchées apparaissent dans **l’historique des exécutions**. Les exécutions nécessitant une vérification humaine apparaissent également dans la boîte de réception.

| Déclencheur       | Fonctionnement                                                                                                                                                     | Idéal pour                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Planification** | Lance des exécutions à intervalles réguliers, par exemple tous les lundis à 9 h.                                                                                   | Audits de contenu hebdomadaires, contrôles réguliers de l’actualité du kit de marque, rapports récurrents. |
| **Webhook**       | Se déclenche lorsqu’un système externe envoie une requête HTTP à l’URL de webhook du playbook.                                                                     | Événements de publication dans un CMS, envois de formulaires, intégrations tierces.                        |
| **Surveillance**  | Utilise Parallel Web Systems pour vérifier une requête de surveillance toutes les 12 heures et lance le playbook lorsque la condition est détectée.                | Alertes concurrentielles, veille de marché, surveillance de l’état du contenu.                             |
| **Insight AEO**   | Se déclenche lorsque les seuils Insight AEO activés sont atteints, par exemple en cas d’évolution du taux de mentions, de la part de voix ou du taux de citations. | Actualisation automatisée, réponse à la concurrence, lacunes de couverture AEO.                            |

{% hint style="info" %}
Les déclencheurs Insight AEO sont disponibles uniquement s’ils sont activés pour votre espace de travail.
{% endhint %}

Les actions planifiées sont désactivées lorsqu’un espace de travail passe d’un forfait payant au forfait Gratuit. Une mise à niveau ultérieure ne les réactive pas automatiquement. Consultez [Actions planifiées après le passage au forfait Gratuit](https://docs.airops.com/docs/fr/votre-espace-de-travail/settings/billing.md#scheduled-actions-after-a-free-downgrade).

## Configuration

Configurez un déclencheur après avoir publié la version du playbook que les systèmes en aval doivent exécuter.

1. Ouvrez le playbook publié.
2. Cliquez sur **Ajouter un déclencheur**.
3. Sélectionnez le type de déclencheur.
4. Choisissez **Par défaut** ou une version épinglée du playbook.
5. Configurez les paramètres du déclencheur.
6. Définissez les valeurs d’entrée requises qui doivent provenir du déclencheur.
7. Enregistrez le déclencheur.
8. Vérifiez la première session déclenchée dans **l’historique des exécutions**.

<figure><img src="https://344527547-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>Choisissez un type de déclencheur pour un playbook publié.</p></figcaption></figure>

Nouveau **Planification** Par défaut, les déclencheurs sont définis sur **mercredi à 3 h** dans votre fuseau horaire local. Vérifiez le jour, l’heure et le fuseau horaire avant d’enregistrer. Les calendriers existants conservent leurs valeurs configurées.

Pour les déclencheurs Webhook, copiez l’URL du webhook après avoir enregistré le déclencheur. Envoyez une requête `POST` à cette URL, avec le format de charge utile indiqué ci-dessous.

<figure><img src="https://344527547-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>Copiez l’URL du webhook après avoir enregistré un déclencheur Webhook.</p></figcaption></figure>

## Paramètres

| Paramètre                 | S’applique à          | Description                                                                                                                                                                               |
| ------------------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type de déclencheur       | Tous les déclencheurs | La condition qui lance le playbook, par exemple **Planification**, **Webhook**, **Moniteur**, ou **Aperçu AEO**.                                                                          |
| Version                   | Tous les déclencheurs | La version du Playbook exécutée par le déclencheur. **Par défaut** suit la version actuellement publiée. Une version épinglée continue d’être exécutée jusqu’à ce que vous la changiez.   |
| Configuration des entrées | Tous les déclencheurs | Valeurs que le déclencheur transmet à l’exécution du Playbook. Les entrées obligatoires doivent recevoir une valeur depuis la configuration du déclencheur ou la charge utile du webhook. |
| URL du webhook            | Webhook               | URL appelée par les systèmes externes pour démarrer le Playbook. Copiez cette URL depuis la configuration du déclencheur Webhook.                                                         |
| Corps de la requête       | Webhook               | Corps JSON contenant un objet `inputs` dont les clés sont les noms des variables d’entrée du Playbook.                                                                                    |

{% hint style="warning" %}
Si une nouvelle version du Playbook modifie les entrées, mettez à jour les mappages de colonnes Grid et la configuration des entrées du déclencheur avant de lancer des exécutions à grande échelle. Les nouvelles entrées obligatoires sans valeur mappée ou configurée peuvent entraîner l’échec de la validation des exécutions ou leur omission.
{% endhint %}

## Format de la charge utile du webhook

Le corps de la requête doit inclure un objet `inputs` Chaque clé de `inputs` doit correspondre au nom d’une variable d’entrée du Playbook.

Pour trouver ou modifier le nom d’une variable d’entrée, ouvrez l’entrée et cliquez sur **Afficher les paramètres avancés**.

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

| Champ                          | Obligatoire        | Description                                                                                                                                                                                                                                                                                                                   |
| ------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `inputs`                       | Oui                | Objet contenant les valeurs des entrées du Playbook pour l’exécution.                                                                                                                                                                                                                                                         |
| `inputs.<input_variable_name>` | Dépend de l’entrée | Valeur d’une entrée du Playbook. Utilisez le nom de la variable d’entrée, et non son libellé. Les entrées obligatoires doivent recevoir une valeur depuis la configuration du déclencheur ou la charge utile du webhook. Les entrées facultatives peuvent être omises, sauf si vous souhaitez les remplacer pour l’exécution. |

## Gérer les déclencheurs via MCP

Un agent connecté au MCP AirOps peut utiliser `list_playbook_triggers`, `create_playbook_trigger`, `update_playbook_trigger`, et `delete_playbook_trigger` pour gérer les déclencheurs Planification, Webhook, Moniteur et Aperçu AEO. Les mêmes autorisations Playbook et règles de validation des entrées que dans l’application s’appliquent.

Demandez d’abord à l’agent d’examiner les déclencheurs existants, puis précisez le type de déclencheur, les entrées et s’il doit suivre la version publiée ou épingler une version. Pour un déclencheur Aperçu AEO, le paramètre de configuration est `insight_config`. Ces outils gèrent les déclencheurs de Playbook ; ils ne gèrent pas les déclencheurs de Workflow ou de Grid.

## Exemples

### Requête webhook

Remplacez `WEBHOOK_TRIGGER_URL` par l’URL fournie par AirOps lors de la configuration du déclencheur Webhook.

```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/fr/actions/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.
