
# Odoo

> **À qui cela s'adresse-t-il ?** Aux entreprises qui utilisent Odoo — le catalogue de produits, le pipeline CRM, les bons de commande — et qui souhaitent que leur agent IA puisse les utiliser directement dans le chat. Si vous n'utilisez pas Odoo, vous pouvez ignorer cette page.
>
> Vous utilisez un autre CRM ou ERP ? Tout système doté d'une API peut être connecté : consultez [Connecter un outil que nous ne listons pas](connecting-other-tools.md).

Odoo est une suite d'applications professionnelles : Ventes, CRM, Inventaire, Facturation et bien d'autres, toutes fonctionnant sur une seule base de données. Connecter Odoo à <span data-t="appName">DM Champ</span> permet à votre agent IA d'effectuer trois actions au cours d'une conversation normale, sans que personne n'ait à créer de webhook ou de fonction personnalisée :

- **Répondre aux questions sur les produits de votre catalogue.** Noms, prix avec la devise et la taxe appropriées, stock, descriptions, tout est lu en direct depuis Odoo.
- **Transmettre un prospect à votre équipe commerciale.** Lorsqu'un client manifeste un intérêt pour l'achat, l'IA crée un prospect (ou une opportunité) dans votre CRM Odoo avec un résumé de ses besoins.
- **Informer un client de l'état de sa commande.** Statut, articles, facturation et progression de la livraison pour les commandes propres au client.

---

## Ce dont vous avez besoin

- Odoo **14 ou version ultérieure** : Odoo Online, Odoo.sh ou votre propre serveur.
- Un **utilisateur** Odoo en tant que lequel l'IA agira. Ce que cet utilisateur peut voir et faire dans Odoo constitue la limite de ce que l'IA peut voir et faire. Un utilisateur dédié ayant accès aux Ventes, au CRM et à l'Inventaire est idéal ; vous n'avez pas besoin d'un administrateur.
- La **clé API** de cet utilisateur. Dans Odoo, cliquez sur le nom de l'utilisateur (en haut à droite) → **Préférences** → **Sécurité du compte** → **Nouvelle clé API**. Donnez-lui un nom comme "Agent IA" et copiez la clé : Odoo ne l'affiche qu'une seule fois.

---

## Connecter Odoo

