« On peut le connecter à Bexio ?, Oui, si Bexio expose une API. Sinon on regarde s'il y a un webhook. » Si vous avez déjà entendu cette phrase et hoché la tête sans vraiment comprendre, ce guide est pour vous.
API, webhook, intégration : trois mots qu'on entend partout dès qu'on parle d'automatisation ou d'IA en PME, mais qu'on n'explique presque jamais clairement. En 6 minutes, vous allez tout comprendre, et savoir poser les bonnes questions à votre prestataire.
Une API, c'est quoi exactement ?
API veut dire Application Programming Interface. En français très simple : une porte d'entrée par laquelle un logiciel peut parler à un autre logiciel.
Analogie : imaginez un restaurant. Vous (l'application qui demande) ne pouvez pas rentrer en cuisine prendre votre plat directement. Vous parlez au serveur (l'API) qui transmet votre commande à la cuisine, et qui revient avec votre plat. La cuisine reste maîtresse de ses recettes et de sa façon de travailler, mais elle expose un menu (la liste des choses qu'on peut commander).
Une API, c'est exactement ça : une liste d'opérations qu'un logiciel accepte de faire pour les autres logiciels qui lui demandent.
Exemple concret avec Bexio
Bexio (le logiciel de facturation suisse) expose une API. Cela signifie qu'un autre logiciel peut lui demander des choses comme :
- « Donne-moi la liste des 10 dernières factures émises »
- « Crée une nouvelle facture pour le client X avec ces lignes »
- « Marque cette facture comme payée »
- « Liste-moi tous les clients avec un solde impayé supérieur à 1 000 CHF »
Bexio répond, et l'autre logiciel peut faire ce qu'il veut de la réponse (afficher, traiter, déclencher autre chose).
Un webhook, c'est quoi alors ?
Un webhook fait l'inverse d'une API. Avec une API, c'est toujours vous qui demandez ("hé Bexio, donne-moi mes factures"). Avec un webhook, c'est Bexio qui vous prévient quand quelque chose se passe.
Analogie : continuons avec le restaurant. Une API, c'est vous qui demandez : « Mon plat est prêt ? ». Vous devez demander encore et encore jusqu'à ce qu'il soit prêt. Un webhook, c'est le serveur qui vient vous prévenir à votre table dès que le plat sort de la cuisine, sans que vous ayez à demander. Beaucoup plus efficace.
Exemple concret avec Stripe
Vous vendez en ligne et acceptez des paiements via Stripe. Au lieu de demander à Stripe toutes les 30 secondes « est-ce qu'il y a un nouveau paiement ? » (gaspillage de ressources), vous configurez un webhook : Stripe vous notifie automatiquement à chaque paiement reçu.
Cette notification peut alors déclencher :
- L'enregistrement automatique du paiement dans Bexio
- L'envoi d'un mail de confirmation au client
- L'expédition automatique de la commande
- Une notification Slack à l'équipe
- L'inscription du client à votre newsletter
Le tout, en quelques secondes, sans intervention humaine.
La différence en une image mentale
Webhook = on vous pousse l'information quand un événement se produit. Sans que vous demandiez.
Dans la vraie vie, les deux fonctionnent souvent ensemble : un webhook vous notifie qu'un événement a eu lieu, et vous utilisez l'API pour récupérer les détails et agir.
Tableau comparatif
| Critère | API | Webhook |
|---|---|---|
| Qui initie ? | Vous (en demandant) | L'autre service (en notifiant) |
| Quand ? | Quand vous décidez | Quand un événement se produit |
| Coût en ressources | Élevé si vous demandez souvent | Faible, on ne vous appelle que quand utile |
| Latence | Variable selon votre fréquence | Quasi temps réel |
| Usage typique | Récupérer/modifier des données | Réagir à un événement |
Pourquoi ça change tout pour votre PME
Voici la phrase magique : « Si un outil expose une API ou un webhook, on peut l'intégrer à n'importe quoi d'autre. »
Concrètement, cela signifie que :
- Vos outils peuvent enfin se parler. Plus de double saisie entre votre CRM et votre comptabilité. Plus de fichier Excel qui passe d'une boîte mail à l'autre.
- L'automatisation devient possible. Toutes les plateformes type n8n, Make, Zapier fonctionnent exclusivement avec des APIs et des webhooks. Sans ces deux briques, pas d'automatisation possible.
- Les agents IA peuvent agir réellement. Un agent IA qui ne peut que lire et répondre, c'est un chatbot. Un agent IA qui peut agir dans vos outils (créer une facture, envoyer un mail, mettre à jour une fiche client), c'est grâce aux APIs.
Comment savoir si vos outils ont des APIs ou des webhooks ?
La plupart des outils SaaS modernes en ont. Quelques exemples en PME suisse :
- API ET webhook : Bexio, HubSpot, Stripe, Shopify, WooCommerce, Mailchimp, Calendly, Pipedrive, Salesforce, Slack, Microsoft 365, Google Workspace, Airtable, Notion, Typeform…
- API seulement : QuickBooks, Xero, Sage, certains logiciels métier vieillissants
- Webhook seulement : certains outils minimalistes ou très récents
- Ni l'un ni l'autre : certains logiciels métier suisses très anciens ou très spécialisés
Pour vérifier : tapez « [nom de l'outil] API documentation » ou « [nom de l'outil] webhook » sur Google. Si le résultat existe et est récent, c'est bon signe.
Et si mon outil n'a pas d'API ?
Pas de panique, il y a toujours des solutions, classées du meilleur au moins bon :
- API non-officielle. Beaucoup d'outils ont une API utilisée par leur propre site web qu'on peut « écouter ». Ce n'est pas idéal (peut changer sans préavis) mais ça marche souvent.
- Export régulier (CSV, Excel). Vous configurez un export programmé de vos données dans un dossier, et un workflow d'automatisation lit ces fichiers. Moins fluide qu'une API mais largement viable.
- Automatisation d'interface (Selenium, Playwright). Le système simule un humain qui utilise l'interface graphique du logiciel. Solution de dernier recours, plus fragile.
- Changer d'outil. Parfois la meilleure solution est de migrer vers un outil moderne avec une vraie API. À évaluer au cas par cas.
Trois questions à poser à votre prestataire
Quand on vous propose un projet d'automatisation ou d'IA en PME, posez systématiquement ces trois questions :
- « Mes outils actuels ont-ils une API ou des webhooks documentés ? » Si oui, le projet est faisable proprement. Si non, demandez quelle solution de contournement est prévue.
- « Qui gère les clés d'API (les codes d'accès) ? » Idéalement, vous. Pas votre prestataire. Vous devez pouvoir les révoquer en un clic si la relation se termine.
- « Que se passe-t-il si un outil change son API demain ? » Réponse acceptable : la maintenance prévue dans le contrat couvre les adaptations. Réponse à éviter : « on verra à ce moment-là ».
L'essentiel à retenir
- API = la porte d'entrée d'un logiciel par laquelle vous pouvez lui demander des choses
- Webhook = la notification qu'un logiciel vous envoie quand un événement se passe
- Les deux fonctionnent souvent ensemble dans une intégration moderne
- Sans API ni webhook, pas d'automatisation possible (ou alors via des contournements fragiles)
- La quasi-totalité des outils SaaS modernes en ont, votre stack est probablement déjà prête
Vous voulez savoir si vos outils sont intégrables et ce que ça permettrait concrètement chez vous ? L'audit finalyn.ia est gratuit, on regarde votre stack en 30 minutes et on vous dit ce qui est branchable, comment, et à quel coût.