> ## 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. # Déclencheurs > Lancez un Zap quand un lead arrive, qu'une exécution se termine ou qu'une automatisation change de statut | Déclencheur dans Zapier | Événement | | - | - | | **New Lead** | Lead créé | | **Run Completed** | Exécution terminée | | **Automation Status Changed** | Statut d'automatisation modifié | > [!NOTE] > > Aucun webhook à configurer à la main. Dans l'éditeur de Zap, choisissez l'application **Agentova**, puis l'un de ces déclencheurs dans la liste des événements. Quand vous publiez le Zap, Zapier s'abonne tout seul à Agentova : l'abonnement apparaît dans le tableau **Abonnements webhook** de **Paramètres → API**, avec la clé du compte connecté. Désactiver le Zap le supprime. | É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. Chaque déclencheur se produit pour **tout l'espace de travail** : tous ses leads, toutes ses automatisations couvertes. Pour n'en garder qu'une partie, ajoutez une étape **Filter by Zapier** juste après le déclencheur (voir [Zaps prêts à l'emploi](https://docs.agentova.ai/zapier/recipes.md)). ## New Lead Se produit une fois par nouveau lead, quelques secondes après son enregistrement dans Agentova. 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. **Champs utilisables dans les étapes suivantes :** ID (l'ID du lead), Event ID, Source, Agent ID, Name, Email, Phone, Custom fields, Created At. Le nom, l'e-mail et le téléphone peuvent être vides, selon ce que le prospect a donné. Lead ID reprend l'ID, pour les Zaps créés avec une version précédente de l'application. ## Run Completed Se produit chaque fois que l'une de vos automatisations a réellement fait quelque chose. | 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. **Champs utilisables :** ID (l'ID de l'exécution), Event ID, Automation ID, Status (`success`, `partial`, `failed`), Trigger Type, Occurred At, Actions (chacune avec son Action Type et son Action Status : `success` ou `failed`), et Lead ID pour les exécutions Lead Ads et CRM. Run ID reprend l'ID, pour les Zaps créés avec une version précédente de l'application. ## Automation Status Changed Se produit quand le statut d'une automatisation change réellement, depuis l'application Agentova ou depuis l'API — y compris par vos propres Zaps : elle est mise en pause ou réactivée, elle s'arrête sur une erreur, ou elle revient après la reconnexion de son compte. Ces automatisations sont couvertes : | Type | Ce qu'elle fait | Canaux (`provider`) | | - | - | - | | `social_comments` | Répond aux commentaires sur vos publications | Facebook, Instagram | | `social_story` | Répond aux réponses à vos stories | Instagram | | `social_messages` | Répond aux messages privés | Facebook, Instagram, WhatsApp | | `lead_ads` | Traite les formulaires Lead Ads (message au prospect, ajout à votre CRM) | Facebook, Instagram | | `email_messages` | Répond aux e-mails | Gmail, Outlook, IMAP | | `crm_source` | Agit quand un contact ou une réponse arrive dans un CRM ou un outil de formulaires | HubSpot, Close, Monday, ClickUp, Typeform, Tally, Odoo, Customer.io… | **Non couverts en v1 :** les agents téléphoniques, le chatbot du site lui-même (c'est un agent, pas une automatisation), les publications programmées sur les réseaux sociaux et les workflows du builder. Une automatisation supprimée ou désactivée dans l'application Agentova, ou dont le compte est déconnecté, n'apparaît pas du tout. **Champs utilisables :** ID (l'ID de l'automatisation), Event ID, Name, Type, Provider, Agent ID, Agent Name, Status (`active`, `paused`, `draft`, `error`), Updated At. Automation ID reprend l'ID, pour les Zaps créés avec une version précédente de l'application. > [!NOTE] > > Mettre en pause une automatisation déjà en pause ne déclenche rien : rien n'a changé. Supprimer une automatisation ou la désactiver dans l'application Agentova ne déclenche rien non plus. ## Tester un déclencheur Quand vous cliquez sur **Test trigger**, Zapier affiche en exemples vos éléments réels les plus récents : vos derniers leads, exécutions ou automatisations. **Event ID** est vide dans ces exemples : il n'est renseigné que sur les vrais événements. Un espace de travail vide affiche « No … found » — ce n'est pas une erreur. **Run Completed** reste vide tant qu'aucune de vos automatisations ne s'est exécutée au moins une fois. ![L'onglet Test d'un déclencheur Automation Status Changed avec trois exemples, Automation A, B et C, et le détail de l'un : ID, Name, Type, Provider, Agent ID, Agent Name, Status, Updated At, Automation ID, et Event ID vide](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/zapier/test-trigger.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=23eb9454a456a73b72fb4d8c290bf269) Test trigger sur Automation Status Changed : vos trois automatisations les plus récentes en exemples, Event ID vide ## Comment fonctionnent les déclencheurs instantanés Quand vous **publiez** un Zap, Zapier s'inscrit auprès d'Agentova pour être prévenu de cet événement. Quand vous désactivez ou supprimez le Zap, cette inscription est retirée. Vous n'avez rien à gérer. * **Notifications signées.** Chaque notification est signée par Agentova. L'application vérifie la signature, et ignore une notification non signée, falsifiée, ou signée il y a plus d'une heure. Une notification ignorée apparaît comme **Halted** dans l'historique du Zap. * **Pas de doublons.** Après un problème réseau, Agentova peut renvoyer le même événement. L'application reconnaît un événement déjà livré à ce Zap au cours des 48 dernières heures, et arrête cette exécution (**Halted**, « Ignored a repeated delivery… ») : votre Zap ne s'exécute pas deux fois. * **Pas d'ordre garanti.** Deux événements peuvent atteindre votre Zap dans n'importe quel ordre. Pour connaître le dernier statut d'une automatisation, comparez **Updated At**. * **Pendant une coupure de l'API Agentova.** Agentova peut couper son API pendant un temps. Les événements survenus pendant une telle coupure ne sont jamais livrés à votre Zap. * **Après une longue panne.** Si Zapier est injoignable, Agentova fait jusqu'à 8 tentatives de livraison pour chaque notification, sur environ 27 heures et demie. Dès que trois notifications de suite ont été abandonnées **et** que les livraisons échouent depuis au moins 72 heures, Agentova cesse de prévenir ce Zap et alerte les administrateurs de votre espace de travail. Pour reprendre, **désactivez puis réactivez le Zap**. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.