Outils & intégrations8 min environ

Connecter deux logiciels : que vérifier avant de demander une intégration API ?

Avant de demander une intégration API, vérifiez que le logiciel de départ permet de lire les données nécessaires et que celui d’arrivée permet l’action attendue. Il faut ensuite confirmer les accès, les formats, la fréquence et le traitement des erreurs. La présence d’une API sur chaque outil ne suffit pas.

Un ordinateur et une tablette avec des interfaces fictives ; un carnet sert à vérifier la correspondance des données.
Illustration conceptuelle générée avec l’IA : vérifier les échanges entre deux logiciels fictifs. Aucune capture de logiciel réel.

Un ordinateur et une tablette avec des interfaces fictives ; un carnet sert à vérifier la correspondance des données.

Une équipe recopie des informations d’un logiciel dans un autre. La demande paraît simple : connecter les deux. Pourtant, « transférer un dossier validé », « synchroniser tous les dossiers » et « garder les deux outils identiques » sont trois périmètres différents.

Une API est une interface qui permet à un programme d’effectuer certaines opérations dans un autre logiciel. Les opérations autorisées, les données exposées et les conditions d’accès sont propres à chaque éditeur. Le bon point de départ est donc une action métier précise, accompagnée de preuves techniques.

Décrivez un échange avant de connecter deux outils

Écrivez le déclencheur, l’information à transmettre et le résultat attendu. Précisez aussi ce qui reste manuel. Un premier échange limité permet de vérifier la faisabilité sans supposer que tous les objets des deux logiciels peuvent être synchronisés.

Exemple fictif : lorsqu’un dossier d’intervention est approuvé dans un outil de suivi, une tâche doit être créée dans le planning de l’équipe. Le numéro du dossier, le site concerné, la date souhaitée et le responsable sont transmis. La planification effective reste confirmée par l’équipe.

Dans ce scénario, le planning ne renvoie pas automatiquement chaque modification vers l’outil de suivi. Ajouter ce retour serait une décision distincte : il faudrait choisir quelle application fait autorité sur chaque donnée et comment traiter des modifications concurrentes.

  • Départ : quel logiciel et quel objet ?
  • Déclencheur : quelle action ou quel état lance le transfert ?
  • Arrivée : quelle création ou mise à jour doit être réalisée ?
  • Rythme : quel délai est réellement acceptable ?
  • Responsable : qui vérifie les cas qui ne peuvent pas être traités automatiquement ?

Demandez une preuve pour chaque opération

Pour chaque logiciel, demandez le lien vers la documentation officielle, la version concernée et les conditions d’accès applicables à votre abonnement. Repérez ensuite l’opération exacte : consulter un dossier, détecter sa modification, créer une tâche ou modifier son responsable. Une API qui permet seulement de consulter des informations ne permet pas forcément de les modifier.

Un logo dans un catalogue de connecteurs constitue un point de départ. Vérifiez les déclencheurs, actions et champs réellement pris en charge, puis faites un essai avec des données fictives. Si une action essentielle manque, le connecteur ne répond pas encore au besoin, même si les deux marques figurent dans sa liste.

Conservez la preuve et sa date dans votre fiche de faisabilité. Une confirmation commerciale générale comme « nous avons une API » doit être précisée par l’éditeur ou par un test de l’opération attendue. Tant que cette information manque, le point reste à confirmer.

  • Documenter l’édition ou l’abonnement du logiciel et la version de l’API.
  • Identifier une opération de lecture côté source et l’action nécessaire côté destination.
  • Vérifier les objets, pièces jointes et champs spécifiques effectivement exposés.
  • Demander un environnement d’essai ou convenir d’un test isolé avec des données fictives.

Distinguez un accès valide des bons droits

Une connexion peut être autorisée et ne pas disposer du droit de modifier l’objet voulu. Les permissions accordées à l’intégration doivent donc correspondre aux opérations prévues. Le RFC 9700 recommande de limiter les privilèges d’un jeton d’accès au besoin de l’application.

Demandez qui possède la connexion, qui peut la révoquer et comment elle reste maintenue si une personne quitte l’équipe. Les secrets de connexion ne doivent pas être copiés dans un brief, une capture ou un article. Faites prévoir un mode de transmission et de stockage adapté avec le prestataire.

