# Odoo Connectez un serveur Odoo pour que l'agent trouve les contacts par téléphone et crée des commandes > Full REST + WebSocket API reference: https://api.happ.tools/reference Odoo se connecte avec les informations de votre serveur et un login utilisateur — Happ s'authentifie directement auprès de votre instance Odoo, ce qui fonctionne aussi bien avec Odoo Online qu'en auto-hébergé. Une fois la liaison établie, l'agent trouve les contacts par numéro de téléphone et crée des commandes depuis la conversation. ## Avant de commencer [#before-you-start] * **Instance Odoo** accessible depuis Internet — Odoo Online (`mycompany.odoo.com`) ou votre propre serveur. * **URL du serveur, nom de la base de données et login utilisateur** avec l'autorisation de lire les contacts et de créer des commandes. * **Mot de passe ou clé API** de cet utilisateur (voir ci-dessous — la clé API est l'option la plus sûre). * **Espace de travail HAPP** avec au moins un agent configuré pour parler aux clients. ## Obtenir une clé API [#get-an-api-key] Vous pouvez vous connecter avec le mot de passe habituel de l'utilisateur, mais une clé API est plus sûre — elle est limitée à une intégration et vous pouvez la révoquer sans changer le mot de passe du compte. 1. Dans votre tableau de bord Odoo, cliquez sur l'**avatar** en haut à droite et choisissez **My Preferences**. 2. Passez à l'onglet **Sécurité**, cliquez sur **Add API Key**, puis saisissez votre mot de passe actuel pour confirmer votre identité. 3. Donnez un nom à la clé (par exemple `Happ`) et **changez la durée de « 1 Day » à « 1 an »** — sinon la clé expire au bout de 24 heures. Cliquez sur **Create key** et copiez-la. Odoo n'affiche la clé API qu'une seule fois. Copiez-la avant de fermer la fenêtre — si vous la perdez, vous devrez en générer une nouvelle. Odoo affiche la clé générée une seule fois, dans une fenêtre que vous ne pouvez pas rouvrir ## Connexion [#connect] 1. Dans HAPP, ouvrez **Intégrations** et trouvez Odoo sous **Ajouter un CRM**. 2. Cliquez sur **Connecter** — la fenêtre demande quatre champs. 3. Saisissez-les et cliquez sur **Connecter**. | Champ | Valeur | | --------------- | -------------------------------------------------------------------------- | | URL du serveur | L'adresse de votre instance, par ex. `https://mycompany.odoo.com` | | Base de données | Le nom de la base de données | | Login | L'e-mail de l'utilisateur | | Mot de passe | Le mot de passe Odoo de l'utilisateur, **ou** la clé API générée ci-dessus | Odoo passe dans **Mes intégrations** sous forme de carte affichant ses **Informations du compte** — nom de l'instance et date et heure de connexion. ## Paramètres [#settings] Ouvrez l'icône d'engrenage de la carte pour configurer ce que l'agent est autorisé à faire. * **Recherche** — l'agent recherche les contacts par numéro de téléphone dans la base Odoo. * **Créer** — l'agent crée des commandes liées au contact, avec le nom du produit dans les notes. ## Dépannage [#troubleshooting] | Problème | Cause | Solution | | --------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Échec de l'authentification | Login, mot de passe ou base de données incorrect | Odoo exige que les quatre valeurs correspondent. Vérifiez le nom de la base — une instance peut en héberger plusieurs, et le nom n'est pas toujours identique au sous-domaine. | | La clé ne fonctionne plus après un jour | La clé API a été créée avec la durée par défaut « 1 Day » | Générez une nouvelle clé et réglez la durée sur **1 an**. | | 401 sur une clé qui fonctionnait | Un administrateur l'a révoquée, ou le mot de passe de l'utilisateur a changé | Générez une nouvelle clé API dans **My Preferences** > **Sécurité** et reconnectez-vous dans HAPP. | | Serveur inaccessible | Instance auto-hébergée non exposée, ou bloquée par un pare-feu | L'URL doit être accessible depuis Internet en HTTPS. Autorisez les IP sortantes de HAPP si vous filtrez par IP. | | Les commandes ne sont pas créées | Synchronisation mal configurée ou autorisations manquantes | Vérifiez que **Créer** est activé dans **Paramètres** et que l'utilisateur Odoo a le droit de créer des commandes. | Toujours bloqué ? [Contactez le support](https://happ.tools/contacts) avec le texte de l'erreur et nous vous indiquerons la solution exacte. ## Déconnexion et reconnexion [#disconnect-and-reconnect] **Pour déconnecter :** ouvrez **Intégrations** > **Odoo**, cliquez sur **Déconnecter** à côté de l'instance connectée et confirmez. Après la déconnexion : * Les nouvelles commandes issues des conversations ne sont plus envoyées à Odoo. * Les enregistrements existants dans Odoo restent intacts. * L'agent continue de fonctionner dans les conversations — seule la synchronisation Odoo s'arrête. * La clé API n'est **pas** révoquée dans Odoo. Révoquez-la là-bas séparément si nécessaire. **Pour reconnecter :** ouvrez **Intégrations** > **Odoo**, cliquez sur **Connecter** et saisissez à nouveau les quatre champs. Conservés après la reconnexion : les paramètres de recherche et de création, le mappage des champs, la liaison agent-instance et l'analytique de l'intégration. ## Pour aller plus loin [#next] * [CRM](/docs/integrations/crm) — toutes les intégrations CRM * [Outils](/docs/agents/tools) — appelez le CRM pendant les conversations * [Intégrations](/docs/integrations) — le catalogue complet