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

## Aperçu

Les déclencheurs exécutent une version de Playbook sélectionnée et transmettent les valeurs d’entrée configurées à l’exécution. Les exécutions déclenchées apparaissent dans **Historique des exécutions**. Les exécutions qui nécessitent une révision humaine apparaissent également dans la boîte de réception.

| Déclencheur       | Fonctionnement                                                                                                                                        | Idéal pour                                                                                     |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Planification** | S’exécute selon une cadence récurrente, par exemple chaque lundi à 9 h.                                                                               | Audits de contenu hebdomadaires, vérifications de fraîcheur du Brand Kit, rapports récurrents. |
| **Webhook**       | Démarre lorsqu’un système externe envoie une requête HTTP à l’URL du webhook du Playbook.                                                             | Événements de publication CMS, soumissions de formulaires, intégrations tierces.               |
| **Surveillance**  | Utilise Parallel Web Systems pour vérifier une requête de surveillance toutes les 12 heures et démarre le Playbook lorsque la condition est détectée. | Alertes concurrentielles, surveillance du marché, surveillance de la santé du contenu.         |
| **AEO Insight**   | Démarre lorsque les seuils AEO Insight activés sont atteints, comme une modification du taux de mentions, de la part de voix ou du taux de citation.  | Actualisation programmatique, réponse concurrentielle, lacunes de couverture AEO.              |

{% hint style="info" %}
Les déclencheurs d’aperçu AEO sont disponibles uniquement lorsqu’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’une formule payante à Free. Une mise à niveau ultérieure ne les réactive pas automatiquement. Voir [Actions planifiées après une rétrogradation vers Free](/docs/fr/votre-espace-de-travail/settings/billing.md#scheduled-actions-after-a-free-downgrade).

## Comment configurer

Configurez un déclencheur après avoir publié la version du Playbook que vous souhaitez voir exécuter par les systèmes en aval.

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 toutes les valeurs d’entrée requises qui doivent provenir du déclencheur.
7. Enregistrez le déclencheur.
8. Consultez la première session déclenchée dans **Historique des exécutions**.

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

## Paramètres

| Paramètre                 | S’applique à          | Description                                                                                                                                                                                            |
| ------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Type de déclencheur       | Tous les déclencheurs | La condition qui lance le Playbook, comme **Planification**, **Webhook**, **Surveillance**, ou **AEO Insight**.                                                                                        |
| Version                   | Tous les déclencheurs | La version du Playbook que le déclencheur exécute. **par défaut** suit la version publiée actuelle. Une version épinglée continue d’exécuter la version sélectionnée jusqu’à ce que vous la modifiiez. |
| Configuration des entrées | Tous les déclencheurs | Valeurs que le déclencheur transmet à l’exécution du Playbook. Les entrées requises ont besoin d’une valeur provenant de la configuration du déclencheur ou de la charge utile du webhook.             |
| URL du webhook            | Webhook               | L’URL que les systèmes externes appellent pour lancer le Playbook. Copiez cette URL depuis la configuration du déclencheur Webhook.                                                                    |
| Corps de la requête       | Webhook               | Corps JSON contenant un `inputs` objet avec les noms des variables d’entrée du Playbook comme clés.                                                                                                    |

{% hint style="warning" %}
Si une nouvelle version du Playbook modifie les entrées, mettez à jour les associations de colonnes de grille et la configuration des entrées du déclencheur avant un passage à grande échelle. De nouvelles entrées requises sans valeurs mappées ou configurées peuvent faire échouer la validation des exécutions ou les faire ignorer.
{% endhint %}

## Format de charge utile du webhook

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

Pour trouver ou modifier un nom de 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 d’entrée du Playbook pour l’exécution.                                                                                                                                                                                                                                                                    |
| `inputs.<input_variable_name>` | Dépend de l’entrée | Valeur pour une entrée du Playbook. Utilisez le nom de la variable d’entrée, pas le libellé affiché. Les entrées requises ont besoin d’une valeur provenant de la configuration du déclencheur ou de la charge utile du webhook. Les entrées facultatives peuvent être omises, sauf si vous souhaitez les remplacer pour l’exécution. |

## Exemples

### Requête webhook

Remplacez `WEBHOOK_TRIGGER_URL` avec l’URL que AirOps vous fournit lorsque vous configurez le 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.