Comment connecter Odoo à BOTS4.me : guide d’installation du connecteur (Odoo 13–19)

🧭 Commencez par choisir votre chemin : où tourne votre Odoo ?

Il existe deux voies d’installation, et seul votre type d’hébergement Odoo détermine laquelle suivre. Toutes deux mènent au même résultat : une seule connexion sert toutes les applications BOTS4.me qui fonctionnent avec Odoo.

Vous ne savez pas quel hébergement vous avez — ou vous êtes encore en train de choisir ? Consultez Odoo Online vs Odoo.sh vs on-premise : lequel pouvez-vous automatiser ?

Remarque sur la formule : Odoo Online nécessite la formule Custom d’Odoo pour l’accès à l’API ; Odoo.sh et on-premise fonctionnent avec n’importe quelle formule.

🔌 Chemin A : Odoo.sh & on-premise — le connecteur en un clic

• Étape 1 — Créez votre compte BOTS4.me. Inscrivez-vous sur bots4.me/bots, ou sautez cette étape et créez le compte depuis Odoo à l’étape 3. Chaque application à démarrage gratuit commence ensuite par un mois Discovery gratuit.
• Étape 2 — Installez « BOTS4.me Connect ». Sur apps.odoo.com, ouvrez BOTS4.me Connect, choisissez votre version d’Odoo (13.0 à 19.0) et téléchargez le zip gratuit ; il contient un seul dossier, b4m_connect. On-premise : placez ce dossier dans un répertoire de votre chemin d’addons, redémarrez le service Odoo, activez le mode développeur, ouvrez Applications → Mettre à jour la liste des applications, recherchez « BOTS4.me Connect » et cliquez sur Activer (Installer sur les versions plus anciennes). Odoo.sh : committez le dossier dans votre dépôt (essayez d’abord une branche de staging) et poussez ; quand le build est vert, installez-le depuis Applications dans la base de ce build. Les modules mono-application du store (par exemple « Mail2ERP by BOTS4.me ») s’installent de la même façon et n’affichent que leur propre application. Le code source est sous LGPL-3 : vous ou votre intégrateur pouvez en lire chaque ligne avant l’installation.
• Étape 3 — Lancez l’assistant de connexion. En tant qu’administrateur Odoo, ouvrez BOTS4.me Connect → Paramètres et cliquez sur Connecter. Choisissez « Créer un nouveau compte sur www.bots4.me » (saisissez votre e-mail ; si un partenaire BOTS4.me nous a recommandés, indiquez son code dans Code partenaire) ou « J’ai déjà un compte sur www.bots4.me » (e-mail et mot de passe). Saisissez ensuite le code à 6 chiffres reçu par e-mail, ou celui de votre application d’authentification si vous en utilisez une. L’assistant communique directement avec bots4.me en HTTPS ; aucun identifiant n’est saisi sur un écran tiers.
• Étape 4 — Les clés sont générées pour vous. Après une connexion réussie, BOTS4.me émet une clé API et un secret de signature HMAC propres à cette base Odoo, et le module crée un utilisateur technique local, « BOTS4.me Connect », afin que les bots lisent et écrivent les enregistrements Odoo via XML-RPC sous leur propre identité, jamais avec votre identifiant administrateur personnel. Cet utilisateur reçoit uniquement les droits Odoo des applications que vous activez. Comme tout utilisateur interne, il compte dans un abonnement Odoo Enterprise facturé par utilisateur. Sur Odoo 18 et versions ultérieures, Odoo limite la durée de validité des clés API : lorsque le module affiche « La clé API expire bientôt », cliquez sur Déconnecter, puis sur Connecter, sans perdre aucun réglage d’application.
• Étape 5 — Les formulaires de configuration sont pré-remplis. Le connecteur transmet les métadonnées de votre Odoo (URL, UUID de la base, bloc de facturation de la société, adresses des serveurs de messagerie IMAP) afin de pré-remplir les formulaires de configuration BOTS4.me. Les mots de passe de messagerie restent dans votre Odoo jusqu’à ce que vous confiiez une boîte aux lettres à une application, soit avec + Ma messagerie IMAP (1 clic), soit en cliquant sur Démarrer le mois Discovery gratuit sur une application qui lit les e-mails. Ils sont chiffrés avant de quitter votre Odoo.
• Étape 6 — Activez votre première application. Sous Applications, chaque application affiche son statut (Non activé, Configuration requise, Actif, Configuré). Cliquez une fois sur Complétez d’abord la facturation, renseignez vos coordonnées de facturation sur bots4.me, puis cliquez sur Démarrer le mois Discovery gratuit sur l’application souhaitée. Ce seul clic active l’application, connecte cet Odoo comme son ERP et, pour les applications qui lisent les e-mails, lui confie votre boîte IMAP Odoo. Tout ce qui manque encore dispose de son propre bouton sur l’application : + Cet Odoo comme ERP (1 clic), + Ma messagerie IMAP (1 clic), + Boîte aux lettres (Gmail, Microsoft 365) ou + Stockage cloud. Tableau de bord, Journaux et Paramètres ouvrent bots4.me avec la session déjà ouverte.

