Suivi des clics de liens Pipedrive : des deals depuis les clics sur liens courts

Le suivi des clics de liens Pipedrive dans Elido transforme les paliers de liens courts en événements de pipeline. Quand l'un de vos liens franchit 100, 1 000 ou 10 000 clics, une tâche cron de 5 minutes crée un deal dans le pipeline Pipedrive que vous avez choisi, intitulé avec le slug du lien et le palier. Des notes de deal portant la source UTM et un lien profond vers Elido sont prévues. Pas de Zapier au milieu, pas d'export manuel, pas de rappel de calendrier pour vérifier les rapports de liens.

C'est l'essentiel. La mécanique compte davantage, donc cet article passe en revue les trois choses que les équipes d'opérations commerciales doivent vérifier avant d'activer ceci. D'abord, comment le flux de connexion fonctionne réellement : où vit le jeton API personnel, ce que lit le sélecteur de pipeline, et comment le jeton est stocké une fois collé. Ensuite, ce que fait la tâche cron de seuil à chaque exécution et comment elle évite de créer des deals en double quand un lien devient viral du jour au lendemain. Troisièmement, ce que vous pouvez et ne pouvez pas changer au-delà des trois seuils par défaut, et ce qui est prévu ensuite.

Pipedrive est passé en Live pour Elido le 22 mai 2026. Avant cela, il est resté en Bêta pendant deux semaines pendant que nous éliminions les cas limites autour des ID d'étape et de la rotation de jeton. Le code de l'intégration vit dans services/api-core/internal/integrations/pipedrive/ si vous vous auto-hébergez et voulez lire la source. Là où quelque chose ci-dessous est prévu plutôt que livré, l'article le dit.

Connecter Pipedrive en deux minutes

Ouvrez le catalogue d'intégrations dans votre espace de travail Elido et cliquez sur la carte Pipedrive. La fenêtre modale de connexion demande d'abord une chose : un jeton API personnel. Vous l'obtenez depuis votre compte Pipedrive en ouvrant le menu de profil, choisissant Préférences personnelles, puis l'onglet API. Le propre guide de Pipedrive sur comment trouver le jeton API personnel a le chemin exact avec des captures d'écran, car leur interface change à peu près chaque trimestre.

Collez le jeton. Elido fait deux choses en arrière-plan. Il valide le jeton en appelant GET /users/me contre l'API Pipedrive, ce qui confirme que le jeton est actif et nous indique à quelle entreprise Pipedrive il appartient. Il extrait aussi la liste des pipelines actifs de cette entreprise, donc l'étape suivante de la fenêtre modale affiche de vraies options, pas des champs de texte libre.

La fenêtre modale pose ensuite une dernière question : dans quel pipeline les nouveaux deals doivent-ils atterrir ? La liste déroulante est peuplée depuis vos données Pipedrive en direct. Si vous avez trois pipelines nommés Inbound, Outbound et Partners, vous voyez ces trois-là. Choisissez celui qui convient au travail, généralement Inbound pour les signaux orientés marketing, et cliquez sur Connecter. Les deals atterrissent sur la première étape de ce pipeline ; choisir une étape cible différente est prévu.

Ce qui arrive au jeton après la Connexion. Elido le chiffre avant qu'il ne touche Postgres, en utilisant un chiffrement d'enveloppe avec une clé de chiffrement de données par locataire enveloppée par une clé KMS d'espace de travail. Le blob enveloppé est ce qui repose dans la table integration_credentials. Le jeton en clair n'existe en mémoire que pendant la durée d'un seul appel API, et nous ne le journalisons jamais, même en verbosité debug. Si vous faites tourner le jeton dans Pipedrive, la prochaine exécution cron reçoit une erreur 401 et Elido marque l'intégration comme nécessitant une réauthentification, ce qui apparaît comme une bannière dans l'espace de travail, pas un échec silencieux. L'hygiène de rotation vous incombe, la casse est bruyante.

Le sélecteur de pipeline est un détail petit mais important. Un mode d'échec courant dans les intégrations CRM est de créer des deals dans le mauvais pipeline parce que l'intégration a été construite quand l'entreprise avait un pipeline et en a désormais six. Laisser l'utilisateur choisir à la Connexion, et afficher la liste actuelle plutôt qu'en mettre une en cache datant d'un mois, élimine toute cette catégorie d'erreurs. Vous pouvez aussi vous reconnecter à tout moment pour changer la cible du sélecteur sans perdre l'historique de seuil.

