Passer au contenu principal

​
1. Créer une clé API dans Agentova

1

Ouvrir Paramètres → API dans Agentova

Dans Agentova, cliquez sur le nom de votre espace de travail, en haut de la barre latérale, puis sur Paramètres. Choisissez ensuite API, dans la section ESPACE DE TRAVAIL. Vous devez être administrateur de l’espace de travail : les autres membres peuvent ouvrir la page, mais pas créer ni révoquer de clé.
Paramètres → API dans Agentova, avant la création de toute clé

Paramètres → API, avant la première clé

2

Créer une clé et la copier aussitôt

Cliquez sur Créer une clé, donnez-lui un nom qui dit où elle sert, par exemple « Zapier — équipe marketing », et confirmez avec Créer la clé. La clé ressemble à agk_live_… et n’est affichée qu’une seule fois : copiez-la, puis fermez la fenêtre avec J’ai copié ma clé.
La fenêtre Créer une clé API, avec le nom de la clé renseigné

Nommez la clé d'après l'outil qui va l'utiliser

La fenêtre Votre nouvelle clé API, avec le bouton de copie à côté de la clé

La clé n'est affichée qu'une fois : copiez-la avec le bouton de droite (masquée ici)

3

La garder secrète

Une clé donne accès à tout l’espace de travail : lister ses automatisations, les mettre en pause et les réactiver, lire ses leads et ses exécutions, gérer ses abonnements webhook. Tous les administrateurs de l’espace de travail sont prévenus quand une clé est créée. Vous pouvez avoir jusqu’à 10 clés actives ; révoquez celles qui ne servent plus.
Une clé révoquée cesse de fonctionner immédiatement, partout où elle est utilisée. Par défaut, les abonnements webhook créés avec elle sont supprimés en même temps : les déclencheurs qui en dépendent ne reçoivent plus d’événements — voir Sécurité.

​
2. Créer l’identifiant dans n8n

1

Credentials → Add credential → Agentova API

2

Remplissez les deux champs

L'encadré Brancher Zapier ou n8n, avec l'adresse de l'API et son bouton de copie

L'adresse de l'API, prête à copier

3

Enregistrez (Save)

n8n teste la clé aussitôt. Le message Connection tested successfully signifie que tout est prêt.
L'identifiant Agentova account dans n8n, avec le message Connection tested successfully, la clé masquée et la Base URL

L'identifiant enregistré : n8n a testé la clé avec succès

Une clé = un espace de travail. Pour plusieurs espaces de travail, créez un identifiant par espace et choisissez le bon dans chaque nœud.

​
Si le test échoue

​
Quand vous révoquez une clé

Le nœud Agentova s’arrête aussitôt dans tous les workflows qui utilisent l’identifiant : chaque opération échoue avec « Invalid or revoked Agentova API key » tant que vous n’avez pas mis à jour l’identifiant avec une nouvelle clé. Pour un Agentova Trigger actif, tout dépend de la case cochée par défaut dans la fenêtre Révoquer cette clé ?, qui supprime les abonnements webhook créés avec la clé :
  • Case cochée (par défaut) : l’abonnement du déclencheur est supprimé avec la clé, et le déclencheur ne reçoit plus d’événements. Mettez à jour l’identifiant avec une nouvelle clé, puis désactivez et réactivez le workflow : le déclencheur se réenregistre.
  • Case décochée : le déclencheur continue de recevoir des événements. Pour l’arrêter, mettez à jour l’identifiant avec une nouvelle clé, puis désactivez le workflow — ou supprimez son abonnement dans le tableau Abonnements webhook de Paramètres → API.
Voir la révocation d’une clé dans la page Sécurité.