Le mécanisme dépend du fournisseur. HubSpot documente notamment OAuth et les jetons statiques selon le type d’application, ainsi que la gestion de l’expiration. Ce sont des règles propres à cette plateforme, pas un modèle à imposer à tous les outils. La documentation du logiciel choisi reste la référence.

Vérifiez que les données veulent dire la même chose

Reprenez le scénario fictif de l’intervention. « Date » peut désigner une date demandée dans le premier outil et une réservation ferme dans le second. Copier la valeur sans cette distinction pourrait créer une tâche avec un engagement que personne n’a validé.

Préparez une correspondance champ par champ : nom à la source, sens métier, format, destination, transformation éventuelle et comportement si la valeur manque. Choisissez également un identifiant stable pour relier les deux objets. Deux personnes portant le même nom ou deux dossiers au titre identique ne doivent pas être considérés automatiquement comme un seul.

Avant d’étendre le périmètre, essayez une création, une modification et un cas incomplet. Vérifiez les valeurs dans l’outil d’arrivée, pas uniquement le message de réussite du connecteur. Pour le cas particulier des demandes entrantes, le guide Formulaire de contact et CRM détaille la distinction entre personne, demande et répétition technique.

  • Identifiant du dossier : référence conservée pour retrouver le lien entre les deux outils.
  • Date souhaitée : information à confirmer, sans création automatique d’une réservation ferme dans cet exemple.
  • Responsable : correspondance explicite avec un utilisateur autorisé dans le planning.
  • Champ absent : mise en attente avec une raison compréhensible, plutôt qu’une valeur inventée.

Fixez le délai utile et vérifiez les limites

Le besoin n’est pas toujours une mise à jour immédiate. Faites préciser le délai acceptable et le volume observé en fonctionnement habituel, lors des pics et lors d’une reprise de l’historique. Ce sont des données à relever dans votre activité, pas des chiffres à supposer.

Un webhook permet à un service de signaler un événement ; une interrogation périodique consiste à vérifier régulièrement ce qui a changé. Le choix dépend des fonctions disponibles et du délai utile. Si le fournisseur n’expose ni l’événement nécessaire ni une manière fiable de retrouver les modifications, cette limite doit apparaître dans le périmètre.

Les quotas ne sont pas uniformes. HubSpot indique que les limites dépendent notamment du type d’application, de l’abonnement et de l’API utilisée ; certaines opérations ont leurs propres restrictions. Il faut donc lire les règles de l’opération retenue plutôt que reprendre un chiffre trouvé dans un comparatif.

Demandez aussi comment les demandes attendent quand la limite est atteinte, ce qui se passe après une interruption et qui reçoit l’alerte. Une reprise de plusieurs mois de données peut demander un traitement distinct du flux quotidien.

Ne validez pas seulement le cas qui fonctionne

Le test de faisabilité doit inclure les situations qui changent la décision : accès refusé, champ obligatoire absent, interruption puis reprise. Vous devez pouvoir déterminer si l’action a été réalisée, reste en attente ou nécessite une intervention.

Les garanties d’événements varient selon les éditeurs. Stripe précise, par exemple, que ses webhooks peuvent recevoir des événements répétés et que leur ordre de livraison n’est pas garanti. Cela ne permet pas de déduire le comportement d’un autre outil ; cela montre pourquoi ces règles doivent être lues et essayées.

Dans le scénario fictif, rejouer le même dossier ne doit pas créer une nouvelle tâche identique. Une correction utile doit, elle, être appliquée selon les règles convenues. Faites démontrer ces deux cas et la possibilité de suspendre la connexion sans perdre le suivi des éléments en attente.

Choisissez la solution avec quatre décisions

Cette grille est un outil de cadrage proposé par Nexis. Elle permet de distinguer un échange prêt à être prototypé, un point encore inconnu et une fonction indisponible. Aucun feu vert ne dispense d’un essai.

