Une API, en termes simples
Une API (Application Programming Interface) est une porte d’entrée qu’un logiciel ouvre aux autres logiciels. Au lieu qu’un humain se connecte à l’interface pour lire ou saisir des informations, un autre programme peut le faire directement, de façon automatique et structurée.
Un exemple concret : quand un client paie sur votre site, Stripe ne vous envoie pas un email que vous lisez puis recopiez. Il envoie un message automatique (un webhook) à votre logiciel, qui marque la facture comme payée, débloque l’accès du client et vous notifie. Personne n’a rien saisi.
Presque tous les outils professionnels modernes ont une API : CRM, logiciels comptables, plateformes publicitaires, outils de paiement, agendas, messageries, services d’IA. L’intégration d’API consiste à écrire le code ou les workflows qui relient ces outils pour qu’ils échangent les bonnes informations au bon moment.
API et webhook : la différence
- Appel d’API : votre système va chercher ou envoyer une information quand il en a besoin (« donne-moi les avis Google de la semaine »).
- Webhook : l’autre système vous prévient dès qu’un événement se produit (« un nouveau lead vient d’arriver »). C’est ce qui permet le temps réel.
Pourquoi intégrer vos outils plutôt que d’en changer
Face à des outils qui ne communiquent pas, on est tenté de chercher le logiciel unique qui ferait tout. Il existe rarement. Et changer d’outil a un coût : migration, formation, habitudes perdues.
L’intégration prend le problème dans l’autre sens : vous gardez les outils que vous aimez et que votre équipe maîtrise, et on supprime les ressaisies entre eux. Les bénéfices sont immédiats :
- Plus de double saisie, donc des heures gagnées chaque semaine.
- Moins d’erreurs : une information saisie une fois est la même partout.
- Du temps réel : le lead arrive dans le CRM à la seconde, le paiement débloque l’accès instantanément.
- Une vision consolidée : les chiffres de plusieurs outils réunis dans un seul tableau de bord.
- De la liberté : remplacer un outil plus tard ne casse pas tout, il suffit de changer un connecteur.
Les intégrations que je réalise le plus souvent
- Google Business Profile : récupération des avis, réponses, statistiques de la fiche, publications. C’est le cœur historique d’EvoRating.
- Gmail : lecture et classement des emails, envoi, détection d’événements (une réponse, une acceptation).
- Google Agenda : création de rendez-vous, vérification des disponibilités.
- Google Sheets et Drive : lecture et écriture de données, archivage de documents.
- Search Console et Analytics : récupération des statistiques pour le reporting.
Meta
- Meta Lead Ads : réception en temps réel des formulaires de publicité Facebook et Instagram.
- API Marketing : suivi des campagnes, des dépenses et des résultats pour le reporting et les alertes.
- Messenger, Instagram, WhatsApp : réception et envoi de messages pour les assistants IA.
Paiement
- Stripe et Mollie : paiements en ligne, abonnements, webhooks de confirmation, remboursements, rapprochement avec les factures.
IA
- API OpenAI et Anthropic : classification, extraction, rédaction, agents, avec sorties structurées en JSON et garde-fous.
Communication
- Brevo et autres services d’emailing transactionnel.
- Telegram et Slack : notifications et validations en un clic.
Logiciels métier
- CRM du marché (HubSpot, Pipedrive, Axonaut, Sellsy…), logiciels comptables, ERP, plateformes sectorielles : dès qu’il y a une API documentée, on peut connecter.
Deux façons d’intégrer : workflow n8n ou code sur mesure
Selon le besoin, j’utilise l’une ou l’autre approche, et souvent les deux ensemble.
Avec n8n
Pour relier des outils existants entre eux, n8n est idéal : des centaines de connecteurs prêts à l’emploi, des requêtes HTTP pour tout le reste, une interface visuelle pour comprendre le flux, des alertes en cas d’erreur. Rapide à mettre en place, facile à faire évoluer.
En code, dans une application
Quand l’intégration fait partie du cœur d’un produit ou d’un logiciel métier, je l’écris directement en PHP avec Symfony : client HTTP, gestion des jetons OAuth et de leur rafraîchissement, files de messages pour les traitements asynchrones, tests automatisés. Plus robuste pour les gros volumes et les logiques critiques.
La combinaison
Sur EvoRating, les deux coexistent : l’application Symfony expose ses propres API internes protégées par clé, et les workflows n8n les appellent pour orchestrer les traitements. Chacun fait ce qu’il fait le mieux.
Une intégration fiable : ce qui fait la différence
Connecter deux API en test prend une heure. Faire une intégration qui tourne des années sans surprise demande de la rigueur :
- Authentification propre : OAuth 2.0 quand le service le propose, jetons stockés chiffrés, rafraîchissement automatique avant expiration, alerte si l’accès est révoqué.
- Vérification des webhooks : signature vérifiée pour être sûr que le message vient bien du service annoncé.
- Idempotence : un même événement reçu deux fois ne doit produire qu’une seule action.
- Gestion des limites : chaque API impose un nombre maximum d’appels. On espace, on met en file, on réessaie intelligemment.
- Gestion des erreurs : nouvelle tentative pour les erreurs temporaires, alerte pour les erreurs persistantes, jamais d’échec silencieux.
- Journalisation : chaque échange important est tracé pour pouvoir comprendre un problème après coup.
- Versions d’API : suivi des changements annoncés par les éditeurs pour adapter l’intégration avant qu’elle ne casse.
Exemples d’intégrations de bout en bout
Du lead publicitaire au rendez-vous
Un prospect remplit un formulaire Meta Lead Ads. Le webhook arrive dans n8n, qui crée le contact dans le CRM, envoie un SMS ou un email de bienvenue avec un lien de prise de rendez-vous, notifie le commercial sur Telegram, et relance le prospect s’il n’a pas réservé sous 24 heures.
Du devis au paiement
Le client accepte un devis en ligne. Le logiciel crée un paiement Mollie ou Stripe. À la confirmation du paiement, le webhook déclenche la création du compte client, l’envoi des accès, la mise à jour de la fiche CRM et la notification à l’administrateur.
De la prestation à l’avis Google
Quand une intervention est marquée terminée, le client reçoit un message qui l’invite à laisser un avis sur la fiche Google, avec un lien direct. Il peut aussi écrire un message privé au dirigeant s’il a un souci à remonter. Les nouveaux avis sont récupérés via l’API Google Business Profile et intégrés au reporting.
Par où commencer : les flux à connecter en priorité
Toutes les intégrations n’ont pas la même valeur. Pour prioriser, je classe les flux selon deux critères : le temps qu’ils coûtent aujourd’hui, et le risque qu’une erreur ou un retard fait peser sur le chiffre d’affaires. Dans la plupart des PME, l’ordre est le suivant :
- Les demandes entrantes vers le CRM : site, publicité, emails. Un lead perdu ou traité tard, c’est du chiffre d’affaires qui disparaît.
- Le devis vers la facture et le paiement : éviter de ressaisir, et ne plus laisser filer de retards de paiement.
- Les rendez-vous vers l’agenda et les rappels : moins d’absences, moins d’allers-retours.
- Les données vers un tableau de bord : avoir enfin les chiffres sans les compiler à la main.
- Les tâches de fond : archivage des documents, synchronisation des contacts, sauvegardes.
On commence par le premier flux, on le met en production, on mesure, puis on passe au suivant.
Avant de choisir un nouveau logiciel : la question de l’API
Un conseil qui évite bien des regrets : avant de souscrire à un nouveau logiciel, vérifiez son ouverture. Les questions à poser à l’éditeur :
- Avez-vous une API publique et documentée ? Est-elle incluse dans mon abonnement ou réservée à une offre supérieure ?
- Proposez-vous des webhooks pour être prévenu des événements (nouveau client, paiement, changement de statut) ?
- Quelles limites d’appels s’appliquent ?
- Puis-je exporter toutes mes données, dans un format exploitable, à tout moment ?
- Existe-t-il un connecteur n8n, Make ou Zapier ?
Un logiciel fermé, même excellent, devient vite une île dans votre système d’information. Un logiciel ouvert s’intègre au reste et vous laisse libre de partir un jour.
Consolider ses données dans un tableau de bord
Une fois les outils reliés, une possibilité nouvelle apparaît : voir tous vos chiffres au même endroit. Demandes reçues par source, devis envoyés et signés, chiffre d’affaires encaissé, dépenses publicitaires, coût par lead, avis Google, trafic du site. Au lieu d’ouvrir six outils chaque lundi, vous recevez un récapitulatif automatique, ou vous consultez un tableau de bord à jour en permanence.
C’est ce que propose le portail client d’EvoRating, avec un rapport PDF mensuel généré automatiquement. Le même principe s’applique à n’importe quelle combinaison d’outils, du moment qu’ils ont une API.
Un bon tableau de bord reste sobre : cinq à dix indicateurs, comparés à la période précédente, avec une alerte quand l’un d’eux sort de sa zone normale. Par exemple, un coût par lead publicitaire qui double en une semaine, un taux de signature des devis qui chute, ou une note Google qui baisse. L’objectif n’est pas de tout voir, mais de voir tout de suite ce qui demande votre attention. Les données sont rafraîchies automatiquement, plusieurs fois par jour si besoin, sans export ni copier-coller, et l’historique est conservé pour comparer les mois et les années.
Méthode et budget
Je commence par un inventaire : quels outils vous utilisez, quelles informations passent de l’un à l’autre, à quelle fréquence, par qui. On repère les flux qui coûtent le plus de temps ou d’erreurs. Je vérifie ensuite que les API nécessaires existent et ce qu’elles permettent réellement, car toutes ne se valent pas.
Une intégration simple entre deux outils bien documentés se réalise en général en quelques jours. Un ensemble d’intégrations avec logique métier, gestion d’erreurs et tableau de bord demande quelques semaines. Les coûts récurrents sont faibles : hébergement de n8n ou de l’application, et éventuellement abonnements API de certains services. Le devis est écrit et détaillé.