Intégration avec OpenAPI dans SmartFlow
Introduction
SmartFlow permet l'intégration d'APIs externes via la norme OpenAPI. Cette fonctionnalité vous offre une flexibilité immense pour connecter vos flux de travail à des services tiers, automatiser des tâches complexes et enrichir vos processus métier.
Pourquoi utiliser OpenAPI dans SmartFlow ?
- Interopérabilité : Connectez SmartFlow à tout système compatible avec OpenAPI.
- Automatisation avancée : Effectuez des appels API pour envoyer ou récupérer des données en temps réel.
- Gain de temps : Importez des collections OpenAPI pour utiliser des points de terminaison prédéfinis sans configuration complexe.
Capture d'écran : [Inclure une capture d'écran montrant l'interface pour importer une collection OpenAPI depuis la page des paramètres du chatbot.]
Ajouter une intégration OpenAPI
1. Importer une collection OpenAPI
- Accédez à la page des paramètres du chatbot : Naviguez vers l'onglet "Paramètres" du chatbot concerné.
- Importer un fichier ou configurer depuis l'interface : Cliquez sur "Ajouter une collection OpenAPI" et sélectionnez un fichier JSON ou YAML, ou configurez les points de terminaison directement depuis l'interface.
- Validation : Les points de terminaison sont automatiquement triés par collection et validés.
- Sauvegarder : Une fois validés, les points de terminaison deviennent disponibles en tant qu'actions de type "API" dans SmartFlow.
Capture d'écran : [Montrer l'interface de configuration dans la page des paramètres du chatbot.]
2. Utiliser des actions API dans SmartFlow
- Ajouter une action : Dans votre flux de travail SmartFlow, allez à l'onglet Actions et sélectionnez "API".
- Choisir un point de terminaison : Les points de terminaison sont triés par collection et disponibles pour tous les types de SmartFlows.
- Définir les paramètres : Configurez les champs requis pour l'appel (en-têtes, corps, etc.).
- Observation par défaut : Par défaut, chaque action API renvoie le résultat de l'appel en tant qu'observation en mode "Outil de conversation", permettant à l'IA de prendre automatiquement la prochaine décision.
Capture d'écran : [Insérer une capture d'écran montrant un point de terminaison utilisé comme action API dans SmartFlow.]
Exemple d'utilisation
Scénario : Synchronisation avec un CRM externe
- Objectif : Mettre à jour les informations client dans votre CRM lorsqu'un formulaire est soumis.
- Flux de travail :
- Déclencheur : Un utilisateur remplit un formulaire via SmartForm.
- Action API : Envoyer les données du formulaire à l'API de votre CRM.
- Observation : Le résultat de l'appel est automatiquement renvoyé en tant qu'observation en mode "Outil de conversation".
- Avantages : Gain de temps et réduction des erreurs manuelles.
Capture d'écran : [Montrer un flux de travail complet avec un appel API lié à un CRM.]
Scénario : Récupération des données utilisateur
- Objectif : Personnaliser une réponse de chatbot en fonction des données utilisateur.
- Flux de travail :
- Déclencheur : Une demande utilisateur dans le chatbot.
- Action API : Interroger une API externe pour obtenir des informations sur l'utilisateur.
- Observation : Utiliser les données renvoyées comme une observation pour décider de la prochaine réponse du chatbot.
Capture d'écran : [Illustrer une interaction entre un chatbot et une API externe.]
Meilleures pratiques
- Importer des collections vérifiées : Assurez-vous que vos fichiers OpenAPI respectent les normes pour éviter les erreurs d'importation.
- Tester régulièrement : Validez vos appels API pour vous assurer qu'ils fonctionnent comme prévu.
- Documenter vos intégrations : Ajoutez des descriptions claires pour chaque point de terminaison afin de faciliter leur gestion.
Avec cette intégration, SmartFlow devient une plateforme encore plus puissante pour connecter vos outils et automatiser vos processus. Passez à la section suivante pour découvrir le Template Store et partager vos flux de travail !