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

# Nœud Agentova

> Listez, consultez, activez et mettez en pause vos automatisations depuis un workflow

Ressource : **Automation**. Quatre opérations.

## List

Renvoie les automatisations de l'espace de travail, un élément (item) par automatisation.

| Option | Rôle |
| - | - |
| **Return All** | Récupère toutes les pages, 100 automatisations par requête. Désactivée : s'arrête à **Limit** (50 par défaut). |
| **Filters → Status** | `Active`, `Paused`, `Draft` ou `Error` |
| **Filters → Type** | Un type d'automatisation (voir ci-dessous) |
| **Filters → Agent ID** | Uniquement les automatisations d'un agent (`agt_…`) |

Chaque élément contient : `id`, `name`, `type`, `provider`, `agent_id`, `agent_name`, `status`, `updated_at`.

![Le nœud List automations dans n8n : identifiant, ressource Automation, opération List, limite 50, et en sortie quatre automatisations avec leur identifiant et leur nom](https://mintcdn.com/agentova-2c667f5d/Xl6jEAYNYyd4kO2m/images/n8n/list-automations.jpg?fit=max\&auto=format\&n=Xl6jEAYNYyd4kO2m\&q=85\&s=b2031cdd7c388bef4d5c3d0a8d9bce98)

List lancé depuis un déclencheur manuel : une ligne par automatisation

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

## Get

Renvoie une automatisation. Choisissez-la dans le champ **Automation** :

* **From List** : une liste de vos automatisations, avec recherche — tapez une partie du nom.
* **ID** : collez un identifiant (`aut_…`), ou récupérez-le d'un nœud précédent avec une expression comme `{{ $json.id }}`.

Les noms d'automatisation, en anglais, se lisent « *ce que fait l'automatisation* — *nom de l'agent* », par exemple « Comment replies — Support Agent », « Email replies — Support Agent » ou, pour une source CRM, « HubSpot contacts — Support Agent ». Un même agent sur deux canaux donne deux automatisations portant le même nom : quand deux lignes se ressemblent dans **From List**, utilisez le mode **ID**.

## Activate et Pause

Passent une automatisation à `active` ou à `paused`. Le champ **Automation** fonctionne comme dans **Get**. Le nœud renvoie l'automatisation avec son statut après le changement.

Si Agentova ne parvient pas à relancer l'automatisation — par exemple une source CRM dont la connexion ne peut pas être rétablie — l'automatisation passe en `error`, et **Activate** échoue avec « Automation “…” could not be resumed, now in error » au lieu d'annoncer un succès.

Mettre en pause et réactiver peuvent **se répéter sans risque** : mettre en pause une automatisation déjà en pause, ou activer une automatisation déjà active, la renvoie inchangée — pas d'erreur, et pas de nouvel événement de statut.

L'API répond en **8 secondes** au plus. Quand la réactivation prend plus de temps — pour reconnecter une boîte mail, par exemple — la réponse indique le statut à cet instant, et le statut final arrive sous forme d'événement **Statut d'automatisation modifié** : `active`, ou `error` si le canal n'a pas pu être reconnecté.

Rien de ce qui arrive pendant une pause n'est rattrapé ensuite, sauf pour Customer.io après une courte pause :

| Canal | Pendant la pause | À la réactivation |
| - | - | - |
| E-mails (Gmail, Outlook, IMAP) | Agentova cesse d'écouter la boîte mail — sauf si un autre agent actif utilise la même boîte. Les e-mails reçus pendant la pause **ne reçoivent aucune réponse**. | La boîte mail est reconnectée. Seuls les e-mails qui arrivent à partir de ce moment sont traités. |
| Messages privés (Facebook, Instagram, WhatsApp), commentaires, stories | Ce qui arrive est ignoré | Les nouveaux messages, commentaires et réponses aux stories sont de nouveau traités |
| Lead Ads | Les leads sont toujours enregistrés dans Agentova et annoncés par **Lead créé** ; seules les actions de l'automatisation (message, e-mail, appel…) sont sautées | Les actions reprennent pour les nouveaux leads ; celles qui ont été sautées ne sont pas exécutées après coup |
| Sources CRM | Agentova cesse de réagir au CRM | Les événements survenus pendant la pause ne sont pas rejoués |
| Customer.io | Agentova cesse de lire le segment (il le lit d'habitude toutes les 15 minutes) | Après une pause de plus de 6 heures, les changements du segment survenus pendant la pause ne sont jamais traités ; après une pause plus courte, ils peuvent l'être à la réactivation |

Seules les automatisations `active` et `paused` peuvent être basculées. Une automatisation `draft` ou `error` est refusée (`422 automation_not_controllable`) : corrigez-la d'abord dans l'application Agentova.

Une boîte mail ne peut être utilisée que par un seul agent actif, comme dans l'application Agentova : réactiver une automatisation d'e-mails dont la boîte est déjà utilisée par un autre agent actif est refusé aussi (`422 automation_not_controllable`, avec `details.reason: account_in_use`). Détachez d'abord la boîte mail de l'autre agent dans l'application Agentova.

## L'utiliser comme outil d'un agent IA

Le nœud Agentova peut être branché comme **outil** (tool) sur le nœud **AI Agent** de n8n. L'agent peut alors lister vos automatisations, en consulter une, et la mettre en pause ou la réactiver quand vous le lui demandez en langage courant — par exemple « mets en pause les réponses aux commentaires ». Il ne planifie rien de lui-même : réactivez plus tard en le lui redemandant, ou avec un workflow planifié.

> [!WARNING]
>
> Un agent IA doté de cet outil peut mettre en pause n'importe quelle automatisation de l'espace de travail. Donnez-lui un message système (system message) clair sur ce qu'il peut faire et ce qu'il ne doit pas faire.

## Erreurs

Le nœud choisit son message d'après le `code` d'erreur renvoyé par Agentova :

| Message dans n8n | Pourquoi | Que faire |
| - | - | - |
| « Automation not found » | L'automatisation a été supprimée ou désactivée dans Agentova, son compte a été déconnecté, ou elle appartient à un autre espace de travail | Choisissez à nouveau l'automatisation avec **From List** |
| « This automation cannot be controlled through the API » | L'automatisation est en `draft` ou en `error` | Corrigez-la d'abord dans l'application Agentova |
| « This mailbox is already used by another active Agentova agent » | **Activate** sur une automatisation e-mail dont la boîte mail est déjà utilisée par un autre agent actif : une boîte mail ne peut servir qu'à un seul agent actif | Détachez la boîte mail de l'autre agent dans l'application Agentova, puis réessayez |
| « Invalid or revoked Agentova API key » | La clé a été révoquée ou est fausse | Mettez à jour l'identifiant |
| « This Agentova workspace has no access to the API » | L'abonnement de l'espace de travail est impayé, en pause ou incomplet | Vérifiez **Paramètres → Abonnement** (votre formule) ou **Paramètres → Facturation** (moyen de paiement, factures) |
| « Agentova rate limit reached, retry in … s » | Plus d'environ 100 requêtes par minute avec cette clé, tous workflows confondus | Ralentissez le workflow (nœud Wait, lots plus petits) |
| « Agentova API route not found » | La Base URL de l'identifiant est fausse | Remettez `https://core-api.agentova.ai/v1` |
| « Agentova internal error » | Un problème temporaire côté Agentova | Réessayez plus tard ; [contactez le support](https://docs.agentova.ai/support.md) si le problème persiste |
| « The Agentova API is temporarily unavailable » | Agentova a coupé son API pour un temps | Réessayez plus tard |

Pour que le workflow continue quand un élément échoue, activez le réglage **On Error → Continue** du nœud.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.