Utiliser le Playground API (paramètres développeur)

Le Playground API est un bac à sable interactif pour l'API développeur d'eGrow. Vous choisissez une action, remplissez un formulaire simple, et eGrow construit pour vous la requête API exacte — sous forme de commande cURL prête à copier ou de requête GraphQL — puis vous laisse l'exécuter et voir la réponse en direct. C'est le moyen le plus rapide de comprendre et tester l'API avant d'écrire la moindre ligne de code d'intégration. Ouvrez-le dans Paramètres → Développeur → Playground sur https://v2.egrow.com/settings/developer/playground.

Comment le Playground est organisé

L'écran est divisé en deux :

• D'un côté, un formulaire pour l'action choisie — les entrées dont la requête a besoin.
• De l'autre, un panneau Requête et Réponse en direct qui se met à jour à mesure que vous remplissez le formulaire.

En haut, vous choisissez l'Action à essayer. Il y en a trois :

Action 1 : Envoyer un message

Envoyez un message à un client via un canal connecté — exactement ce que votre intégration ferait pour joindre quelqu'un sur WhatsApp. Renseignez :

• Connexion (requis) — depuis quel canal connecté (ex. un numéro WhatsApp) envoyer.
• Destinataire (requis) — le client à contacter.
• Type de message — texte, image, vidéo ou e-mail.
• Objet (e-mail uniquement) et le corps du message, ou un lien/téléversement média pour l'image et la vidéo.

Action 2 : Ajouter une commande

Créez une commande via l'API — le même appel qu'utilise une intégration boutique pour pousser de nouvelles commandes dans eGrow. Le formulaire reflète une commande complète et est découpé en sections repliables pour ne pas être écrasant :

• Détails de la commande — numéro de commande, ID externe, URL de panier abandonné, type de commande, pipeline/étape, statut financier, boutique et canal de vente.
• Client — les coordonnées de l'acheteur.
• Articles — les produits de la commande.
• Remises et Tarification.
• Adresse de livraison, Adresse de facturation et Contact.
• UTM — paramètres d'attribution de campagne.

Vous pouvez Tout développer / Tout réduire, et utiliser Remplir des données fictives pour insérer des valeurs d'exemple réalistes et tester l'appel en quelques secondes sans tout saisir.

Action 3 : Mettre à jour l'étape

Déplacez une commande existante vers une autre étape de votre pipeline — l'appel qu'un système externe ferait pour garder eGrow synchronisé (par exemple, marquer une commande expédiée). Choisissez la commande et l'étape cible.

Lire la requête et l'exécuter

À mesure que vous remplissez le formulaire, le panneau Requête affiche l'appel de deux façons — basculez entre :

• cURL — une commande curl -X POST complète vers le point de terminaison de l'API, avec l'en-tête d'authentification et vos données. Copiez-la et elle s'exécute telle quelle dans votre terminal.
• GraphQL — le document requête/mutation sous-jacent plus ses Variables, si vous préférez travailler à ce niveau.

Cliquez sur Exécuter pour lancer la requête sur l'API en direct et voir la Réponse JSON juste en dessous — la même réponse que recevrait votre intégration. Vous pouvez aussi copier la réponse, et basculer un thème de code clair/sombre pour la lisibilité.

Du Playground à la production

Une fois qu'un appel fonctionne ici, portez-le dans votre propre code :

1. Copiez le cURL (ou le document GraphQL et ses variables).
2. Remplacez l'authentification du Playground par votre propre Clé API personnelle depuis Paramètres → Développeur → Clé API comme jeton Bearer.
3. Envoyez-le depuis votre application, et traitez la réponse JSON de la même façon que vous l'avez vue ici.

Qui l'utilise : votre développeur et votre agent de code IA

Le Playground sert à découvrir et tester les appels. Il y a ensuite deux façons d'utiliser l'API eGrow en pratique.

Votre développeur — l'API REST/GraphQL

Un développeur construit directement sur l'API que vous venez de tester :

1. Prototyper dans le Playground — faire fonctionner l'appel et copier son cURL (ou le document GraphQL + variables).
2. S'authentifier avec une Clé API personnelle depuis Paramètres → Développeur → Clé API, envoyée comme jeton Bearer — ou, pour une app tierce agissant sur d'autres comptes, une App OAuth depuis l'onglet Apps OAuth.
3. Appeler le point de terminaison depuis son code et traiter la réponse JSON, exactement comme vu dans le Playground.

Tout ce que fait le Playground — envoyer des messages, créer des commandes, changer d'étape — est disponible par programmation, votre développeur peut donc brancher eGrow sur votre site, votre ERP ou n'importe quel backend.

Votre agent de code IA — le serveur MCP

Si vous utilisez un assistant de code IA (Claude, Cursor et similaires), eGrow fournit un serveur MCP dédié pour que l'agent parle directement à votre compte — lire et agir sur vos données réelles via un ensemble d'outils sûr et structuré. Configurez-le dans Paramètres → Développeur → MCP (https://v2.egrow.com/settings/developer/mcp).

• URL du serveur — https://mcp.egrow.com/mcp (transport HTTP).
• Authentification — OAuth (l'agent se connecte à eGrow, rien à coller) ou un jeton (votre Clé API personnelle). L'onglet MCP vous donne un extrait de configuration prêt à coller dans les réglages de votre agent, par exemple :

  {
   "mcpServers": {
   "egrow": { "type": "http", "url": "https://mcp.egrow.com/mcp" }
   }
  }

  Pour les éditeurs qui nécessitent un pont local, il fournit aussi une commande stdio : npx -y mcp-remote https://mcp.egrow.com/mcp.
• Ce que l'agent peut faire — une quarantaine d'outils regroupés par domaine : Commandes (11), Clients (10), Produits (7), Découverte (4), Statistiques (3), Sortie de secours (3) et Pipelines (2). Vous pouvez donc simplement demander, en langage naturel : « Combien de commandes ont été livrées la semaine dernière ? », « Crée une commande pour ce client », ou « Quels produits ont le meilleur taux de livraison ? » — et l'agent exécute les bons outils sur votre compte.

Et ensuite

Configurez l'authentification dans Paramètres → Développeur → Clé API, explorez les flux pilotés par événements avec les automatisations, et connectez votre stack dans Intégrations et développeurs.