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. La connecter dans Zapier

1

Accepter l'invitation (tant que l'application est sur invitation)

Ouvrez le lien d’invitation qu’Agentova vous a envoyé, en étant connecté au compte Zapier que vous allez utiliser, et acceptez-la. Sans cette étape, l’application Agentova n’apparaît pas dans l’éditeur de Zap. Une fois l’application publique, passez cette étape.
2

Ajouter une étape Agentova à un Zap

Dans l’éditeur de Zap, ajoutez un déclencheur ou une action et cherchez Agentova. Choisissez l’événement voulu.
Le panneau d'une étape Zapier avec l'application Agentova, la liste des déclencheurs Automation Status Changed, New Lead et Run Completed marqués Instant, et le bouton Sign in du compte

L'application Agentova dans l'éditeur de Zap : ses trois déclencheurs instantanés et le bouton Sign in

3

Se connecter

Cliquez sur Sign in (ou Connect a new account) et collez votre clé dans le champ API key.
4

Vérifier la connexion

Zapier teste la clé immédiatement. Quand elle fonctionne, le compte est nommé d’après le début de sa clé — par exemple Key agk_live_a1b2… — le même début qu’Agentova affiche dans Paramètres → API. C’est ainsi que vous savez quelle clé utilise chaque compte Zapier, par exemple avant d’en révoquer une.
Le panneau d'une étape Zapier dont le compte connecté s'appelle Key agk_live_a1b2…

Le compte connecté, nommé d'après le début de sa clé

Paramètres → API avec deux clés, Zapier et n8n, dont seul le début est affiché (agk_live_a1b2), et l'adresse de l'API

Paramètres → API affiche le début de chaque clé : celui-là même que Zapier utilise pour nommer le compte connecté

Une clé = un espace de travail. Pour travailler avec plusieurs espaces de travail Agentova, connectez un compte par espace de travail, chacun avec sa propre clé.

​
Si la connexion échoue

​
Quand vous révoquez une clé

Les actions et recherches Agentova qui utilisent la clé s’arrêtent : Zapier marque le compte comme expiré, vous prévient par e-mail, et met en attente les exécutions de ces Zaps jusqu’à ce que vous reconnectiez le compte avec une nouvelle clé. Les déclencheurs Agentova dépendent 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) : les inscriptions des Zaps sont supprimées avec la clé, et leurs déclencheurs ne reçoivent plus d’événements. Une fois le compte reconnecté avec une nouvelle clé, désactivez puis réactivez chaque Zap pour qu’il s’inscrive de nouveau.
  • Case décochée : les déclencheurs continuent de recevoir les événements, tant que l’administrateur qui a créé l’ancienne clé reste administrateur de l’espace de travail. Pour ne plus en dépendre, désactivez puis réactivez chaque Zap une fois le compte reconnecté avec la nouvelle clé. Pour les arrêter plus tard, désactivez leurs Zaps, ou supprimez leurs abonnements dans le tableau Abonnements webhook de Paramètres → API.
Voir Révoquer une clé.