API (Application Programming Interface)

Une API est une interface standardisée qui permet à deux programmes de communiquer entre eux. Elle définit précisément quelles données un programme peut demander et sous quelle forme il reçoit la réponse — un peu comme un serveur qui fait la navette entre le client (votre logiciel) et la cuisine (notre plateforme).

Qu'est-ce qu'une API ?

API signifie « Application Programming Interface » (interface de programmation applicative). Une API est le langage convenu que deux systèmes logiciels utilisent pour échanger des informations. Ce n'est pas un programme que vous manipulez, mais un contrat : « Si vous m'envoyez A, je vous renvoie B ».

Imaginez un restaurant. En tant que client, vous ne voyez pas la cuisine. Vous parlez au serveur. Le serveur connaît le menu (= la documentation de l'API), prend votre commande sous une forme fixe (« pâtes à la sauce tomate ») et vous apporte le résultat. La cuisine peut changer — nouveaux chefs, nouveaux équipements — et tant que le serveur garde le même menu, votre expérience reste identique. C'est exactement ainsi qu'une API sépare ce que votre logiciel demande de la manière dont le service sous-jacent le délivre.

Pourquoi les API sont importantes

Les API constituent l'ossature invisible des logiciels modernes. Lorsque votre outil de comptabilité communique avec Stripe, lorsque votre boutique en ligne vérifie les stocks en temps réel, lorsque votre site web intègre Google Maps — une API s'exécute en arrière-plan. Sans API, chaque entreprise devrait construire elle-même chaque fonctionnalité. Grâce aux API, elles assemblent des services spécialisés comme des briques.

L'API dans le contexte SendSeven

SendSeven expose une API qui permet à votre logiciel d'envoyer des messages, de gérer des contacts et de lire des conversations — sur WhatsApp, SMS, e-mail, Telegram, Instagram, Messenger et live chat. Trois exemples concrets :

  • Boutique en ligne : Après chaque commande, votre boutique envoie automatiquement une confirmation WhatsApp — sans saisie manuelle.
  • CRM : Dès qu'un prospect passe au statut « chaud », le CRM déclenche un message personnalisé via le canal préféré du client.
  • Helpdesk : Les messages WhatsApp entrants arrivent sous forme de tickets dans votre système de helpdesk — via webhook dans l'autre sens.

Types d'API

Toutes les API ne fonctionnent pas de la même manière. Les variantes les plus courantes :

  • REST API : Le standard actuel pour les API web. Utilise HTTP comme un navigateur, facile à employer, prise en charge par tous les langages de programmation. SendSeven utilise REST.
  • GraphQL : Une variante où le client précise exactement quels champs il souhaite recevoir. Plus efficace pour les modèles de données complexes.
  • WebSocket : Pour des connexions en temps réel où le serveur lui-même pousse des événements (par exemple, « nouveau message reçu »).
  • MCP Server : Un type d'interface plus récent, conçu spécifiquement pour les agents IA comme Claude ou GPT.

Authentification : qui a le droit de faire quoi ?

Les API ne sont pas ouvertes au public. Chaque appel doit s'identifier. SendSeven utilise une clé API — un jeton secret et personnel qui fonctionne comme un mot de passe. Quiconque détient la clé peut agir en votre nom. C'est pourquoi une clé API n'a sa place ni dans le frontend, ni dans un dépôt GitHub public, ni dans un e-mail.

Que se passe-t-il quand quelque chose tourne mal ?

Chaque API répond avec un code de statut. 200 OK signifie que tout va bien. 401 signifie que l'authentification a échoué. 429 signifie trop de requêtes — voir rate limiting. 500 signifie une erreur côté serveur. Une bonne intégration vérifie le code de statut et réagit de manière appropriée — par exemple, en réessayant après une courte pause.

API vs Connecteur vs SDK

Ces trois termes sont souvent confondus :

  • API : L'interface brute — appels HTTP, réponses JSON. Nécessite des connaissances en programmation.
  • SDK : Une bibliothèque prête à l'emploi (en Python, JavaScript, PHP…) qui simplifie l'API pour les développeurs.
  • Connecteur : Une intégration toute faite vers un système tiers spécifique (par exemple, le connecteur Shopify). Souvent utilisable sans coder.

Ai-je besoin d'une API en tant que PME ?

Réponse courte : uniquement si vous souhaitez automatiser quelque chose qui n'est pas possible d'emblée. SendSeven propose trois voies, selon votre profondeur technique :

  1. Interface de la plateforme : Cliquer plutôt que coder — le choix par défaut pour le service client et le marketing.
  2. Connecteurs : Intégrations prêtes à l'emploi vers Shopify, HubSpot, Zapier, etc. — généralement sans code.
  3. API : Pour des workflows sur mesure, votre propre logiciel ou des opérations en masse.