Pour connecter deux logiciels, une intégration API n’est pas toujours le seul choix. Un fichier CSV peut suffire à une reprise ponctuelle. Un webhook peut transmettre un événement lorsqu’un changement se produit. Une API permet de consulter ou de modifier des données selon les fonctions prévues par l’éditeur.

Ces mécanismes peuvent se compléter. Le bon choix dépend du délai acceptable, des données échangées et du comportement attendu en cas d’échec. Avant de demander « quelle connexion faut-il développer ? », décrivez ce que les deux équipes doivent pouvoir faire.

API : consulter ou modifier une donnée à la demande

Une API fournit une interface prévue pour des échanges entre applications. Votre système peut, par exemple, rechercher un client, récupérer un statut ou créer un dossier, si ces opérations sont disponibles et autorisées.

Un accès API ne signifie pas que toutes les fonctions du logiciel sont exposées. Vérifiez les opérations disponibles, les droits, la pagination, les limites d’usage et les conditions d’accès de l’abonnement concerné. La documentation de l’éditeur compte davantage qu’une mention générale « compatible API ».

Exemple illustratif : votre application métier doit afficher le statut commercial d’un dossier. Elle peut interroger le CRM lors de l’ouverture de la fiche, ou conserver une copie synchronisée. Le premier choix dépend directement de la disponibilité du CRM ; le second exige de rendre visible l’âge de la donnée.

Webhook : recevoir une notification d’événement

Un webhook permet à un logiciel d’appeler un point de réception lorsqu’un événement se produit. L’application source peut signaler qu’une commande a changé de statut, puis le système destinataire consulte les informations dont il a besoin.

Une notification ne garantit pas un traitement unique ni un ordre universel d’arrivée. Ces propriétés doivent être vérifiées pour chaque fournisseur. Stripe documente, par exemple, les événements reçus en double et recommande de reconnaître ceux déjà traités. Cette règle concerne son service ; il faut examiner séparément les garanties de vos autres outils. Voir la documentation des webhooks Stripe.

Le destinataire doit aussi vérifier l’origine de la notification avec le mécanisme prévu par le fournisseur. L’adresse du point de réception ne constitue pas, à elle seule, une preuve d’authenticité.

CSV : échanger un ensemble de données par lot

Un fichier CSV peut convenir à une migration initiale, un rapprochement périodique ou un logiciel qui ne propose pas d’API adaptée. Il reste utile lorsqu’un humain doit contrôler le lot avant import.

Le contrat d’échange doit préciser les colonnes, les identifiants, les formats de date et les valeurs acceptées. Il faut aussi décider ce que signifie une ligne absente : donnée inchangée, suppression ou information non fournie ? Sans cette règle, deux fichiers apparemment compatibles peuvent produire des résultats très différents.

Préservez les identifiants et distinguez une valeur vide d’un zéro. Avant l’import, vérifiez le nombre de lignes, les doublons et les champs requis. Conservez un compte rendu des lignes acceptées et rejetées pour permettre une correction ciblée.

Choisir selon le besoin de fraîcheur

Pour une reprise ponctuelle, commencez par un export contrôlé. Pour un tableau de bord consulté chaque semaine, un échange périodique peut être suffisant. Pour préparer une action à l’arrivée d’une demande, un événement peut réduire l’attente, si le logiciel source le permet.

Le temps réel n’est pas une exigence par défaut. Il ajoute des situations de panne et de concurrence à gérer. Demandez plutôt : combien de temps une donnée peut-elle rester ancienne avant d’empêcher une décision ou de provoquer une erreur ?

Une combinaison utile peut associer un export initial, des notifications pour les changements et une vérification périodique pour retrouver les écarts. Cette dernière évite de dépendre entièrement de la bonne réception de chaque événement.

Donner une source de référence à chaque information

Si les coordonnées sont modifiées dans le CRM et dans l’application métier, il faut définir laquelle fait référence, ou établir une règle explicite de rapprochement. La dernière écriture reçue ne représente pas toujours la décision la plus récente.

Séparez les données partagées des données propres à chaque outil. Le CRM peut conserver le responsable commercial, tandis que l’application porte le statut opérationnel. Une automatisation CRM gagne souvent en simplicité lorsqu’elle évite une synchronisation bidirectionnelle inutile.

La fiche à préparer avant une intégration

  • Quelle application fournit chaque donnée et laquelle la reçoit ?
  • Quel événement déclenche l’échange, ou à quelle fréquence a-t-il lieu ?
  • Quel identifiant rapproche les enregistrements ?
  • Qui peut modifier les champs partagés ?
  • Comment détecter une opération en double ?
  • Que fait l’équipe lorsqu’une connexion échoue ?
  • Comment vérifier que les deux systèmes restent cohérents ?

Cette fiche permet de cadrer une intégration API et d’en comparer les solutions. Si vous utilisez n8n pour orchestrer ces échanges, notre article sur la fiabilité des workflows en production complète les questions de reprise et de surveillance.