Les intégrations sont complexes. Les données passent de l'outil A à l'outil B, peuvent être transformées, peuvent être filtrées. Les erreurs sont faciles : un champ mal associé, un filtre trop strict, des types de données qui ne correspondent pas. De mauvaises données faussent les décisions qui suivent. Les tests et la validation garantissent que les intégrations fonctionnent bien avant qu'on s'y fie. Ce chapitre explique comment tester les intégrations et valider les données entre systèmes connectés.
Les types de tests d'intégration
Tests unitaires
Testez chaque composant séparément. Exemple : l'événement de conversion de vos statistiques contient-il tous les champs requis (user_id, conversion_type, timestamp) ? L'association des champs du CRM convertit-elle correctement « type_purchase » (statistiques) en « deal_closed » (CRM) ?
Tests d'intégration
Testez le flux de bout en bout. Exemple : déclenchez une conversion dans vos statistiques, puis vérifiez qu'elle apparaît dans le CRM dans le délai prévu, avec les bonnes données.
Tests de régression
Vérifiez que les changements ne cassent pas les fonctions existantes. Exemple : vous modifiez l'association des champs pour les adresses e-mail. Vérifiez qu'elle fonctionne toujours pour les numéros de téléphone.
Les contrôles de validation des données
Contrôles de volume : les conversions quotidiennes de vos statistiques doivent correspondre à celles du CRM (à 5 % près). Si elles divergent, enquêtez.
Contrôles de complétude : chaque événement doit avoir les champs requis. Si 10 % des événements n'ont pas de user_id, c'est un problème de qualité des données.
Contrôles de cohérence : si une conversion a l'e-mail jane@wemasy.com dans vos statistiques et jane.c@wemasy.com dans le CRM, c'est un écart. Enquêtez.
Contrôles de ponctualité : les conversions doivent apparaître dans le système de destination dans le délai prévu (temps réel ou quotidien). Si les données arrivent avec des heures de retard, l'intégration est peut-être lente.
Contrôles d'exactitude : vérifiez un échantillon de conversions de bout en bout. La conversion est-elle passée correctement de la source à la destination ? Les valeurs sont-elles exactes ?
Mettre en place un processus de test et de validation
Avant la mise en service : lancez les quatre types de tests sur des données d'exemple. Documentez les résultats. Obtenez la validation des deux équipes (statistiques et outil de destination). Créez des cas de test pour les futurs tests de régression.
Après la mise en service : rapprochement quotidien : comparez le volume, la complétude et la cohérence entre les systèmes. Analyse approfondie chaque semaine : vérifiez 10 à 20 conversions de bout en bout. Bilan mensuel : cherchez les dérives, les schémas et les anomalies.
En cas de problème : mettez l'intégration en pause si les données sont clairement fausses (par exemple, un pic de volume multiplié par 10). Enquêtez : qu'est-ce qui a changé ? Retestez avant de reprendre.
Problèmes d'intégration courants et solutions
Problème : des conversions dans vos statistiques mais pas dans le CRM. Cause : clé d'API expirée, droits modifiés, erreur de transformation. Solution : consultez les journaux, vérifiez la clé d'API, contrôlez l'association des champs.
Problème : écart de volume (statistiques = 100, CRM = 80). Cause : erreur de filtrage, le CRM applique une validation supplémentaire qui rejette certains événements. Solution : vérifiez les filtres du CRM, contrôlez que les types de champs correspondent, ajustez les règles de validation.
Problème : les données arrivent en retard (des heures au lieu du temps réel). Cause : l'intégration traite par lots au lieu d'un flux continu. Solution : vérifiez les paramètres de l'intégration, passez au flux continu si c'est possible.
Documentation et gouvernance
Documentez chaque intégration : source, destination, types de données, règles de transformation, latence attendue, responsable (qui répare en cas de panne). Rédigez un guide de dépannage : si l'intégration tombe en panne, dans quel ordre vérifier ? Qui contacter ?
Attribuez la responsabilité : une personne est responsable de chaque intégration. Elle surveille, teste et corrige les problèmes. Cela évite les situations où « personne ne sait ».
Comment tester une intégration avant la mise en service ?
Étape 1 : envoyez des données de test (conversion de test avec une fausse adresse e-mail, lead de test avec une entreprise de test). Étape 2 : vérifiez que les données de test apparaissent dans le système de destination dans le délai prévu. Étape 3 : contrôlez que tous les champs sont corrects (user_id, montant, date). Étape 4 : laissez tourner 24 à 48 heures pour vérifier la stabilité. Étape 5 : supprimez les données de test. Une fois les tests réussis, l'intégration est prête pour la production.
Que mettre dans une liste de contrôle des tests d'intégration ?
- [ ] Tous les champs requis présents, [ ] Types de données corrects (e-mail ou téléphone), [ ] Valeurs dans la plage attendue (prix > 0 $), [ ] Horodatages exacts, [ ] L'identifiant utilisateur est identique entre les systèmes, [ ] Aucun doublon, [ ] Volume conforme à la base (±5 %), [ ] Latence acceptable (dans le SLA), [ ] Gestion des erreurs opérationnelle (erreurs consignées, pas ignorées en silence), [ ] Demandes de suppression traitées. Adaptez à chaque intégration.
À quelle fréquence valider les données issues des intégrations ?
Chaque jour : rapprochez les volumes, vérifiez 10 enregistrements. Chaque semaine : analyse approfondie, test des cas limites. Chaque mois : examinez les tendances, cherchez les dérives. Chaque trimestre : audit complet, vérifiez que tous les cas de test passent toujours. Cela détecte les problèmes tôt. Si vous attendez le mois, les problèmes s'accumulent.
Quelle marge d'erreur est acceptable pour le rapprochement des données ?
Volume : ±5 % (de petits écarts de suivi sont normaux). Complétude : 98 % et plus (quelques champs manquants sont acceptables). Cohérence : < 1 % d'écarts (la plupart des données doivent correspondre). Si vous dépassez ces seuils, enquêtez. 2 à 3 % d'erreurs sont acceptables ; 10 % et plus indiquent une intégration défaillante.
Comment gérer les pannes d'intégration (l'intégration casse et cesse d'envoyer des données) ?
Tout de suite : mettez l'intégration en pause, prévenez les parties prenantes que les données ne sont plus à jour. Enquêtez : consultez les journaux, vérifiez les clés d'API, testez la connexion. Réparez : traitez la cause (clé expirée, droits manquants, erreur de code). Reprenez : testez de nouveau, surveillez de près pendant 24 heures. Bilan : pourquoi cela a-t-il cassé ? Comment l'éviter ? Ajoutez de la surveillance et des alertes.
Puis-je automatiser les tests d'intégration ?
Oui. Utilisez des outils de validation des données pour lancer chaque jour des contrôles automatiques. Mettez en place des alertes : si le volume diverge de >5 %, alertez l'ingénieur. Si la complétude est < 98 %, alertez. Automatisez les contrôles de volume et de complétude ; vérifiez l'exactitude à la main (plus difficile à automatiser). La plupart des entreprises combinent contrôles automatiques et revue manuelle.