Agentova Trigger

​

Choisir les événements

Dans Events, cochez un ou plusieurs événements : Lead Created, Run Completed, Automation Status Changed. 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.

​

Contenu de chaque événement

Chaque exécution du workflow reçoit un élément (item) contenant l’enveloppe de l’événement :

​

Lead créé

Un lead est créé — et Lead créé se produit — depuis cinq endroits : 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

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.

​

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.

​

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).