Aller au contenu principal

Intégration avec OpenAPI dans SmartFlow

Introduction​

SmartFlow permet d'intégrer des APIs externes via la norme OpenAPI. Cette fonctionnalité vous offre une flexibilité immense pour connecter vos workflows à des services tiers, automatiser des tâches complexes, et enrichir vos processus d’entreprise.

Pourquoi utiliser OpenAPI dans SmartFlow ?​

  • Interopérabilité : Connectez SmartFlow à n'importe quel 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 d'accès prédéfinis sans configuration complexe.

Capture d'écran : [Inclure une capture montrant l'interface d'importation d'une collection OpenAPI depuis la page Settings du chatbot.]

Ajouter une intégration OpenAPI​

1. Importer une collection OpenAPI​

  1. Accéder à la page Settings du Chatbot : Naviguez vers l'onglet "Settings" du chatbot concerné.
  2. Importer un fichier ou configurer depuis l'interface : Cliquez sur "Ajouter une collection OpenAPI" et sélectionnez un fichier JSON ou YAML, ou configurez directement les endpoints depuis l'interface.
  3. Validation : Les endpoints sont automatiquement triés par collection et validés.
  4. Sauvegarder : Une fois validés, les endpoints deviennent disponibles comme actions de type "API" dans SmartFlow.

Capture d'écran : [Montrer l'interface de configuration dans la page Settings du Chatbot.]

2. Utiliser les actions API dans SmartFlow​

  1. Ajouter une action : Dans votre workflow SmartFlow, accédez à l'onglet Actions et sélectionnez "API".
  2. Choisir un endpoint : Les endpoints sont triés par collection et disponibles pour tous les types de SmartFlows.
  3. Définir les paramètres : Configurez les champs requis pour l'appel (headers, body, etc.).
  4. Observation par défaut : Par défaut, chaque action API renvoie le résultat de l'appel comme observation en mode "Conversation Tool", permettant à l'IA de prendre la prochaine décision automatiquement.

Capture d'écran : [Insérer une capture montrant un endpoint utilisé comme action API dans SmartFlow.]

Exemple d'utilisation​

Scénario : Synchronisation avec un CRM externe​

  1. Objectif : Mettre à jour les informations d'un client dans votre CRM lorsqu'un formulaire est soumis.
  2. Workflow :
    • Trigger : 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é comme observation en mode "Conversation Tool".
  3. Bénéfices : Gain de temps et réduction des erreurs manuelles.

Capture d'écran : [Montrer un workflow complet avec un appel API lié à un CRM.]

Scénario : Récupération de données utilisateur​

  1. Objectif : Personnaliser une réponse de chatbot en fonction des données utilisateur.
  2. Workflow :
    • Trigger : Une requête utilisateur dans le chatbot.
    • Action API : Interroger une API externe pour obtenir des informations utilisateur.
    • Observation : Utiliser les données renvoyées comme observation pour décider de la prochaine réponse du chatbot.

Capture d'écran : [Illustrer une interaction entre un chatbot et une API externe.]

Bonnes pratiques​

  • Importer des collections vérifiées : Assurez-vous que vos fichiers OpenAPI sont conformes aux normes pour éviter des erreurs d'importation.
  • Tester régulièrement : Validez vos appels API pour garantir qu'ils fonctionnent comme prévu.
  • Documenter vos intégrations : Ajoutez des descriptions claires pour chaque point d'accès 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 workflows !