Ce que fait réellement la tâche cron de 5 minutes

À l'intérieur de services/api-core se trouve une tâche appelée click_threshold_hook. Elle s'exécute toutes les cinq minutes. À chaque exécution, elle fait trois choses dans l'ordre, par espace de travail ayant Pipedrive connecté.

D'abord, elle liste les liens actifs de l'espace de travail et lit le compteur de clics courant de chacun, le même compteur que le service de redirection incrémente à chaque clic. Les liens supprimés et inactifs sont ignorés.

Ensuite, elle compare le nouveau total de chaque lien aux seuils enregistrés. Les seuils par défaut sont 100, 1 000 et 10 000. Pour chaque lien, Elido enregistre chaque seuil ayant déjà produit un deal dans une ligne integration_pipedrive_deals indexée par espace de travail, lien et seuil. Si un lien était à 80 clics à la dernière exécution et est maintenant à 240, la comparaison montre que le seuil 100 a été franchi et que le 1 000 n'a pas encore été touché. Nous marquons 100 comme atteint et mettons en file une création de deal. Si un lien est passé de 80 à 1 200, les seuils 100 et 1 000 ont tous deux été franchis, donc nous mettons en file deux créations.

Troisièmement, pour chaque deal en file, Elido appelle l'API Deals de Pipedrive avec un POST vers /deals. Le corps définit l'ID de pipeline depuis le sélecteur de Connexion, nomme le deal Engagement : <slug> (<seuil> clics), et laisse la valeur à zéro. Écrire la source, le support et la campagne UTM dans une note de deal avec un lien retour vers la vue d'analyse Elido est prévu, tout comme stocker l'ID du lien dans un champ personnalisé Pipedrive.

Quelques choses que cette tâche cron ne fait pas. Elle ne retente pas dans une même exécution. Si Pipedrive renvoie une erreur, rien n'est enregistré pour ce seuil, donc l'exécution suivante retente simplement. La limite de débit de Pipedrive est en pratique de 100 requêtes par 2 secondes par jeton d'entreprise, ce qui laisse largement de la marge pour les volumes que la plupart des équipes rencontreront. Elle ne regarde aussi que les liens actifs, donc les liens supprimés ou inactifs ne créent jamais de deals.

La prévention des doublons repose sur cette table. Avant chaque création, la tâche cron vérifie une ligne existante (workspace_id, link_id, threshold_bucket), et l'insertion suivante est protégée par une contrainte d'unicité sur les trois mêmes colonnes, donc un crash et une nouvelle exécution ne produisent pas un second deal pour le même palier.

Aller au-delà des trois valeurs par défaut

Les seuils livrés sont 100, 1 000 et 10 000. La plupart des équipes les gardent parce qu'ils correspondent naturellement à un récit commercial. Cent clics, c'est un signal doux qui vaut un coup d'œil. Mille, c'est une campagne qui vaut un appel. Dix mille, c'est assez chaud pour qu'un commercial soit déjà en mouvement. Cela dit, vous pourriez vouloir des chiffres différents, et aujourd'hui vous ne pouvez pas les définir.

L'intégration Pipedrive d'Elido utilise les trois mêmes paliers pour chaque espace de travail, et il n'y a encore ni point d'entrée ni paramètre pour une liste de seuils personnalisée.

Des déclencheurs plus riches sont sur la feuille de route plutôt que livrés. Le plan d'intégration inclut un déclencheur de seuil cadré sur une campagne avec un UTM candidat-deal, et un déclencheur de conversion qui crée un deal portant la valeur de commande capturée. Les étapes cibles configurables par l'utilisateur et les champs personnalisés Pipedrive comme Deal Source ou Lead Channel sont aussi prévus pour la prochaine version. En attendant leur arrivée, si vous avez besoin d'un filtre UTM ou d'une agrégation par dossier, interrogez l'API d'analyse Elido depuis votre propre tâche et créez le deal via l'API de Pipedrive vous-même.

Où vit le jeton et comment le faire tourner