1. Dans la barre latérale gauche, cliquez sur **Paramètres** (icône en forme d'engrenage).
2. Dans la barre latérale des paramètres, sous le groupe **Intégrations**, cliquez sur **CRM & ERP**.
3. Sur la carte **Odoo**, cliquez sur **Connecter**.

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-odoo.png" alt="La section des paramètres CRM &amp; ERP avec une carte Disponible affichant la tuile Odoo et un bouton Connecter, ainsi qu'une note indiquant que cela fonctionne avec Odoo 14 ou une version ultérieure en utilisant une clé API de l'un de vos utilisateurs Odoo"><figcaption><p>Paramètres → CRM &amp; ERP avant la connexion : un bouton Connecter, et le rappel que ce que l'utilisateur Odoo connecté peut voir est ce que l'IA peut voir.</p></figcaption></figure>
:::

4. Remplissez l'**adresse Odoo** : l'adresse à laquelle vous vous connectez, par exemple `https://acme.odoo.com`. Vous pouvez coller l'adresse complète depuis votre navigateur.
5. La **base de données** est facultative. Laissez-la vide et nous la détecterons si votre serveur ne possède qu'une seule base de données. Si votre serveur en possède plusieurs, ou masque la liste, saisissez le nom : sur Odoo Online, il s'agit généralement de la première partie de votre adresse (`acme` pour `acme.odoo.com`).
6. Remplissez le **login utilisateur Odoo** (l'e-mail avec lequel l'utilisateur se connecte) et la **clé API** obtenue à l'étape précédente.
7. Cliquez sur **Connecter**.

::: master-only
<figure><img src="../.gitbook/assets/v2-odoo-connect-modal.png" alt="La boîte de dialogue Connecter Odoo avec des champs pour l'adresse Odoo, la base de données, le login utilisateur Odoo et la clé API, chacun avec une indication en dessous, ainsi que des boutons Annuler et Connecter"><figcaption><p>Tout ce dont la connexion a besoin, sur un seul écran : l'adresse à laquelle vous vous connectez, la base de données (facultative), l'utilisateur Odoo en tant que lequel l'IA agira, et la clé API de cet utilisateur.</p></figcaption></figure>
:::

### Vérification des identifiants

Rien n'est enregistré tant qu'Odoo ne l'a pas confirmé. Lorsque vous cliquez sur **Connecter**, nous vérifions que l'adresse correspond bien à un serveur Odoo, nous nous connectons avec le login et la clé API sur cette base de données, et nous lisons ce que l'utilisateur peut atteindre dans les applications Produits, CRM, Ventes et Inventaire. Une adresse erronée, une base de données erronée, un login ou une clé erronés, ou un utilisateur sans accès est refusé immédiatement, avec la raison affichée à l'écran.

Lorsque cela fonctionne, la carte connectée affiche l'entreprise et la version d'Odoo, la base de données à laquelle l'IA est connectée et l'utilisateur en tant que lequel elle agit.

Votre clé API est stockée de manière chiffrée et n'est plus jamais affichée, ni pour vous, ni pour votre équipe. Vous l'avez perdue ? Créez une nouvelle clé dans Odoo et reconnectez-vous.

### Ce que l'IA peut faire

La carte connectée comporte trois commutateurs. Les trois sont activés après la connexion ; désactivez ce que vous ne voulez pas que l'IA manipule :

- **Réponse à partir du catalogue produits** — noms des produits, prix, taxes, stock et descriptions.
- **Création de pistes dans le CRM** — nouvelles pistes ou opportunités issues des conversations.
- **Consultation des commandes d'un client** — statut de la commande et de la livraison.

Ces paramètres s'appliquent à chaque agent pour lequel Odoo est activé. Si l'utilisateur connecté n'a pas pu accéder à l'une des applications lors de la connexion (par exemple, si l'Inventaire n'est pas installé), la carte l'indique sous cet interrupteur.

### Suspendre ou déconnecter

- **Mettre en pause** empêche tous les agents d'utiliser Odoo tout en conservant la configuration de la connexion. **Activer** la réactive.
- **Déconnecter** supprime complètement la connexion. Les pistes déjà créées par l'IA restent dans Odoo. Vous pourrez vous reconnecter plus tard avec les mêmes informations.

---

## Activer Odoo pour un agent IA

La connexion à Odoo ne modifie pas encore le comportement de votre IA. Activez-la agent par agent :

1. Cliquez sur **Agents IA** dans la barre latérale et ouvrez l'agent.
2. Allez à l'étape **Capacités de l'IA** et faites défiler jusqu'à la carte **Odoo**. La carte n'apparaît qu'une fois Odoo connecté.
3. Activez **Utiliser Odoo dans les conversations de cet agent**. La modification est enregistrée immédiatement.

La carte liste ce que cet agent peut désormais faire, en fonction des commutateurs sous Paramètres → CRM & ERP. Un agent de support et un agent commercial sur le même compte peuvent différer : activez-le pour celui qui doit utiliser Odoo.

---

## Ce que l'IA peut faire

### Questions sur les produits

Lorsqu'un client pose une question sur un produit, un prix, la disponibilité en stock ou demande « vendez-vous X », l'IA recherche dans votre catalogue Odoo avant de répondre. Elle examine les produits marqués comme **Peut être vendu** dans Odoo, en faisant correspondre le nom du produit, la référence interne et le code-barres, et répond avec le prix et la devise, si la taxe est incluse, le niveau de stock pour les produits stockables, et la description de vente. Si rien ne correspond, elle demande au client un autre nom ou un code produit au lieu de deviner.

### Pistes

Lorsqu'un client manifeste un réel intérêt d'achat — demande un devis, souhaite être rappelé, veut commander quelque chose que l'IA ne peut pas traiter dans le chat, demande une démonstration — l'IA recueille les informations dont votre équipe commerciale a besoin (quoi exactement, combien, quand, budget si proposé, nom et e-mail) et crée un enregistrement dans votre CRM Odoo :

- Une **piste** si votre CRM utilise l'étape Pistes (CRM → Configuration → Paramètres → Pistes), sinon une **opportunité** dans votre pipeline.
- Le numéro de téléphone, l'e-mail et le nom du client sont extraits du contact dans <span data-t="appName">DM Champ</span>, et l'enregistrement est lié au client correspondant dans Odoo s'il existe.
- Si ce client a déjà une piste ou une opportunité ouverte, l'IA ajoute la nouvelle demande en tant que note au lieu de créer un doublon.

L'enregistrement porte un titre tel que « Devis pour 20 chaises de bureau » et un résumé rédigé pour votre équipe, ainsi qu'une note précisant le canal par lequel la conversation a eu lieu.

Tester un agent dans le terrain de jeu (playground) ne crée jamais rien dans Odoo : l'IA vous indique ce qu'elle aurait créé.

### Statut de la commande

Lorsqu'un client demande où se trouve sa commande, ce qu'il a commandé ou si elle a été expédiée, l'IA recherche ses commandes dans Odoo et répond avec la référence de la commande, le statut (devis, confirmé, terminé ou annulé), la date, le total, les articles, la facturation et l'état de la livraison avec un numéro de suivi lorsque votre transporteur en fournit un.

L'IA ne montre au client que ses **propres** commandes :

- Sur WhatsApp, SMS et autres canaux téléphoniques, les commandes sont associées au numéro à partir duquel le client écrit (et à l'e-mail figurant sur sa fiche contact, s'il y en a un).
- Sur le chat de votre site web, où l'identité de personne n'est vérifiée, l'IA demande **à la fois** la référence de la commande et l'adresse e-mail utilisée pour passer la commande, et n'affiche la commande que lorsque les deux correspondent.

Il n'y a aucun moyen pour l'IA de lister les commandes d'autres personnes ou de rechercher une commande par sa seule référence.

---

## Bon à savoir

- **Un Odoo par compte.** Si vous gérez plusieurs entreprises dans des bases de données Odoo distinctes, connectez celle que votre Agent doit utiliser.
- **L'utilisateur Odoo est la limite.** L'IA voit exactement ce que cet utilisateur peut voir. Donnez à l'utilisateur l'accès aux applications Ventes, CRM et Inventaire dans Odoo, et rien que l'IA ne devrait toucher.
- **Odoo reste la source de vérité.** Rien d'Odoo n'est copié dans <span data-t="appName">DM Champ</span> ; chaque réponse lit Odoo en direct à ce moment-là.
- **Les numéros de téléphone sont mis en correspondance de manière souple.** Un client dont le numéro est enregistré dans Odoo sous la forme `06 12 34 56 78` est tout de même trouvé lorsqu'il écrit depuis `+31 6 12345678`.
- **Odoo inaccessible ?** L'IA s'excuse, répond à ce qu'elle peut à partir de votre base de connaissances et alerte votre équipe si le client a besoin d'une réponse immédiate.

---

## Étapes suivantes

- [Agents IA](../ai-agents/ai-agents.md) — configurez l'Agent qui utilisera Odoo.
- [Base de connaissances](../ai-automation/faq-management.md) — ajoutez vos politiques, délais de livraison et règles de retour afin que l'IA puisse également répondre au sujet du catalogue.
- [Connecter un outil que nous ne listons pas](connecting-other-tools.md) — pour tout ce qui concerne Odoo et que les trois capacités ci-dessus ne couvrent pas (fonctions personnalisées, webhooks, l'API).
