Connecter Odoo

À quoi sert cette connexion ?

Odoo permet à ELChat de consulter et piloter plusieurs activités depuis une seule connexion : CRM, ventes, stock, comptabilité, support, rendez-vous, connaissances, projets et fabrication. ELChat détecte les modules installés et n’expose que les outils correspondants.

Ce dont vous avez besoin

Identifiant	Rôle dans ELChat	Exemple fictif
URL de l’instance	Adresse de votre espace Odoo	https://monentreprise.odoo.com
Nom de la base	Sélectionne la base à utiliser	monentreprise-production
Email utilisateur	Identifie l’utilisateur Odoo dédié	integration@exemple.com
Clé API	Authentifie cet utilisateur pour les appels externes	odoo_xxxxxxxxxxxxxxxxxxxxx

ELChat utilise les droits et règles d’accès de l’utilisateur Odoo. Créez de préférence un utilisateur d’intégration et accordez-lui uniquement les modules et opérations nécessaires.

Prérequis Odoo

L’accès à l’API externe est réservé au forfait Odoo Custom pour Odoo Online ; il n’est pas disponible dans les forfaits One App Free et Standard. Une installation auto-hébergée peut avoir ses propres règles.

Le connecteur ELChat utilise actuellement l’API JSON-RPC historique à l’adresse /jsonrpc. Odoo 19 annonce son remplacement futur par JSON-2. La date de retrait varie dans la documentation officielle mise à jour : planifiez une migration du connecteur avant le retrait effectif.

Étape 1 — Créer la clé API Odoo

1. Connectez-vous avec l’utilisateur dédié à ELChat.
2. Ouvrez le menu utilisateur puis Préférences ou Mon profil.
3. Ouvrez l’onglet Sécurité du compte.
4. Cliquez sur Nouvelle clé API.
5. Saisissez une description claire, par exemple ELChat — site principal.
6. Choisissez la durée proposée adaptée à votre politique.
7. Cliquez sur Générer la clé et copiez-la immédiatement.

La clé n’est affichée qu’une fois. La procédure et les restrictions de forfait sont détaillées dans la documentation Odoo 19 de l’API RPC externe.

Trouver le nom de la base

Sur une installation multi-base, utilisez le nom exact de la base fourni par votre administrateur Odoo. Il peut aussi apparaître dans le sélecteur ou l’URL de gestion des bases selon le déploiement.

Information à compléter : ELChat ne peut pas déduire automatiquement le nom de base avant la connexion. Demandez-le à l’administrateur Odoo si votre interface ne l’affiche pas.

Étape 2 — Connecter Odoo à ELChat

1. Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
2. Sur la carte Odoo, cliquez sur Connecter.
3. Renseignez l’URL complète de l’instance.
4. Renseignez le nom exact de la base.
5. Renseignez l’email de l’utilisateur d’intégration.
6. Collez la clé API.
7. Validez.

Étape 3 — Vérifier la connexion

Vérifiez l’état Connecté, puis demandez une lecture simple d’un module installé, par exemple rechercher un produit ou lister des tâches projet. ELChat met en cache la détection des modules pendant six heures : après l’installation d’un nouveau module, sa capacité peut ne pas apparaître immédiatement.

Que peut faire ELChat avec Odoo ?

Module Odoo détecté	Capacités réellement disponibles	Type
CRM (crm)	Créer/rechercher un contact ; créer, rechercher, consulter et qualifier un prospect ; journaliser une activité	Lecture et écriture
Ventes (sale)	Rechercher/consulter des produits ; créer un devis ; consulter/rechercher une commande ; confirmer une commande	Lecture et écriture confirmée
Stock (stock)	Consulter le stock, les entrepôts et les mouvements	Lecture
Comptabilité (account)	Rechercher/consulter et créer une facture ; enregistrer un paiement	Lecture et écriture confirmée
Assistance (helpdesk)	Créer, consulter, rechercher, mettre à jour et clôturer un ticket ; charge, satisfaction et temps de réponse	Lecture et écriture
Rendez-vous (appointment)	Consulter les disponibilités, réserver et annuler	Lecture et écriture confirmée
Connaissances (knowledge)	Rechercher, consulter et créer un article	Lecture et écriture
Projet (project)	Lister/rechercher, créer et mettre à jour une tâche	Lecture et écriture
Fabrication (mrp)	Rechercher et suivre les ordres de fabrication ; vérifier les composants	Lecture

Les capacités d’un module non installé restent indisponibles. ELChat ne supprime pas d’enregistrements Odoo et ne configure pas les modules.

Reconnecter ou déconnecter

Créez une nouvelle clé dans Odoo, reconnectez ELChat et testez une lecture avant de révoquer l’ancienne. Pour déconnecter, cliquez sur Désactiver, puis supprimez la clé dans Préférences > Sécurité du compte.

Problèmes fréquents

Aucun outil Odoo n’apparaît

ELChat n’a pas pu détecter les modules installés. Vérifiez l’URL, la base, la clé, le forfait API et le droit de lire les modules. Attendez aussi l’expiration du cache de six heures après une installation.

Accès refusé sur un modèle

L’utilisateur d’intégration ne possède pas le groupe ou la règle d’accès nécessaire. Corrigez ses droits dans Odoo sans lui donner un rôle administrateur général si ce n’est pas requis.

Clé expirée

Les versions récentes d’Odoo peuvent imposer une durée aux clés. Générez une nouvelle clé, reconnectez ELChat, testez, puis révoquez l’ancienne.

Connexion après une mise à niveau Odoo

Si /jsonrpc n’est plus disponible, la version actuelle du connecteur doit être migrée vers l’API JSON-2 avant de pouvoir fonctionner.

Sécurité et limites

Une clé API Odoo possède les mêmes droits métier que son utilisateur. Utilisez un compte dédié, limitez ses groupes, activez une durée raisonnable et planifiez sa rotation. Les validations, règles d’enregistrement et modules personnalisés peuvent modifier le résultat d’une action.