Aller au contenu principal

Flux de travail

Les flux de travail sont des automatisations à l'échelle de l'espace de travail : quand quelque chose se produit (un déclencheur), Campbooks exécute une liste ordonnée d'actions — optionnellement seulement si une condition est remplie. Construisez-les sur /workflows avec un éditeur de style Zapier ; chaque exécution est enregistrée pour que vous voyiez exactement ce qui s'est passé.

Déclencheurs

Un flux de travail démarre à partir de l'un des trois déclencheurs suivants :

DéclencheurSe déclenche quand
E-mail reçuUn nouvel e-mail finit son traitement (après l'analyse et le tri IA)
WebhookUn service externe poste vers l'URL unique du flux de travail, <your-app-url>/webhooks/<token>
ÉvénementUn événement interne est publié (p. ex. un document est approuvé)

L'URL du webhook est générée automatiquement et peut être régénérée ; elle ne nécessite pas d'authentification, ce qui permet à d'autres services de l'appeler.

Conditions

Un déclencheur peut porter une condition, et le flux de travail ne s'exécute que si elle est satisfaite — par exemple, "uniquement quand le type de document de l'e-mail est facture," ou une vérification de champ générique comme payload.status == "paid" sur le corps d'un webhook. Une condition qui échoue arrête l'exécution proprement.

Actions

Chaque étape effectue une action. Actions intégrées :

ActionCe qu'elle fait
Envoyer un e-mailEnvoyer un message depuis l'un de vos comptes connectés
Requête HTTPEffectuer un appel API sortant
Message SlackPublier vers un webhook entrant Slack
Message DiscordPublier vers un webhook entrant Discord
Action personnaliséeAppeler une Connexion enregistrée (URL de base + auth réutilisables)
Action e-mailAgir sur l'e-mail déclencheur — l'étiqueter, l'archiver ou le mettre en attente
Créer un événement de calendrierTransformer l'e-mail déclencheur en événement de calendrier
Envoyer vers Google DriveCréer un dossier ou téléverser les pièces jointes de l'e-mail
Envoyer vers NotionCréer une page ou un élément de base de données
Émettre un événementPublier un événement interne (qui peut déclencher d'autres flux de travail)

Templating avec Liquid

Chaque champ d'une étape est un modèle Liquid rendu contre les données du déclencheur, de sorte que les actions peuvent utiliser les vraies valeurs de ce qui les a déclenchées :

  • Les déclencheurs e-mail exposent email et documents — p. ex. {{ email.subject }}, {{ email.from }}.
  • Les déclencheurs webhook exposent payload, headers et query — p. ex. {{ payload.invoice_id }}.

Les variables manquantes sont rendues vides plutôt qu'en erreur, de sorte que les modèles restent indulgents.

Connexions

Une Connexion est une cible d'intégration enregistrée et réutilisable : une URL de base plus une auth chiffrée (bearer, header ou basic). L'Action personnalisée résout la connexion côté serveur et injecte son en-tête auth au moment de l'exécution, de sorte que vos secrets ne résident jamais dans le modèle d'une étape. Gérez-les dans Paramètres → Intégrations → Connexions.

Les appels sortants sont protégés. Chaque action basée sur HTTP passe par une couche de sécurité qui bloque les requêtes vers les adresses de loopback, privées, link-local et de métadonnées cloud (les hôtes locaux sont autorisés uniquement en développement), avec des limites de taille de requête et de délai. Cela empêche qu'un flux de travail soit détourné pour atteindre votre réseau interne.

Historique des exécutions

Ouvrez l'onglet Exécutions d'un flux de travail pour voir chaque exécution : son statut (en cours, terminée, échouée), quand elle a démarré et terminé, toute erreur, et les entrées/sorties capturées pour chaque étape — ainsi le débogage d'une automatisation consiste à lire la trace, non à deviner.

Déclenchement depuis l'API

Les flux de travail webhook peuvent également être déclenchés par programme via l'API publique avec un scope workflows:trigger, ce qui est l'équivalent authentifié de l'envoi d'un POST vers l'URL du webhook.