Importer ou exporter un parcours conversationnel

Comment exporter un parcours ? #

Dans le module Réseaux sociaux, deux endroits proposent l'export :

• depuis Paramètres Social > Bot Designer, l'action Exporter sur la ligne du parcours ;
• depuis l'éditeur du parcours, l'entrée Exporter du menu ….

Un fichier est téléchargé et un message confirme « Parcours exporté ».

⚠️ L'export porte sur la version enregistrée du parcours : enregistrez vos modifications avant d'exporter, sinon elles ne partiront pas dans le fichier.

Comment importer un parcours ? #

L'import se fait en trois étapes — Déposer, Vérifier, Importer — depuis Paramètres Social > Bot Designer :

1. Cliquez sur Importer un parcours en haut de la liste (ou, dans l'éditeur, sur Importer dans le menu …).
2. Déposer : glissez votre fichier JSON dans la zone prévue, ou cliquez pour le choisir. Un seul fichier, dans la limite de taille indiquée. Vous pouvez aussi coller le JSON directement avec « Ou collez le JSON directement », puis Lire ce JSON.
3. Vérifier : cliquez sur Vérifier. Le fichier est contrôlé par les mêmes règles que l'enregistrement, sans rien créer. Chaque point relevé indique s'il bloque l'import.
4. Importer : quand tout est en ordre, l'écran récapitule le nom, le graphe, les déclencheurs et les canaux. Cliquez sur Importer le parcours.

Le parcours est créé inactif : vous pouvez le relire dans l'éditeur avant de l'activer.

💡 Un import crée toujours un nouveau parcours ; il ne remplace jamais un parcours existant.

Où trouver le format de fichier attendu et un gabarit ? #

À l'étape Déposer de l'assistant d'import (Paramètres Social > Bot Designer > Importer un parcours), la section Format attendu décrit tout ce que le fichier peut contenir :

• Un parcours, c'est : son nom, sa description, ses nœuds (identifiant, type, position, données), ses liaisons (départ, arrivée, libellé), sa priorité et ses réglages de déclenchement (premier message, mots-clés, canaux, service, fréquence, inactivité, présence des conseillers, relance).
• Types de nœuds : les briques acceptées et ce que chacune attend.
• Actions, Conditions, Déclencheurs : les valeurs acceptées pour chaque réglage.
• Alias acceptés : d'autres écritures de clés, reconnues à la lecture et normalisées à l'import.
• Plafonds : les limites de votre organisation (nombre de nœuds, de liaisons, d'options par question, longueurs de textes, nombre de parcours…).
• Exemple minimal — s'importe tel quel.

Le bouton Télécharger le gabarit récupère ce parcours minimal et valide, prêt à compléter : trois nœuds reliés, aucun canal ciblé, déclenché au premier message.

💡 Un fichier exporté depuis Sphère peut être réimporté tel quel ; un fichier écrit à la main peut poser le parcours directement à la racine, sans l'enveloppe de l'export.

Comment lire les points relevés par la vérification ? #

À l'étape Vérifier de l'assistant d'import, le verdict est l'un des trois suivants :

• Aucun point relevé — rien à corriger.
• Le fichier peut être importé — des avis ont été relevés : ils ne bloquent pas l'import, mais l'éditeur en tiendra compte.
• Le fichier ne peut pas être importé en l'état — il y a au moins un point bloquant.

Un décompte résume ce qui a été trouvé : points relevés, bloquants, avis, réparables, à corriger à la main. Les points sont ensuite rangés en groupes : Réparable automatiquement, À corriger dans le fichier, Avis — à revoir dans l'éditeur.

Chaque point est expliqué en trois temps :

• Pourquoi : ce qui ne va pas, en clair.
• Correction ou À faire : ce qui sera réparé, ou ce que vous devez changer dans le fichier.
• Le contexte : le nœud, la liaison, le canal ou le service concerné, et le cas échéant la valeur mesurée face à la limite.

Comment utiliser « Corriger automatiquement » ? #

À l'étape Vérifier de l'assistant d'import, quand des points sont marqués Réparable d'un clic :

1. Cliquez sur Corriger automatiquement.
2. Un aperçu Ce qui va changer dans votre fichier liste chaque réparation, une par une (identifiant attribué ou raccourci, doublon renommé, liaison incomplète retirée, texte tronqué, options d'une question ramenées à la limite, canal non connecté retiré, service introuvable détaché, nœud de départ ajouté, nœuds sans position rangés automatiquement…).
3. Validez avec Appliquer et revérifier.
4. Les réparations sont appliquées en mémoire, puis le fichier est vérifié de nouveau. S'il reste des points à corriger à la main, ils restent affichés.
5. Télécharger le fichier corrigé récupère la version réparée, si vous voulez la conserver.

⚠️ Votre fichier d'origine n'est jamais modifié. Les réparations s'appliquent à une copie en mémoire, et seul le téléchargement explicite vous rend un fichier corrigé.

Mon fichier est refusé à l'import : que faire ? #

Dans l'assistant d'import de Paramètres Social > Bot Designer, un refus nomme toujours la règle en cause. Les cas les plus fréquents :

• Ce fichier n'est pas un JSON lisible ou ne décrit pas un objet : le fichier est abîmé, ou ce n'est pas un parcours. Repartez du gabarit.
• Ce fichier ne décrit pas un parcours valide / Le format de ce fichier n'est pas pris en charge : vérifiez le format et la version annoncés, d'après la section Format attendu.
• Ce fichier dépasse la taille autorisée : un parcours exporté depuis Sphère n'atteint jamais cette taille — vous n'avez probablement pas déposé le bon fichier.
• Un plafond dépassé (nœuds, liaisons, options d'une question) : découpez le parcours en plusieurs parcours plus courts, ou simplifiez les branchements.
• Le nombre maximal de parcours est atteint : supprimez un parcours existant avant d'importer celui-ci.
• Un canal inconnu ou non connecté, un service introuvable : ces points-là se réparent d'un clic, le canal ou le rattachement étant simplement retiré.

Après correction, revenez à l'étape Déposer et déposez le fichier à nouveau.