Comment connecter Odoo à Voxbi : guide de configuration étape par étape
Récupérez quatre identifiants Odoo, configurez l'intégration dans le Voxbi Cockpit et vérifiez l'enregistrement des appels. Un guide complet pour Odoo 16 à 19.
Ce guide vous explique comment connecter votre instance Odoo à Voxbi afin que chaque appel soit automatiquement enregistré sur le bon contact. Si vous souhaitez d'abord comprendre le contexte (ce que fait l'intégration, le click-to-call, les transcriptions et le screen-pop), consultez l'aperçu de l'intégration Odoo VoIP. Lorsque vous êtes prêt à configurer, suivez les étapes ci-dessous.
Le processus se déroule en deux phases. La phase 1 est la préparation : vous collectez quatre informations dans Odoo. La phase 2 est l'installation : vous saisissez ces quatre valeurs dans le Voxbi Cockpit, qui se charge du reste.
Avant de commencer
Ce guide prend environ 15 minutes : environ 5 minutes pour rassembler vos informations Odoo, puis quelques minutes dans le Voxbi Cockpit pendant qu'il installe et configure le module pour vous. Vous n'installez rien dans Odoo manuellement.
Vous aurez besoin d'un accès administrateur au Voxbi Cockpit (
cockpit.voxbi.com) et d'un utilisateur Odoo disposant des droits administrateur (un utilisateur dédié à l'intégration est plus propre et plus facile à auditer).
Versions Odoo prises en charge : 16, 17, 18 et 19, sur Odoo Online, Odoo.sh et les déploiements auto-hébergés. Vérifiez votre version avant de commencer.
Phase 1 : collectez vos identifiants Odoo
Avant d'ouvrir le Cockpit, récupérez ces quatre informations depuis votre instance Odoo.
1. URL Odoo (l'adresse de l'instance)
L'adresse web complète que vous utilisez pour accéder à votre instance Odoo.
| Type Odoo | Comment la trouver | Exemple |
| Odoo Online (Cloud) | L'URL affichée dans la barre d'adresse de votre navigateur après connexion. | `https://masociete.odoo.com` |
| Odoo auto-hébergé | L'adresse configurée par votre administrateur système. | `https://odoo.mon-domaine.com` ou `http://localhost:8069` |
2. Nom de la base de données Odoo
Le nom de la base de données garantit que l'intégration se connecte à la bonne source de données.
| Type Odoo | Comment le trouver | Exemple |
| Odoo Online (Cloud) | Le sous-domaine de votre URL (par exemple, `masociete` dans `https://masociete.odoo.com`). Vous pouvez aussi vérifier dans votre espace bases de données sur `https://www.odoo.com/my/databases`. | `masociete` |
| Odoo auto-hébergé | Demandez à votre administrateur système, ou consultez le fichier de configuration du serveur (par exemple `/etc/odoo/odoo.conf`) et cherchez le paramètre `db_name`. | `prod_db_2024` |
3. Nom d'utilisateur ou e-mail Odoo
Utilisez l'e-mail ou le nom d'utilisateur d'un compte Odoo disposant des droits administrateur. Nous recommandons de créer un utilisateur dédié à l'intégration avec un accès administrateur complet, pour plus de clarté et une meilleure traçabilité.
4. Clé API Odoo (le jeton de sécurité)
La clé API est le mot de passe sécurisé que le Cockpit utilise pour se connecter. Elle n'est affichée qu'une seule fois : copiez-la immédiatement et conservez-la en lieu sûr.
Pour générer la clé API :
Connectez-vous à Odoo avec le compte administrateur que vous utiliserez pour l'intégration.
Cliquez sur votre photo de profil (en haut à droite) et choisissez Mon profil ou Préférences.
Ouvrez la section Sécurité du compte ou Clés API.
Cliquez sur Nouvelle clé API.
Donnez un nom explicite à la clé, par exemple
Intégration Voxbi.Confirmez avec votre mot de passe Odoo si nécessaire.
Copiez la clé générée à l'écran.
Phase 2 : configurez l'intégration dans le Voxbi Cockpit
Une fois les quatre identifiants en main, configurez l'intégration dans le Voxbi Cockpit.
Étape 1 : ouvrez le Cockpit et choisissez Odoo
Rendez-vous sur
cockpit.voxbi.com.Connectez-vous avec vos identifiants administrateur.
Ouvrez Intégrations et sélectionnez + Nouvelle intégration.
Choisissez Odoo dans la liste des intégrations disponibles.
Étape 2 : remplissez le formulaire de configuration
Renseignez le formulaire avec les identifiants collectés en phase 1.
| Champ | Valeur à saisir | Remarques |
| URL Odoo | L'adresse complète de votre instance Odoo. | Par exemple, `https://masociete.odoo.com` |
| Nom de la base de données | Le nom de votre base de données Odoo. | Par exemple, `masociete` |
| Clé API | La clé sécurisée que vous avez générée. | Ce n'est pas votre mot de passe Odoo. |
| Nom d'utilisateur ou e-mail | L'e-mail ou le nom d'utilisateur de l'administrateur Odoo. | Assurez-vous que cet utilisateur dispose des droits administrateur complets. |
Activez ensuite le bouton Actif et enregistrez l'intégration.
Étape 3 : suivez l'installation automatique
Lorsque vous enregistrez, Voxbi lance l'installation automatiquement. Il :
Se connecte à votre instance Odoo.
Installe le module Voxbi dans Odoo.
Configure le module pour la synchronisation des appels.
Pendant l'installation, suivez le journal en direct (le panneau noir sur la page) pour des mises à jour en temps réel. Le statut de l'intégration passe à Connecté dès que la connexion est établie, et le journal se termine par un message de réussite lorsque le module est installé et configuré.
Étape 4 : vérifiez le module dans Odoo
Connectez-vous à votre instance Odoo.
Accédez à Applications.
Vérifiez que le module Voxbi est présent et installé.
Une fois le module visible, ses fonctionnalités (enregistrement des appels et synchronisation des contacts) s'activent automatiquement et les appels commencent à se synchroniser. La première synchronisation complète s'effectue en environ une heure. Les utilisateurs sont associés entre Voxbi et Odoo par adresse e-mail : si les appels d'un utilisateur ne se synchronisent pas, vérifiez que son adresse e-mail est identique dans les deux systèmes.
Étape 5 (facultative) : passer et recevoir des appels directement dans Odoo
Si vous souhaitez que votre équipe puisse passer et recevoir des appels directement depuis le module VoIP natif d'Odoo :
Retournez dans les paramètres de l'intégration Odoo dans le Voxbi Cockpit.
Activez Synchroniser les configurations SIP avec Odoo pour tous les utilisateurs.
Enregistrez les modifications.
Cette option synchronise les paramètres SIP de chaque utilisateur, afin que les appels fonctionnent dans Odoo sans configuration individuelle.
Résolution des problèmes courants
La plupart des problèmes de configuration proviennent d'un identifiant incorrect ou d'un manque de droits. Consultez ce tableau avant de nous contacter.
| Symptôme | Cause probable | Solution |
| Le statut ne passe jamais à Connecté | URL Odoo ou nom de base de données incorrect | Utilisez l'adresse complète incluant `https://`, et le nom de base de données exact (le sous-domaine pour Odoo Online). |
| « Authentication failed » | La clé API est incorrecte ou vous avez saisi votre mot de passe | La clé API n'est pas votre mot de passe Odoo. Elle n'est affichée qu'une seule fois : régénérez-en une nouvelle si vous n'êtes pas sûr et collez-la à nouveau. |
| Le module Voxbi n'est pas visible dans Odoo | Installation en cours ou liste des applications non actualisée | Attendez que le journal se termine par un message de réussite, puis actualisez Applications dans Odoo. |
| Aucun appel ne se synchronise | Première synchronisation non terminée ou statut pas Connecté | La première synchronisation complète prend environ une heure. Vérifiez que l'intégration affiche Connecté dans le Cockpit. |
| Les appels d'une personne ne se synchronisent pas | Adresse e-mail différente | Les utilisateurs sont associés par e-mail. Vérifiez que l'adresse e-mail de cette personne est identique dans Voxbi et dans Odoo. |
| Odoo auto-hébergé ne peut pas se connecter | Pare-feu bloquant Voxbi | Autorisez l'accès entrant depuis Voxbi vers votre instance Odoo, ou demandez à votre administrateur système de l'ouvrir. |
Questions fréquentes
Combien de temps avant que les appels apparaissent dans Odoo ?
La connexion est instantanée. La première synchronisation complète s'effectue en environ une heure, puis les appels s'enregistrent en quasi temps réel.
Dois-je installer quoi que ce soit dans Odoo moi-même ?
Non. Dès que vous enregistrez l'intégration dans le Voxbi Cockpit, Voxbi installe et configure son module Odoo automatiquement. Vous pouvez ensuite le vérifier dans Applications.
La clé API est-elle identique à mon mot de passe Odoo ?
Non. C'est un jeton de sécurité distinct que vous générez dans votre profil Odoo, et Odoo ne l'affiche qu'une seule fois. Copiez-le immédiatement.
Que se passe-t-il lorsque je mets à jour Odoo ?
Votre intégration suit la mise à jour. Les paramètres, les appels enregistrés et la synchronisation sont conservés, et Voxbi prend en charge Odoo 16 à 19.
Puis-je utiliser Odoo Community Edition ?
Oui. Le même module et la même configuration fonctionnent sur les déploiements Community. Consultez la page Voxbi pour Odoo Community pour plus de détails.
Besoin d'aide ?
Si vous êtes bloqué ou si vous rencontrez une erreur pendant la configuration, écrivez-nous à hello@voxbi.com. Joignez une capture d'écran du panneau de journal du Cockpit et de tout message d'erreur Odoo pour que nous puissions vous aider plus rapidement. Pour en savoir plus sur ce que fait l'intégration au quotidien, consultez l'aperçu de l'intégration Odoo VoIP. Vous utilisez Odoo Community Edition ? La page Voxbi pour Odoo Community couvre tous les détails.