Les déclencheurs
Le déclencheur est le premier bloc d’un workflow : il dit quand le workflow démarre et ce qu’il reçoit. Un workflow peut en avoir plusieurs, par exemple un événement CRM et une réponse d’e-mail qui mènent chacun à leur branche.
La liste
Section intitulée « La liste »| Déclencheur | Le workflow démarre… |
|---|---|
| Planification | à intervalle régulier (minutes, heures, jours, semaines, mois) ou selon une expression cron, à l’heure de Paris. 5 minutes au minimum. |
| Événement CRM | quand une fiche d’un objet est créée ou modifiée, éventuellement seulement si certains champs ont changé. Ce que le workflow écrit lui-même ne le relance pas. |
| E-mail reçu | quand un e-mail arrive dans la boîte de réception d’un compte Gmail ou Outlook connecté (hors brouillons, spam et envois), avec un filtre facultatif sur l’expéditeur et l’objet. |
| E-mail classé | quand Verdict, une règle d’expéditeur ou une personne range un e-mail dans une catégorie de l’Inbox. Une fois par e-mail et par catégorie, jamais pour un e-mail de plus de 2 jours. |
| Événement d’agenda | quelques minutes avant un rendez-vous de l’agenda principal d’un compte connecté, ou quand il est ajouté, modifié ou annulé. Les rendez-vous sur la journée entière ne déclenchent pas « va commencer ». |
| Réunion transcrite | quand une réunion enregistrée est transcrite et analysée. |
| État d’un enregistrement | quand l’enregistreur d’une réunion entre en salle d’attente, commence, finit ou échoue. |
| Document signé | quand tous les signataires ont signé et que le PDF signé est rangé sur la fiche. |
| Réponse de l’avocat | quand l’avocat répond dans le fil d’un contrat envoyé par le bloc « Envoyer à l’avocat ». |
| Message reçu sur le chat | quand un visiteur écrit sur le chat client, éventuellement seulement pour un widget ou une catégorie Verdict. |
| Séquence : réponse ou fin | quand un contact répond à une séquence, la termine ou en sort (rendez-vous, rebond, désinscription, retrait). |
| Webhook entrant | quand une application externe envoie un POST JSON à l’adresse du workflow. |
| Appel d’API | quand une application appelle l’API du CRM avec une clé d’API. |
| Lancement manuel | à la demande, depuis l’éditeur, depuis une fiche ou en le demandant à Atlas. |
Les déclencheurs liés à une boîte, un agenda ou des réunions ne voient que ce que voit la personne qui publie le workflow : ses comptes connectés et les boîtes partagées qu’elle peut lire, ses réunions, et les réunions partagées avec l’équipe sur une fiche qu’elle peut lire.
Webhook entrant
Section intitulée « Webhook entrant »Une fois le workflow enregistré, le panneau affiche l’URL du webhook. L’application qui appelle s’authentifie :
- avec le jeton secret du workflow, dans l’en-tête
X-Arcane-Webhook-Token; - ou avec une signature HMAC-SHA256 du corps faite avec ce jeton, dans l’en-tête
X-Arcane-Signature: sha256=<hex>; - ou, si vous choisissez l’Application qui envoie (Stripe, Shopify, WooCommerce, GitHub, Calendly, Typeform, Standard Webhooks), avec sa propre signature : collez l’URL chez elle et enregistrez ici le secret de signature qu’elle vous donne. Le jeton ne sert alors plus.
Régénérer le jeton secret en crée un nouveau : l’ancien cesse aussitôt de marcher. L’URL et le jeton ne sont visibles que des administrateurs et de l’auteur automatiseur du workflow.
Écouter un appel de test attend un appel pendant 10 minutes : déclenchez un envoi depuis votre application, le CRM garde le corps reçu et propose ses champs dans l’autocomplétion des expressions ({{ $json.body.… }}). Pendant l’écoute, l’appel ne lance pas le workflow s’il n’est pas actif. Relier les champs avec Atlas lui demande comment brancher ces champs sur ceux du CRM.
Appel d’API
Section intitulée « Appel d’API »L’application appelle POST /v1/workflows/<id>/run avec une clé d’API de l’organisation qui a la permission « Lancer les workflows » (Réglages › Intégrations › Clés API), en-tête Authorization: Bearer <clé> et un corps JSON. Le workflow doit être actif. L’appel attend la fin du workflow 30 secondes au plus et reçoit ce que renvoie le bloc Répondre à l’appel ; au-delà, il reçoit l’identifiant de l’exécution.
Lancement manuel
Section intitulée « Lancement manuel »Sans objet choisi, le workflow se lance par Exécuter maintenant dans l’éditeur (administrateurs et auteur automatiseur), ou en le demandant à Atlas.
Avec un objet (par exemple Opportunités), une fois le workflow actif, chaque fiche de cet objet affiche un bouton Lancer un workflow : le workflow reçoit la fiche. N’importe quel membre peut le lancer ; un message Workflow lancé propose de Suivre l’exécution.