Une section courte parce qu'elle revient dans chaque revue de sécurité. Le jeton API personnel est chiffré au repos avec AES-256-GCM et une clé de chiffrement de données par locataire. La DEK est elle-même enveloppée par une clé de niveau espace de travail dans notre KMS, et seul le processus api-core peut la déballer. Il n'y a de jeton en clair dans aucun journal, aucune sauvegarde, ni aucune trace d'erreur. Nous avons testé cela avec une injection de panne qui forçait une erreur 401 de Pipedrive en cours de requête, et le chemin d'erreur nettoie le jeton de la réponse avant qu'elle n'atteigne Sentry.

Pour faire tourner : générez un nouveau jeton API personnel dans Pipedrive, révoquez l'ancien, puis collez le nouveau dans la fenêtre modale de Connexion Elido à nouveau. L'intégration valide le nouveau jeton, l'échange sur place, et la prochaine exécution cron l'utilise. Si vous oubliez de mettre à jour Elido après avoir révoqué l'ancien jeton, la prochaine exécution cron reçoit une erreur 401 et l'intégration passe en état Nécessite réauthentification, visible comme une bannière jaune sur le tableau de bord de l'espace de travail. Aucun jeton mort silencieux.

En auto-hébergement, le KMS est interchangeable : sur fichier par défaut, remplacez par HashiCorp Vault ou votre KMS cloud. L'ADR-0036 couvre la version longue.

Où cela s'intègre dans un entonnoir plus large

Les déclencheurs de deal Pipedrive depuis les clics sont une pièce d'un schéma plus large. Les comptes de clics sont un indicateur avancé, pas un chiffre de revenu, donc vous voulez généralement qu'ils affluent vers un CRM où vit le reste du contexte commercial. Le deal est le relais : le marketing a fait son travail, les ventes prennent le relais. À partir de là, vos workflows Pipedrive habituels prennent le dessus : assigner le deal à un commercial, le noter, le faire avancer dans les étapes, le conclure.

Si vous transmettez aussi des conversions vers des plateformes publicitaires, les mêmes données de clic alimentent les deux flux. La fonctionnalité de suivi des conversions gère le côté publicitaire, l'intégration Pipedrive gère le côté CRM, et les deux ne se disputent jamais le même événement. Nous voyons cette combinaison le plus souvent sur la page solution marketeurs, où toute la pile est acquisition payante vers liens de marque vers entonnoir CRM.

Pour les analystes qui veulent garder leurs chiffres honnêtes, deux articles antérieurs couvrent les préoccupations en amont. Analyses de liens courts : que mesurer couvre quelles métriques de clic corrèlent réellement avec le revenu, et Suivre les UTM de bout en bout couvre l'hygiène UTM qui rend les notes de deal utiles plutôt que bruyantes. Les deux se marient bien avec cette intégration, puisque le deal que Pipedrive crée n'est utile qu'à hauteur des données UTM qu'il porte.

Un dernier détail sur les plans. L'intégration Pipedrive est sur chaque niveau Elido payant, et l'essai de 14 jours l'inclut pour que vous puissiez prouver votre liste de seuils avant de vous inscrire. Les espaces de travail gratuits peuvent créer la connexion pour tester, mais la tâche cron ne se déclenche pas pour les liens gratuits. La page tarifs a le détail par niveau.

Liste de vérification de configuration

Imprimez ceci, faites-le une fois.

1. Dans Pipedrive : menu de profil, Préférences personnelles, onglet API, copiez le jeton.
2. Dans Elido : Intégrations, carte Pipedrive, Connecter.
3. Collez le jeton. Attendez la validation.
4. Choisissez le pipeline. Par défaut Inbound ; les deals atterrissent sur sa première étape.
5. Cliquez sur Connecter.
6. Attendez cinq minutes. Envoyez quelques clics de test. Observez l'arrivée du premier deal.

C'est tout. Si vous vous auto-hébergez, la tâche cron s'exécute à l'intérieur du processus api-core plutôt que comme une tâche séparée, et elle nécessite la connexion Redis et la clé maîtresse des secrets configurées ; sans l'une ou l'autre, elle s'interrompt silencieusement. Sur Elido Cloud, la tâche cron est gérée pour vous.