☁️ Chemin B : Odoo Online — une mise en place sans code avec une clé API

Odoo Online (l’édition SaaS proposée sur odoo.com) n’autorise pas les modules Python personnalisés — c’est une règle de la plateforme, pas une limite de BOTS4.me. Le chemin Online passe donc par une clé API Odoo standard que vous créez vous-même (l’accès à l’API externe fait partie de la formule Custom d’Odoo), avec en option un module assistant XML sans code :

• Étape 1 — Créez votre compte BOTS4.me sur bots4.me/bots.
• Étape 2 — Créez une clé API Odoo. Dans votre base Odoo Online, rendez-vous dans Paramètres → Utilisateurs et sociétés → Utilisateurs → votre utilisateur → Sécurité du compte (activez le mode développeur si l’onglet est masqué) et cliquez sur Nouvelle clé API. Nommez-la « BOTS4.me », choisissez sa durée de validité (Odoo 18 et versions ultérieures le demandent) et copiez la clé ; Odoo ne l’affiche qu’une seule fois. Avant son expiration, créez-en une nouvelle et collez-la dans la même connexion Odoo sur bots4.me (Modifier → Mettre à jour le compte ERP).
• Étape 3 — Démarrez l’application et collez la clé sur bots4.me. Connectez-vous sur bots4.me/bots, cliquez sur Démarrer le mois Discovery gratuit sur la carte de l’application et acceptez une fois les Conditions — aucune carte bancaire requise. Ouvrez ensuite Paramètres (roue dentée) → l’application → Access Manager, cliquez sur Ajouter une destination ou Ajouter une source (l’application affiche celle dont elle a besoin), choisissez ERP → Odoo et renseignez l’URL Odoo (pour https://yourcompany.odoo.com, le nom de la base se remplit tout seul), votre e-mail de connexion dans Nom d’utilisateur et la clé API dans Mot de passe ou API Key. Cliquez sur Ajouter un compte ERP.
• Étape 4 — Ajoutez l’assistant sans code (facultatif). Le module « BOTS4.me for Odoo Online » sur apps.odoo.com ne contient que des enregistrements de données, aucun Python, donc Odoo Online l’accepte. Il ajoute à votre Odoo une application BOTS4.me avec Connexion / Tableau de bord, Guide de configuration et Comment créer une clé API. Dans tous les cas, les bots se connectent via l’API externe standard d’Odoo.
• Étape 5 — Vérifiez en DEMO. Dans l’onglet Contrôle de l’application, activez Alimentation du bot et laissez le Mode sur DEMO. Après la première exécution, vous recevez un e-mail de rapport DEMO listant ce que le bot a lu et ce qu’il aurait écrit, et l’onglet Journaux montre chaque décision ; rien ne change dans Odoo. Lorsque les rapports DEMO sont justes, réglez Mode sur LIVE dans l’onglet Contrôle — l’option se débloque après le premier e-mail de rapport DEMO.

🧭 Essayez-le pendant votre mois Discovery gratuit

Le premier mois de chaque application à démarrage gratuit est un mois Discovery gratuit : le volume d’utilisation de la formule Personal, avec de nombreuses fonctions Family et Business débloquées à l’essai, sans carte bancaire. Voici le chemin le plus court entre « connecté » et un premier résultat dans Odoo.

• 1 — Démarrez l’application. Dans Odoo (Odoo.sh, on-premise) : BOTS4.me Connect → Paramètres, cliquez une fois sur Complétez d’abord la facturation, puis sur Démarrer le mois Discovery gratuit sur l’application. Sur Odoo Online : connectez-vous sur bots4.me/bots, cliquez sur Démarrer le mois Discovery gratuit sur la carte de l’application et acceptez une fois les Conditions — aucune carte bancaire requise. Dans les deux cas, le tableau de bord affiche ensuite « Mois Discovery gratuit — encore N jours ».
• 2 — Connectez ce dont l’application a besoin. Dans Odoo, démarrer l’application connecte déjà cet Odoo et, si votre Odoo dispose d’un serveur de messagerie IMAP, sa boîte aux lettres. Utilisez + Cet Odoo comme ERP (1 clic) ou + Boîte aux lettres (Gmail, Microsoft 365) pour ce qui manque encore. Sur Odoo Online, ajoutez la connexion Odoo dans l’Access Manager comme décrit dans la voie B, et la boîte aux lettres avec Ajouter une source.
• 3 — Lancez-la en DEMO. Ouvrez l’onglet Contrôle de l’application (ou Contrôle rapide dans Odoo), activez Alimentation du bot et laissez le Mode sur DEMO. Les interrupteurs portant une étiquette Discovery dans l’onglet Contrôle sont inclus dans votre mois gratuit et démarrent désactivés — activez ceux que vous voulez essayer.
• 4 — Vérifiez le résultat. Lisez l’e-mail de rapport DEMO après la première exécution ainsi que l’onglet Journaux : chaque document que le bot a lu, et ce qu’il aurait créé ou modifié dans Odoo.
• 5 — Passez en LIVE. Lorsque les rapports DEMO sont justes, réglez Mode sur LIVE dans l’onglet Contrôle — l’option se débloque après le premier e-mail de rapport DEMO. Le bot écrit désormais dans Odoo via la connexion que vous avez mise en place, avec les droits de son utilisateur Odoo.
• 6 — Après le mois. À la fin du mois, l’application continue d’elle-même avec la formule gratuite et un petit quota mensuel : une fois celui-ci épuisé, les nouveaux éléments attendent le mois suivant ou que vous choisissiez une formule, et un élément déjà commencé est toujours terminé. Choisissez une formule pour conserver toutes les fonctions — consultez le tableau des formules sur la page produit de l’application.

🔒 Le modèle de sécurité, expliqué honnêtement

Vous donnez à un service externe l’accès à votre ERP : vous êtes en droit d’exiger des détails précis, et pas seulement un badge « sécurité de niveau bancaire ». Voici exactement comment BOTS4.me Connect est construit :

• HTTPS uniquement, en dur. Le point de terminaison de l’API est fixé à https://bots4.me dans le code du module — ce n’est pas un champ de configuration modifiable, si bien qu’un enregistrement de configuration compromis ne peut pas rediriger votre trafic API vers un serveur hostile. Chaque URL renvoyée par l’API est vérifiée avant que votre navigateur ne l’ouvre ; les réponses non HTTPS ou provenant d’un autre hôte sont rejetées.
• Signature des requêtes en HMAC-SHA256. Chaque appel que le module adresse à BOTS4.me est signé avec le secret propre à la base : les requêtes ne peuvent être ni falsifiées ni altérées en transit.
• Identifiants réservés aux administrateurs. La clé API, le secret de signature et les champs de l’utilisateur technique sont soumis à un contrôle d’accès au niveau des champs, limité au groupe admin d’Odoo (base.group_system). Les utilisateurs internes ordinaires voient le menu de lancement et l’état des applications, mais les secrets n’apparaissent dans aucune lecture d’enregistrement qu’ils pourraient exécuter — et toutes les actions de connexion, de déconnexion et de configuration sont réservées aux administrateurs.
• Open source, LGPL-3. Le code source complet est livré dans le zip que vous téléchargez sur apps.odoo.com, pour que votre intégrateur puisse vérifier exactement ce qui quitte votre serveur : des métadonnées pour pré-remplir les formulaires, un mot de passe de messagerie uniquement lorsque vous confiez cette boîte à une application (chiffré avant de partir), et jamais vos documents commerciaux.
• Une piste d’audit des deux côtés. Le module tient un journal local des connexions, des changements de configuration et des erreurs à l’intérieur d’Odoo ; le tableau de bord BOTS4.me conserve les journaux de décision complets de chaque exécution.
• Actualisation automatique des droits. Une tâche cron planifiée revérifie régulièrement vos abonnements : l’état des applications dans le menu de lancement reste à jour, et une application résiliée cesse rapidement d’être servie.

Pour en savoir plus sur la sécurité de la plateforme et l’accès graduel : bots4.me/security et les niveaux d’accès. La plateforme est hébergée dans l’UE, conçue pour le RGPD, et la 2FA est disponible sur chaque compte.

✅ Après la connexion : une seule connexion pour toutes les applications Odoo

Vous installez le connecteur une seule fois ; rien de plus à installer par application. Une seule connexion sert toutes les applications BOTS4.me qui fonctionnent avec Odoo : Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP et AutoCASH, plus AutoSTOCK, AutoPURCHASE et ClientFACTORY. AutoSPAM, Mail2CLOUD et Mail2KNOW n’ont besoin que d’une boîte mail, que le connecteur peut transmettre depuis votre Odoo en un clic. Vous démarrez chaque application séparément, depuis sa ligne dans Odoo ou sa carte sur bots4.me/bots.

Chaque application démarre en DEMO : elle lit, décide et vous envoie un rapport DEMO par e-mail, mais n’écrit rien. Lorsque les rapports DEMO sont justes, réglez Mode sur LIVE dans l’onglet Contrôle — l’option se débloque après le premier e-mail de rapport DEMO. Sur bots4.me, l’onglet Contrôle de chaque application regroupe Alimentation du bot, le Mode, le Mode IA (Désactivé, IA essentielle, IA Premium ou Ultra, selon l’application), la Planification d’exécution et les Heures de fonctionnement lorsque l’application en dispose, ainsi que ses interrupteurs de fonctions. L’onglet Journaux montre chaque décision. Dans Odoo, Contrôle rapide sur la ligne de l’application couvre Alimentation du bot, Planification d’exécution, Mode démo et Mode IA. Pour savoir quoi automatiser en premier, consultez le guide principal : Comment automatiser Odoo de bout en bout.

📚 Guides associés

• Commencez ici : Comment automatiser Odoo de bout en bout : de la commande par e-mail à la facture payée
• Hébergement : Odoo Online vs Odoo.sh vs on-premise : lequel pouvez-vous automatiser ?
• Premiers bots à connecter : Importer les commandes par e-mail dans Odoo · Rapprocher automatiquement les paiements bancaires des factures
• Pour les intégrateurs : Générez des revenus récurrents en tant que partenaire Odoo

🔗 Sources et lectures complémentaires

Documentation officielle et normes citées dans ce guide. Les liens externes s’ouvrent dans un nouvel onglet.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions