> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentova.ai/llms.txt > Use this file to discover all available pages before exploring further. # Agentova Trigger > Lancez un workflow dès que quelque chose se passe dans votre espace de travail ## Choisir les événements Dans **Events**, cochez un ou plusieurs événements : **Lead Created**, **Run Completed**, **Automation Status Changed**. ![Le nœud Agentova Trigger dans n8n, avec l'identifiant choisi et la liste Events ouverte : Automation Status Changed, Lead Created et Run Completed](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/n8n/trigger-events.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=a79220312f6245bf766e5b66df790596) Les trois événements proposés par le déclencheur | Événement | Se produit quand | Ce que vous recevez | | - | - | - | | **Lead créé** (`lead.created`) | Un nouveau lead est capté dans votre espace de travail : le formulaire de contact du chatbot de votre site, un formulaire Lead Ads, votre agent téléphonique, un prospect qui a envoyé ses coordonnées après avoir commenté une publication, ou un contact entrant d'un CRM. Seulement à la création : un lead mis à jour ensuite (par exemple un formulaire de chat envoyé deux fois dans la même conversation) ne déclenche rien de nouveau. | Le lead : nom, e-mail, téléphone, source, agent, champs personnalisés | | **Exécution terminée** (`run.completed`) | L'une de vos automatisations vient de faire quelque chose : répondre à un message, un commentaire ou un e-mail, traiter un formulaire Lead Ads, traiter un contact d'un CRM. | L'exécution : quelle automatisation, ce qui l'a déclenchée, chaque action avec son résultat (`success` ou `failed`), et le résultat global de l'exécution (`success`, `partial` ou `failed`) | | **Statut d'automatisation modifié** (`automation.status_changed`) | Le statut d'une automatisation change réellement, que le changement vienne de l'application Agentova ou de l'API : elle est mise en pause ou réactivée, une source CRM est activée, un échec la fait passer en `error`, ou elle redevient `active` une fois son compte reconnecté. | L'automatisation, avec son nouveau statut | Quand un échec fait disparaître une automatisation — accès au compte révoqué, boîte mail qui refuse la connexion, canal impossible à reconnecter — l'automatisation sort de l'API et un dernier **Statut d'automatisation modifié** avec le statut `error` est envoyé : quand il arrive, chercher l'automatisation par son ID répond `automation_not_found`. Supprimer une automatisation ou la désactiver dans l'application Agentova n'envoie rien. Le déclencheur se lance pour **tout l'espace de travail**. Pour ne garder qu'une partie des éléments (une source, un agent, uniquement les échecs…), ajoutez un nœud **If** ou **Filter** juste après — voir les [exemples de workflows](https://docs.agentova.ai/n8n/recipes.md). ## Contenu de chaque événement Chaque exécution du workflow reçoit un élément (item) contenant l'enveloppe de l'événement : | Champ | Contenu | | - | - | | `id` | L'identifiant unique de l'événement (`evt_…`) | | `type` | `lead.created`, `run.completed` ou `automation.status_changed` | | `created_at` | Le moment où l'événement s'est produit | | `data` | Le lead, l'exécution ou l'automatisation | ### Lead créé Un lead est créé — et **Lead créé** se produit — depuis cinq endroits : | Source | D'où vient le lead | | - | - | | `widget` | Le formulaire de contact du chatbot de votre site, quand un visiteur le remplit. Les leads créés à la main dans Agentova, là où c'est possible, utilisent aussi `widget`. | | `lead_ads` | Un formulaire Lead Ads Facebook ou Instagram, traité par une automatisation Lead Ads — même quand cette automatisation est en pause | | `telephony` | Un appel qualifié par votre agent téléphonique | | `social` | Un prospect qui a commenté l'une de vos publications Instagram ou Facebook, puis envoyé ses coordonnées (e-mail ou téléphone) en message privé à votre automatisation de commentaires | | `crm` | Un contact entrant d'un CRM connecté (HubSpot, Monday, Customer.io…) pour lequel l'une de vos automatisations CRM s'est exécutée | Un lead `social` ou `crm` n'est créé que si le prospect a donné un e-mail ou un numéro de téléphone, et une seule fois par personne et par automatisation. Son `name` est ce qu'Agentova connaît : le nom d'utilisateur Instagram ou Facebook pour `social`, le prénom et le nom issus du CRM pour `crm`. Ces cas **ne créent pas de lead** : les messages privés et les e-mails auxquels vos agents répondent, et les commentaires qui n'aboutissent pas à des coordonnées. Pour les sources CRM autres que Customer.io, le service partenaire qui relaie leurs événements n'indique pas encore à Agentova quelle automatisation a traité un contact : leurs leads ne sont enregistrés que si l'espace de travail n'a qu'une seule automatisation CRM de ce type. `phone` est le numéro tel qu'il a été saisi ou capté — il n'est pas normalisé. `custom_fields` contient les réponses supplémentaires du formulaire ; les clés qui commencent par `_` sont internes à Agentova et ne sont jamais exposées. `data` contient : `id`, `source`, `agent_id`, `name`, `email`, `phone`, `custom_fields`, `created_at`. ### Exécution terminée | Automatisation | Une exécution est enregistrée quand… | Déclencheur (`trigger_type`) | Actions listées | | - | - | - | - | | Messages privés (Facebook, Instagram, WhatsApp) | votre agent a réellement envoyé une réponse | `message` | la réponse | | E-mails (Gmail, Outlook, IMAP) | un e-mail entrant a été traité | `email` | la réponse envoyée, ou le brouillon enregistré | | Commentaires (Facebook, Instagram) | un commentaire a été traité | `comment` | la réponse publique, le message privé | | Commentaires (Facebook, Instagram), après la réponse du prospect | un prospect a envoyé ses coordonnées en message privé, et les actions de suite de l'automatisation se sont exécutées | `message` | ajout au CRM, message au prospect | | Stories (Instagram) | une réponse à une story a été traitée | `story_reply` | la réponse | | Lead Ads | un formulaire a été reçu et le lead créé | `lead_ads` | message au prospect, ajout au CRM — l'exécution porte aussi l'ID du lead | | Sources CRM | une action s'est exécutée pour un contact entrant | `crm_event` | message (e-mail, WhatsApp), ajout au CRM — l'exécution porte aussi l'ID du lead quand un lead a été créé | Bon à savoir : * **Pas d'exécution quand rien ne s'est passé.** Un message auquel votre agent n'a finalement pas répondu ne produit aucune exécution. * **Plusieurs messages à la suite, une seule exécution.** Des messages qui arrivent ensemble et reçoivent une réponse commune font une seule exécution. * **Une automatisation Lead Ads sans action configurée** enregistre quand même une exécution, avec le statut `success` et une liste d'actions vide. Pendant qu'elle est en pause, ses leads sont créés mais aucune action ne s'exécute. * **Pas d'exécution pour le chatbot du site.** * **Sources CRM :** Customer.io enregistre une exécution pour chaque contact sur lequel il agit. Les autres sources CRM (HubSpot, Typeform, Close, Monday, ClickUp, Tally, Odoo…) sont relayées par un service partenaire qui n'indique pas encore à Agentova quelle automatisation a traité un événement : leurs exécutions ne sont enregistrées que si l'espace de travail n'a qu'une seule automatisation CRM de ce type. Un workflow CRM enregistre une exécution par action. * Sur les commentaires, une action que vous n'avez pas configurée peut apparaître en `success`. C'est une limite connue. * Les exécutions sont conservées **90 jours**, puis supprimées. `data` contient : `id`, `automation_id`, `status`, `trigger_type`, `occurred_at`, `actions` (chacune avec son propre `type` et un `status` qui vaut `success` ou `failed` — seule l'exécution dans son ensemble peut être `partial`), `lead_id`. ### Statut d'automatisation modifié `data` est l'automatisation : `id`, `name`, `type`, `provider`, `agent_id`, `agent_name`, `status`, `updated_at`. Mettre en pause une automatisation déjà en pause ne change rien, donc rien ne se déclenche ; supprimer une automatisation ou la désactiver dans l'application Agentova ne déclenche rien non plus. ## Activer le workflow **Activer** le workflow enregistre le déclencheur auprès d'Agentova (un abonnement webhook) ; le **désactiver** supprime cet abonnement. Vous n'avez jamais à le gérer à la main. À chaque activation, le déclencheur répare aussi son enregistrement : si Agentova a désactivé l'abonnement après des échecs de livraison répétés, si l'adresse de webhook de n8n a changé, ou si vous avez modifié les événements choisis, l'ancien abonnement est supprimé et un nouveau est créé. Les restes d'une activation qui a échoué sont nettoyés de la même façon. Pour l'essayer avant d'activer le workflow, cliquez sur **Listen for test event** (ou **Execute step**), puis provoquez l'événement dans Agentova — par exemple en mettant en pause puis en réactivant une automatisation. ![Le nœud Agentova Trigger après un événement de test : en sortie, l'enveloppe JSON avec id, type automation.status\_changed, created\_at et, dans data, l'automatisation passée en paused](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/n8n/trigger-event-received.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=a3aff0c62600cfca11500fa4f0038995) Un vrai événement reçu : une automatisation mise en pause dans l'espace de travail ## Sécurité, doublons et ordre * **Vérification de la signature.** Chaque notification d'Agentova est signée. Le déclencheur vérifie la signature et son ancienneté (5 minutes au plus) avant de lancer le workflow. Tout ce qui n'est pas signé, est falsifié ou rejoué est refusé, n'atteint jamais votre workflow, et n8n journalise un avertissement avec la raison — jamais le secret. * **Doublons.** Après un problème réseau, Agentova peut renvoyer le même événement. Le déclencheur garde en mémoire les événements déjà traités pendant 72 heures (jusqu'à 50 000 événements) et ne lance le workflow qu'une fois par événement — **au sein d'un même processus n8n** : cette mémoire est perdue au redémarrage de n8n et n'est pas partagée entre les instances en mode file d'attente (queue mode). * **Ordre.** Les événements peuvent arriver dans n'importe quel ordre. Pour connaître le dernier statut d'une automatisation, comparez `{{ $json.data.updated_at }}`, pas l'ordre des exécutions. > [!TIP] > > Si un événement ne doit jamais être traité deux fois — un contact créé dans un CRM, un SMS envoyé — ajoutez le nœud **Remove Duplicates** de n8n juste après le déclencheur, avec l'opération **Remove Items Processed in Previous Executions** et `{{ $json.id }}` comme valeur de dédoublonnage. Contrairement à la mémoire du déclencheur, il survit aux redémarrages. ## Après une panne Si votre n8n est resté injoignable longtemps, Agentova fait jusqu'à 8 tentatives de livraison pour chaque notification sur environ 27 heures et demie. Dès que trois notifications d'affilée ont été abandonnées **et** que les livraisons échouent depuis au moins 72 heures, Agentova désactive l'abonnement et prévient les administrateurs de votre espace de travail. **Désactivez, puis réactivez le workflow** : le déclencheur supprime l'abonnement désactivé et en crée un nouveau. Il en va de même si l'abonnement a été désactivé d'emblée parce que son URL ne passe plus les contrôles d'adresse d'Agentova. Agentova peut aussi couper son API pour un temps. Les événements survenus pendant cette coupure ne sont jamais livrés : une fois que l'API répond de nouveau, rattrapez-les avec les endpoints de liste de l'API (`GET /leads`, `GET /runs`, ou **Agentova → List** pour les automatisations). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.