For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 planning, 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 sélectionnée du Playbook 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 revue 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 tous les lundis à 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 lance 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, par exemple lorsque le taux de mentions, la part de voix ou le taux de citation évoluent.

Actualisation programmatique, réponse concurrentielle, lacunes de couverture AEO.

Les déclencheurs AEO Insight sont disponibles uniquement lorsqu’ils sont activés pour votre espace de travail.

Les actions planifiées sont désactivées lorsqu’un espace de travail passe d’un forfait payant à Free. Une mise à niveau ultérieure ne les réactive pas automatiquement. Voir Actions planifiées après une rétrogradation en formule Free.

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.

Add Trigger menu on a published Playbook with Schedule, Webhook, Monitor, and AEO Insight
Choisissez un type de déclencheur pour un Playbook publié.

Nouveau Planification Les déclencheurs sont définis par défaut sur mercredi à 3 h 00 dans votre fuseau horaire local. Vérifiez le jour, l’heure et le fuseau horaire avant d’enregistrer. Les plannings 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 POST requête à cette URL avec le format de charge utile ci-dessous.

Playbook Triggers panel with the saved Webhook Trigger URL, a copy button, and Read Docs
Copiez l’URL du webhook après avoir enregistré un déclencheur Webhook.

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 exécutée par le déclencheur. 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 nécessitent une valeur provenant de la configuration du déclencheur ou de la charge utile du webhook.

URL du webhook

Webhook

L’URL appelée par les systèmes externes pour lancer le Playbook. Copiez cette URL depuis la configuration du déclencheur Webhook.

Corps de la requête

Webhook

Corps JSON contenant un objet inputs objet dont les noms de variables d’entrée du Playbook servent de clés.

Format de charge utile du webhook

Le corps de la requête doit inclure un objet inputs objet. Chaque clé à l’intérieur de objet 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.

Champ
Obligatoire
Description

objet 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 variable de l’entrée, et non le libellé affiché. Les entrées requises nécessitent 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.

Des exemples

Requête webhook

Remplacez WEBHOOK_TRIGGER_URL avec l’URL qu’AirOps vous fournit lorsque vous configurez le déclencheur Webhook.

Mis à jour

Ce contenu vous a-t-il été utile ?