Prise en main guidée

Ce guide va de la création du compte au premier workflow. Chaque étape dit à qui elle s'adresse.

Quel est votre profil ?

• Dirigeant ou décideur : étapes 1, 2 et 8.
• Responsable métier : étapes 1 à 4, 6 et 7.
• Développeur ou intégrateur : toutes les étapes, surtout 3, 5 et 6.
• Administrateur système : étapes 3, 5 et 8, puis déploiement Podman.
• Délégué à la protection des données : conformité RGPD.

Étape 1 : créer le compte

Tous les profils

1. Ouvrez /auth/signup sur votre instance (en local : http://localhost:8080).
2. Renseignez les champs demandés et validez.
3. Connectez-vous sur /auth/login.
4. Saisissez le code à usage unique reçu par courriel (/auth/verify-otp). Le second facteur est actif par défaut (FORCE_2FA).
5. À la première connexion, l'assistant d'accueil s'ouvre (étape suivante). Si la connexion échoue, voir Questions fréquentes (« Comment me connecter ? »).

Les conditions générales prévoient un essai gratuit de 14 jours, sans engagement et sans carte bancaire. Il donne accès à l'ensemble des fonctionnalités de l'offre Pro. Sans souscription à la fin de l'essai, le compte est désactivé et les données sont conservées 30 jours avant suppression.

Étape 2 : l'assistant d'accueil

Tous les profils

À la première connexion, l'application ouvre /onboarding. L'assistant vous fait choisir :

Terminer l'assistant vous amène au tableau de bord (/dashboard). Aujourd'hui, le serveur ne retient de l'assistant que le fait de l'avoir terminé ou passé : langue, secteur, adresse Odoo et modèle de départ ne sont pas enregistrés, et l'organisation reçoit le niveau « essentiel » si elle n'a aucune souscription (voir Tarification). Prenez cinq minutes pour parcourir les pages principales :

Étape 3 : enregistrer vos identifiants

Développeur, administrateur système, responsable métier

Les identifiants permettent à Chatbotaurus de se connecter à vos outils (la page est décrite dans Sécurité et identifiants).

1. Ouvrez /credentials. Dans le menu, la page est dans la section Sécurité, visible à partir du plan Business ; sur un plan inférieur, ouvrez-la par son adresse (voir la section Navigation du Tableau de bord).
2. Cliquez sur la carte du service voulu (Odoo, n8n, Matomo, Nextcloud, entre autres).
3. Remplissez le formulaire : adresse du serveur, identifiant, clé d'API ou mot de passe applicatif selon le service.
4. Enregistrez.

Les identifiants sont chiffrés au repos en base (clé AT_REST_ENCRYPTION_KEY). Ils ne sont jamais réaffichés en clair : en modification, un champ secret laissé vide ou inchangé conserve la valeur enregistrée. Voir aussi OpenBao et gestion des secrets pour les secrets d'infrastructure.

Pour Odoo, le parcours complet (les quatre champs à renseigner, puis un premier appel d'outil) est dans Connecter Odoo à la passerelle MCP.

Étape 4 : tester le chat

Tous les profils

1. Ouvrez /chat.
2. Posez une question simple : « Bonjour, que sais-tu faire ? »
3. Observez la réponse. La page est décrite dans Chat.

Le chat parle à un workflow déployé : si le sélecteur de workflow est vide, créez d'abord un workflow (étape 6), puis revenez à cette étape.

Si un identifiant Odoo est enregistré, posez une question métier, par exemple « Combien de contacts dans le CRM ? ». Le registre d'outils Odoo compte 711 outils (mesure du 3 octobre 2026, odoo_tools_registry.rs).

Le modèle de dialogue par défaut est EuroLLM 1.7B, exécuté localement via Ollama, avec ministral-3:3b en repli. Il tourne sur le processeur : les réponses longues prennent quelques secondes. Pour utiliser un autre fournisseur, voir Fournisseurs.

Étape 5 : parcourir le catalogue de serveurs MCP

Développeur, administrateur système

Ouvrez /mcp-servers. Le catalogue se filtre par secteur et par catégorie (voir MCP et Orchestrateur). Le catalogue public compte 108 entrées dont 15 marquées « disponibles » (mesure du 3 octobre 2026) ; la page de l'application en liste 175.

Le déploiement en un clic n'est pas encore câblé. Les actions déployer, démarrer, arrêter et redémarrer un serveur du catalogue répondent 503 FEATURE_PENDING tant que l'adaptateur Podman n'est pas branché sur forge-api. C'est prévu (spec 16, tâche P5.5, route prévue ops/deploy). En attendant, un serveur se lance par le plan compose mgaas-vps2 (podman-compose.vps2.yml). Consulter le catalogue est possible dès maintenant (voir parcourir le catalogue de services).

Pour les dirigeants : cette étape relève de votre équipe technique.

Étape 6 : créer votre premier workflow

Responsable métier, développeur

Un workflow est une suite d'actions que vous assemblez sur un canvas (voir Workflows).

1. Ouvrez /workflows et créez un nouveau workflow.
2. Placez un nœud d'entrée (MCP Start) sur le canvas.
3. Ajoutez un nœud agent.
4. Ajoutez un nœud de sortie (MCP End).
5. Reliez les nœuds en tirant des lignes.
6. Configurez l'agent : modèle et consigne système.
7. Enregistrez, puis testez depuis /chat.

Un nœud est une brique du workflow. Un agent est un nœud qui s'appuie sur le modèle. Un connecteur est un nœud qui parle à un outil externe (Odoo, n8n, entre autres). Voir le glossaire.

Étape 7 : intégrer le chat à votre site

Développeur, responsable métier

1. Ouvrez /embeds : la page liste vos workflows.
2. Choisissez celui à publier ; le générateur d'intégration s'ouvre.
3. Réglez l'apparence (couleurs, message d'accueil).
4. Copiez le code généré et collez-le dans votre site.

Le code est un extrait <script> qui s'ajoute à n'importe quel site. Voir aussi Voix et Canaux pour la page Marque (widget).

Étape 8 : passer à une offre payante

Dirigeant, administrateur

Les prix publics sont sur la page /pricing. Tous sont HT et mensuels.

Le détail des offres et des capacités par plan est sur /pricing et dans la page Tarification, les délais de support dans SLA. La gestion de l'abonnement est sur /billing (voir Paramètres).

Liste de contrôle

Et ensuite

• Guide utilisateur
• Cas d'usage par secteur
• FAQ
• Une question : la page /contact de votre instance

Voir aussi

• Fournisseurs de modèles : changer de modèle ou brancher un fournisseur européen
• Utiliser les connecteurs MCP : où vivent les fiches et comment le catalogue est lu
• Glossaire : nœud, agent, connecteur, gateway : les termes définis
• Limites et ce que la plateforme ne fait pas : quotas par offre et limites de débit