Votre formulaire crée une demande dans le CRM, puis votre gestion déclenche une facture. Ce type de liaison peut supprimer des ressaisies. Sa qualité se voit surtout lorsqu’un message arrive deux fois, qu’un fournisseur répond lentement ou qu’une opération échoue au milieu du parcours.
API et webhook : deux façons de communiquer
Une API permet à un logiciel de demander une information ou une action à un autre. Un webhook permet à un service de notifier un événement à une adresse prévue pour le recevoir. La documentation Stripe présente ce fonctionnement pour ses propres événements et décrit les contraintes de leur réception 2. Les modalités exactes dépendent du fournisseur.
La première question : qui peut faire quoi ?
Un accès technique doit être limité au besoin. Il faut vérifier le droit de lire ou modifier chaque ressource, et éviter de transmettre des informations inutiles. Les risques d’autorisation et d’exposition de données figurent dans les travaux OWASP sur les API 1.
Pour une réception de webhook, utilisez les mécanismes de vérification prévus par le fournisseur, notamment sa signature lorsque disponible. Prévoyez les notifications répétées et leur traitement sans duplication indésirable 2.
Le contrat de fonctionnement à écrire
Notre proposition : pour chaque intégration, définissez la donnée source, l’événement attendu, l’identifiant de suivi et le résultat visible pour l’utilisateur. Précisez ce qui doit se passer après une erreur et qui peut relancer.
Exemple fictif : un événement de commande est reçu deux fois. La facture ne doit pas être créée deux fois. L’équipe doit conserver assez d’informations pour reconnaître l’opération et confirmer son résultat, sans accumuler des secrets dans les journaux.
Une recette qui couvre aussi les échecs
Demandez cinq démonstrations : échange normal, message répété, service indisponible, données invalides et absence d’autorisation. Ajoutez un test de reprise après interruption. Le tableau de suivi doit montrer les opérations terminées et celles qui demandent une intervention.
Faites distinguer « reçu », « traité » et « action métier confirmée ». Une réponse technique réussie ne prouve pas toujours que toute la chaîne est terminée.
Coûts et dépendances
Prévoyez le développement, les limites de l’API, les éventuels frais d’usage, l’exploitation et les changements futurs du fournisseur. Simulation : cinq jours à 700 € HT donnent 3 500 € HT pour une intégration de périmètre défini. Ce montant ne couvre pas automatiquement toutes les variantes d’erreur et reprises d’historique.
Votre prochaine action
Dessinez un seul échange et faites préciser son comportement en cas de doublon et d’indisponibilité. Demandez ensuite un prototype qui démontre ces deux situations. Vous gagnerez une base plus solide pour les automatisations suivantes.