Connecter Cuevr à d’autres outils

Comprendre le périmètre

Cuevr se connecte à vos outils par une API v1 et des webhooks, utilisables notamment depuis Make, n8n ou Zapier. Dans un sens, Cuevr prévient votre outil à chaque moment clé d’une proposition ; dans l’autre, votre outil agit sur Cuevr avec une clé d’accès : créer un client ou une proposition depuis un deal, clore ou rouvrir le deal, lire la qualification.

Les fonctions de gestion se trouvent dans Admin, onglet Organisation, carte Intégrations, avec un rôle propriétaire ou administrateur. Un membre voit la carte, mais ne peut ni créer de clé ni ajouter de destination.

Créer et gérer une clé d’accès

1. Dans Clés d’accès, cliquez sur Créer une clé d’accès et donnez-lui un nom explicite.
2. Dans Ce que la clé peut faire, choisissez les droits nécessaires à votre flux. Tout ce qu’il faut pour Make ou n8n coche tous les droits, Rien les décoche.
3. Cliquez sur Créer la clé, puis copiez-la lorsqu’elle est affichée : elle ne sera montrée qu’une fois.
4. Testez la connexion avec la route de vérification de la clé.
5. Pour remplacer une clé, utilisez Renouveler la clé dans le menu « … » de sa ligne : Cuevr crée une nouvelle clé avec les mêmes droits, et l’ancienne continue de fonctionner pendant le délai indiqué dans la fenêtre de confirmation, le temps de la remplacer dans votre scénario.
6. Révoquez la clé avec Révoquer la clé lorsqu’elle n’est plus utilisée ou si elle a fuité : elle cesse de fonctionner immédiatement.

La clé commence par cuevr_. Pour recevoir une famille d’événements, la clé qui abonne une destination doit aussi disposer du droit de lecture de cette famille. Lorsqu’un membre quitte l’organisation, ou n’est plus administrateur, les clés qu’il a créées sont révoquées.

Ajouter et gérer une destination webhook

1. Cliquez sur Ajouter une destination, collez l’Adresse fournie par votre scénario et, si vous le souhaitez, un libellé.
2. Dans Ce que Cuevr envoie, sélectionnez les événements utiles.
3. Cochez Inclure les données du lecteur seulement si votre outil doit recevoir l’e-mail et le nom du prospect.
4. Cliquez sur Ajouter la destination, puis copiez le secret de signature : il ne sera montré qu’une fois.
5. Lancez Envoyer un test depuis le menu « … » de la destination ; l’événement technique est cuevr.ping.
6. Suivez le Journal des envois. En cas d’erreur, corrigez le récepteur, retestez puis utilisez Réactiver si la destination a été éteinte.

L’organisation peut avoir jusqu’à 10 destinations. Le délai de réponse est de 10 secondes. Seul un statut HTTP 2xx signifie livré. Les URL doivent être en HTTPS. En cas d’échec, Cuevr réessaie plusieurs fois à intervalles croissants, puis éteint la destination après des échecs répétés ; la cause s’affiche sous son nom. Les événements survenus pendant qu’une destination est éteinte ne sont pas rattrapés à sa réactivation. Un test raté ne compte pas contre la destination. Le journal des envois est conservé 30 jours.

Le menu « … » propose aussi Modifier, Éteindre et Supprimer. Lorsqu’un membre quitte l’organisation, les destinations qu’il a créées sont éteintes ; vous pouvez les réactiver.

Vérifier la signature des envois

Cuevr signe chaque envoi dans l’en-tête X-Cuevr-Signature : une signature HMAC-SHA256 du timestamp (en-tête X-Cuevr-Timestamp) et du corps, calculée avec le secret de la destination. Faites vérifier cette signature par votre outil récepteur avant de traiter un envoi.

Renouveler le secret, dans le menu « … » de la destination, crée un nouveau secret. Pendant le délai indiqué, chaque envoi est signé avec les deux : le nouveau dans X-Cuevr-Signature, l’ancien dans X-Cuevr-Signature-Previous. Collez le nouveau secret dans votre scénario avant la fin de ce délai.

Les vingt et un événements disponibles

Quinze événements sont cochés d’office à la création d’une destination :

Six événements ne partent que vers les destinations qui les cochent :

Une signature n’écrit pas, à elle seule, une issue commerciale. Il faut donc traiter séparément les événements de signature et de changement d’issue.

Ce que l’API permet de synchroniser

Les routes couvrent la vérification de clé et le catalogue d’événements, la consultation et la gestion des clients, la consultation et la création des propositions depuis un deal, la clôture et la réouverture du deal, la lecture de la qualification, ainsi que la gestion, les tests et les journaux des webhooks. Publication et signature restent des gestes faits dans Cuevr.

Lors d’une création depuis un CRM, les notes du deal sont conservées telles quelles en tête de la qualification et la langue indiquée est conservée. Le couple source externe + identifiant externe permet de rejouer les créations sans créer un nouveau dossier à chaque tentative. L’e-mail du propriétaire venant du CRM doit correspondre à un membre de l’organisation. Pendant l’essai, une proposition créée par l’API compte dans les propositions d’essai de ce membre.

Avec un abonnement inactif, l’accès devient en lecture seule, avec exceptions prévues pour éteindre ou supprimer une destination et révoquer une clé. Les droits de la clé et ceux du membre restent déterminants.