Intégration de Modules & API

Le Système de Modules d'EcomBot vous permet d'étendre à l'infini les capacités de votre conseiller de vente virtuel sans modifier le code principal de votre boutique. Chaque module apporte à l'intelligence artificielle des outils spécifiques (Tools), des consignes métier complémentaires, et des composants graphiques interactifs affichés en direct dans le chat.

Qu'est-ce qu'un module applicatif ?

Un module est un connecteur intelligent qui fait le pont entre EcomBot et vos services externes (ERP, CRM, transporteurs, configurateurs 3D). Contrairement aux intégrations rigides classiques, les modules d'EcomBot sont chargés de manière asynchrone et sécurisée (Eager Sync) pour garantir un temps de réponse instantané et une isolation complète des données de vos clients.

Exemples d'applications concrètes :

1. Suivi de colis en temps réel : Connectez votre transporteur (Colissimo, DHL, Mondial Relay) pour permettre à l'IA de répondre instantanément aux questions du type "Où est mon colis ?" en interrogeant directement l'API de livraison.
2. Configurateur produit interactif : Permettez à l'IA d'ouvrir une interface d'aide au choix (sélection de dimensions, couleurs, matières) et de renvoyer le résultat dans le chat pour un ajout direct au panier.
3. Recommandations croisées ERP : Synchronisez vos stocks physiques et vos historiques d'achat CRM pour suggérer des produits complémentaires hautement personnalisés.

Fonctionnement technique et sécurité

Le pipeline d'exécution des modules d'EcomBot repose sur trois piliers fondamentaux :

1. Construction dynamique des outils (Dynamic Tool Calling)

Lorsqu'un module est activé pour votre projet, ses outils sont préfixés de manière unique (ex: erp-order-tracking__get_order_status) et enregistrés auprès de l'intelligence artificielle. L'IA détermine elle-même, selon la discussion, à quel moment appeler l'API du module.

2. Résolution sécurisée de modèles (Template Resolution)

Pour interroger vos APIs tierces, EcomBot utilise des modèles de requêtes dynamiques (URL, en-têtes HTTP, corps de requête). Vous pouvez y injecter des variables dynamiques en toute sécurité :

• {{customer.email}} : L'e-mail du client connecté.
• {{customer.phone}} : Le numéro de téléphone de facturation.
• {{project.config.api_key}} : Votre clé API secrète configurée dans l'administration.

🚨 Important : Sécurité et conformité RGPD Toutes les clés d'API et jetons d'autorisation configurés dans vos modules sont stockés de manière chiffrée. De plus, nos serveurs filtrent et masquent systématiquement vos clés secrètes dans l'historique des traces et les logs de diagnostic pour éviter toute fuite accidentelle.

3. Rendu de composants interactifs (_module_ui)

Lorsqu'un outil de module renvoie un résultat, il peut facultativement inclure une directive visuelle _module_ui. Le widget de chat détecte cette directive et affiche instantanément le composant React correspondant (ex: une carte interactive de suivi de colis avec barre de progression) offrant une expérience immersive et haut de gamme.

Comment installer et configurer un module ?

1. Rendez-vous dans votre Espace d'Administration EcomBot, section Sources de données puis Modules.
2. Parcourez le catalogue global des modules disponibles et cliquez sur Installer sur le module de votre choix.
3. Renseignez les paramètres de configuration requis (clés d'API, URLs des points de terminaison, variables par défaut).
4. Cochez la case Activer le module pour le rendre immédiatement disponible pour votre conseiller IA.
5. Utilisez la Console de Test pour simuler une conversation et vérifier que l'IA appelle correctement l'API de votre module.

💡 Astuce : Dégradation gracieuse en cas de panne Si votre API externe subit une coupure temporaire ou un temps de réponse trop long, EcomBot coupe silencieusement l'appel après un timeout de 5 secondes. L'IA reprend le dessus et explique poliment au client qu'elle n'a pas pu joindre le service de suivi, sans jamais planter ou bloquer le widget de discussion.