Un point inconnu appelle une preuve. Un point incompatible appelle une modification du besoin ou une autre solution. Cette distinction évite de lancer un développement sur la seule supposition que l’éditeur ouvrira l’accès plus tard.

  • 1. Un connecteur existant couvre-t-il exactement le déclencheur, l’action et les champs ? Si oui, tester ce parcours, les accès et la reprise avant de choisir.
  • 2. Sinon, les API autorisées couvrent-elles les opérations nécessaires des deux côtés ? Si oui, préparer un prototype limité avec une correspondance des données et des critères d’acceptation.
  • 3. Si une API manque, un import/export documenté et autorisé couvre-t-il un besoin périodique ? Si oui, évaluer un échange de fichiers contrôlé avec validation et suivi des erreurs.
  • 4. Si aucun mécanisme fiable et autorisé ne répond au besoin, conserver une étape manuelle, réduire le périmètre ou envisager un autre outil. Une automatisation de clics à l’écran ne constitue pas un remplacement équivalent sans évaluation séparée.

La fiche à transmettre avant un devis

Rassemblez les éléments ci-dessous dans un document. Chaque réponse doit être accompagnée d’une source : documentation de l’éditeur, confirmation écrite ou résultat d’essai. Notez « à vérifier » plutôt que de remplir une case par intuition.

Le prestataire peut alors distinguer la vérification de faisabilité, le développement et l’entretien. Faites apparaître les points non résolus, les limites connues, les accès à obtenir et les conditions qui changeraient le périmètre. Le guide Automatiser sans perdre le contrôle complète ce cadrage côté équipe.

Pour préparer une connexion avec Nexis, transmettez les noms des outils, le parcours souhaité et les liens vers leurs documentations, sans identifiants secrets. La page API et outils métier présente l’accompagnement adapté à ces échanges.

  • Les deux logiciels, leurs éditions, leurs versions et le propriétaire des accès.
  • Le déclencheur, l’action attendue, le délai utile et les volumes observés.
  • Les opérations officielles disponibles et les points encore inconnus.
  • Un échantillon fictif des champs et leur correspondance.
  • La règle de référence lorsque les données divergent.
  • Les critères d’essai, le suivi des erreurs et la procédure de suspension.
  • La personne chargée des accès, des alertes et de la maintenance.

Pour passer à l’action

  • L’action métier est définie sans ambiguïté.
  • Lecture et action d’arrivée sont disponibles et autorisées.
  • Les champs, formats et identifiants ont été essayés.
  • Le délai utile est compatible avec les limites documentées.
  • Les cas d’erreur et de reprise ont un résultat attendu.
  • Un responsable et une procédure de suspension sont prévus.

Questions fréquentes

Deux logiciels possèdent une API : peuvent-ils forcément être reliés ?

Pas nécessairement pour votre besoin. Vérifiez les opérations exposées, les champs, les droits, les formats et les limites des deux côtés. Une lecture possible dans un outil ne prouve pas que l’autre accepte l’action attendue.

Faut-il développer si un connecteur existe déjà ?

Commencez par vérifier ce que le connecteur prend réellement en charge et essayez votre scénario. S’il couvre le périmètre, les droits et la reprise, il peut convenir. Un développement se justifie par les besoins non couverts, pas par principe.

Une connexion API fonctionne-t-elle toujours en temps réel ?

Non. Le rythme dépend des capacités des outils, des événements disponibles, des quotas et du traitement prévu. Définissez le délai acceptable avant de choisir entre notifications d’événements et vérifications périodiques.

Que faire si un logiciel n’a pas d’API ?

Vérifiez les connecteurs proposés et les imports ou exports autorisés par l’éditeur. Un échange périodique de fichiers peut convenir à certains besoins. Sinon, réduire le périmètre ou conserver une étape manuelle peut être préférable à une solution fragile.

Quels éléments fournir sans transmettre ses mots de passe ?

Les noms et éditions des logiciels, la documentation publique, l’action attendue et des exemples fictifs de données suffisent pour un premier cadrage. Les accès nécessaires aux essais se préparent ensuite par un canal adapté avec les personnes autorisées.

Sources et lectures

Un projet en préparation ? Indiquez votre besoin et les outils déjà en place.

À lire ensuite

Tout le journal

Deux outils à relier ?

Indiquez les logiciels utilisés, les données à échanger et le fonctionnement attendu.