Passer à la navigation

Odoo

Recherchez des appelants parmi vos contacts Odoo et ajoutez les nouveaux appelants comme prospects CRM.

Votre réceptionniste peut vérifier si un appelant figure déjà parmi vos contacts Odoo et ajouter de nouveaux appelants à Odoo CRM en tant que prospects, avec leurs besoins, afin que votre équipe commerciale puisse assurer le suivi. Deux options s’offrent à vous :

  • Les outils webhook appellent directement l’API JSON-2 d’Odoo, sans compte Zapier ni utilisation de tâches Zapier. Ils nécessitent Odoo 19 ou version ultérieure, Community ou Enterprise, hébergé sur odoo.com, Odoo.sh ou votre propre serveur.
  • Zapier fonctionne aussi avec les anciennes versions d’Odoo, mais chaque action utilise des tâches de votre forfait Zapier et ne peut pas rechercher une base de données auto-hébergée.

Utilisez les outils webhook si votre base de données fonctionne sous Odoo 19 ou une version ultérieure. L’ancienne API d’Odoo, JSON-RPC, reçoit les arguments de chaque méthode sous la forme d’une liste mixte de valeurs que les outils webhook ne peuvent pas construire. Pour les versions antérieures, utilisez donc Zapier.

Odoo autorise uniquement les applications externes à accéder à vos données avec son forfait Custom. Si votre base de données est hébergée par Odoo avec le forfait One App Free ou Standard, vérifiez votre forfait avant de commencer.

Option 1 : Outils webhook (recommandé)

1

Vérifier votre version d’Odoo

Votre version d’Odoo est indiquée en bas de la page Paramètres. Les outils webhook nécessitent la version 19 ou une version ultérieure. Pour une base de données auto-hébergée, le serveur doit être accessible depuis Internet via HTTPS.

2

Créer un utilisateur pour Reception.ai

Dans Paramètres → Utilisateurs et entreprises → Utilisateurs, créez un utilisateur interne pour Reception.ai. Accordez-lui l’accès Ventes : Utilisateur : tous les documents, sans accès aux autres applications, afin que la clé API ne puisse effectuer que les actions nécessaires aux outils. L’accès Utilisateur : tous les documents lui permet d’attribuer les nouveaux prospects au commercial de votre choix.

3

Créer une clé API

Les clés API des utilisateurs qui ne sont pas administrateurs durent au maximum trois mois. Pour obtenir une clé valable un an :

  1. En tant qu’administrateur, activez le mode développeur, puis accédez à Paramètres → Utilisateurs et entreprises → Groupes.
  2. Créez un groupe nommé, par exemple, Clé API Reception.ai, définissez Durée maximale des clés API en jours sur 365, puis ajoutez-y l’utilisateur Reception.ai.

Connectez-vous ensuite en tant qu’utilisateur Reception.ai, ouvrez Préférences → Sécurité du compte, puis sélectionnez Nouvelle clé API. Nommez-la, par exemple, Reception.ai, choisissez la durée maximale proposée et copiez immédiatement la clé : Odoo ne l’affiche qu’une seule fois. Notez sa date d’expiration et remplacez-la avant cette date.

La clé API peut faire tout ce que l’utilisateur Reception.ai est autorisé à faire. Ne la placez pas dans des documents partagés et supprimez-la dans Odoo en cas de fuite.

4

Trouver les ID du commercial et de l’équipe commerciale

Ouvrez l’utilisateur du commercial dans Paramètres → Utilisateurs et entreprises → Utilisateurs. Le numéro à la fin de l’adresse de la page est l’ID utilisateur. Faites de même pour l’équipe commerciale dans CRM → Configuration → Équipes commerciales.

5

Créer les outils webhook

Pour chaque outil ci-dessous, accédez à Intégrations, sélectionnez Ajouter une intégration, puis choisissez Outil webhook. Remplacez YOUR_ODOO_ADDRESS par l’adresse de votre base de données, par exemple mycompany.odoo.com.

Chaque outil envoie les mêmes en-têtes de requête :

  • Authorization (Secret) : Bearer suivi de votre clé API
  • X-Odoo-Database (Valeur) : le nom de votre base de données. Requis uniquement si votre propre serveur héberge plusieurs bases de données.

Rechercher l’appelant

ChampValeur
Nomfind_odoo_contact
Description« Recherchez l’appelant parmi nos contacts à partir de son adresse email ou de son nom complet s’il n’a pas d’email. Utilisez cet outil avant d’ajouter un prospect. »
MéthodePOST
URLhttps://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search
En-têtes de requêteAuthorization (Secret) : Bearer suivi de votre clé API
X-Odoo-Database (Valeur) : le nom de votre base de données, uniquement si nécessaire
Paramètres du corpsname (chaîne, requis) : « L’adresse email de l’appelant ou son nom complet tel qu’il l’épelle. »
operator (chaîne, valeur fixe) : =ilike
limit (entier, valeur fixe) : 5
Attribuer aux agentsRéceptionniste

L’opérateur =ilike correspond au nom complet ou à l’adresse email, sans tenir compte des majuscules. Une recherche sur « Jane » ne liste donc pas toutes les personnes nommées Jane. Odoo renvoie uniquement l’ID et le nom de chaque résultat. La recherche de contacts d’Odoo ne couvre pas les numéros de téléphone : votre réceptionniste doit donc demander une adresse email ou un nom.

Ajouter l’appelant comme prospect

ChampValeur
Nomcreate_odoo_lead
Description« Ajoutez l’appelant à notre CRM comme prospect lorsqu’il souhaite un devis ou être rappelé. »
MéthodePOST
URLhttps://YOUR_ODOO_ADDRESS/json/2/crm.lead/create
En-têtes de requêteAuthorization (Secret) : Bearer suivi de votre clé API
X-Odoo-Database (Valeur) : le nom de votre base de données, uniquement si nécessaire
Paramètres du corpsvals_list (objet, requis), avec les champs ci-dessous
Attribuer aux agentsRéceptionniste

Odoo attend les champs du nouveau prospect dans un objet vals_list. Sélectionnez Ajouter un champ sur vals_list pour chacun des éléments suivants :

  • name (chaîne, requis, issu de la conversation) : « Le titre du prospect, par exemple : Devis cuisine - Jane Doe. »
  • contact_name (chaîne, requis, issu de la conversation) : « Le nom complet de l’appelant. »
  • email_from (chaîne, issu de la conversation) : « L’adresse email de l’appelant, s’il l’a fournie. »
  • phone (chaîne, requis, issu de la conversation) : « Le numéro de téléphone de l’appelant au format international, par exemple +14155550123. »
  • description (chaîne, requis, issu de la conversation) : « Les besoins de l’appelant, en quelques phrases. »
  • user_id (entier, valeur fixe) : l’ID utilisateur du commercial
  • team_id (entier, valeur fixe) : l’ID de l’équipe commerciale

Le commercial et l’équipe sont des valeurs fixes : chaque prospect leur est donc attribué, même si l’IA envoie d’autres ID. Omettez les champs tels que le chiffre d’affaires attendu, afin que votre réceptionniste ne fasse pas d’estimation de montant.

Sélectionnez Activer sur chaque outil, puis testez votre réceptionniste en tant que contact existant fournissant son adresse email, puis en tant que nouvel appelant demandant un devis. Le nouveau prospect apparaît dans votre pipeline Odoo CRM.

Option 2 : Zapier

1

Connecter Zapier

Si ce n’est pas encore fait, connectez Zapier dans Reception.ai.

2

Ajouter les actions Odoo

Dans votre serveur MCP Zapier sur mcp.zapier.com, ajoutez les actions ci-dessous de l’application Odoo CRM et connectez-vous à Odoo lorsque Zapier vous le demande. Pour chaque champ, définissez une valeur fixe ou laissez l’IA le renseigner, comme indiqué.

L’application Odoo CRM fonctionne avec les bases de données hébergées sur odoo.com. Pour une base de données auto-hébergée, consultez les limitations.

Les actions peuvent effectuer tout ce que l’utilisateur Odoo avec lequel vous vous connectez est autorisé à faire. Envisagez d’utiliser un utilisateur dédié ayant accès uniquement au CRM et aux contacts.

3

Attribuer les outils

Dans Reception.ai, ouvrez l’onglet Outils de l’intégration Zapier, sélectionnez Actualiser les outils, puis attribuez chaque action au Client (réceptionniste).

4

Tester

Testez votre réceptionniste en tant que contact existant fournissant son adresse email, puis en tant que nouvel appelant demandant un devis. Le nouveau prospect apparaît dans votre pipeline Odoo CRM.

Actions Zapier

Rechercher l’appelant

ChampValeur
Action ZapierRechercher un contact
Définir dans ZapierRien.
Laisser l’IA renseignerL’adresse email de l’appelant ou son nom complet s’il n’a pas d’email.
Attribuer àClient

L’application Zapier d’Odoo recherche les contacts par nom ou adresse email, et non par numéro de téléphone. Votre réceptionniste doit donc demander l’un de ces éléments.

Ajouter l’appelant comme prospect

ChampValeur
Action ZapierCréer un prospect
Définir dans ZapierLe commercial et l’équipe commerciale auxquels attribuer les nouveaux prospects, si votre compte affiche ces champs.
Laisser l’IA renseignerLe titre du prospect (par exemple, « Devis cuisine - Jane Doe »), le nom, l’email et le numéro de téléphone du contact, ainsi qu’une description des besoins de l’appelant.
Attribuer àClient

Laissez vides les champs tels que le chiffre d’affaires attendu, afin que votre réceptionniste ne fasse pas d’estimation de montant.

Quelle que soit l’option choisie, ajoutez une procédure afin que votre réceptionniste demande l’adresse email de l’appelant et le recherche avant de créer un prospect.

La recherche peut renvoyer des contacts qui ne sont pas l’appelant, et Rechercher un contact dans Zapier renvoie toutes les informations enregistrées sur le contact. Ajoutez une règle indiquant à votre réceptionniste de ne jamais communiquer les informations d’un contact à l’appelant et de les utiliser uniquement pour reconnaître l’appelant.

Limitations

  • Votre réceptionniste ne peut pas rechercher les appelants par numéro de téléphone. Il lui faut leur adresse email ou leur nom exact.
  • La description du prospect contient ce que souhaitait l’appelant. L’application Odoo CRM de Zapier ne propose aucune action pour ajouter une note ou consigner un appel.
  • Avec les outils webhook, la clé API expire. Remplacez-la avant sa date d’expiration, sinon les outils cessent de fonctionner.
  • Avec Zapier, une base de données Odoo auto-hébergée nécessite à la place l’application Odoo ERP Self Hosted de Zapier. Son action Créer un prospect/opportunité ajoute des prospects, mais ne propose aucune action de recherche. Un appelant récurrent peut donc être ajouté deux fois. Les outils webhook peuvent rechercher une base de données auto-hébergée sous Odoo 19 ou une version ultérieure.
  • Votre réceptionniste ne peut pas vérifier les disponibilités ni planifier des rendez-vous dans Odoo. Utilisez plutôt la réservation intégrée de Reception avec Google Calendar.
  • Avec Zapier, chaque action exécutée par votre réceptionniste utilise des tâches de votre forfait Zapier. Zapier compte actuellement deux tâches par appel réussi ; les appels échoués ne sont pas comptabilisés. Lorsque le forfait est épuisé, les actions s’arrêtent jusqu’à sa réinitialisation.

Résolution des problèmes

ProblèmeVérifications à effectuer
Erreur 401 d’OdooL’en-tête doit être Authorization avec Bearer , un espace et la clé. Vérifiez que la clé n’a pas expiré ou n’a pas été supprimée.
Erreur 404 d’OdooVérifiez l’adresse et que l’URL se termine par /json/2/res.partner/name_search ou /json/2/crm.lead/create. Votre base de données doit fonctionner sous Odoo 19 ou une version ultérieure, et CRM doit être installé.
Odoo renvoie une erreur d’accèsL’utilisateur Reception.ai doit disposer de l’accès Ventes : Utilisateur : tous les documents.
Odoo ne trouve pas la base de donnéesAjoutez l’en-tête X-Odoo-Database avec le nom de votre base de données.
Une action Odoo n’apparaît pas dans Reception.aiSélectionnez Actualiser les outils dans l’intégration Zapier après avoir ajouté des actions dans Zapier.
Une action affiche Modifiée et n’est pas utiliséeVous l’avez modifiée dans Zapier. Sélectionnez Mettre à jour dans l’onglet Outils.
Zapier ne peut pas se connecter à OdooVérifiez que votre forfait Odoo autorise les applications externes et que vous utilisez l’application adaptée à l’emplacement d’hébergement de votre base de données.
Les appelants connus ne sont pas trouvésVérifiez l’orthographe de l’adresse email avec l’appelant. Les recherches par nom nécessitent le nom tel qu’il est enregistré dans Odoo. Un contact appartenant à une entreprise est enregistré sous la forme du nom de l’entreprise, d’une virgule, puis du nom de la personne.
Les prospects sont attribués au mauvais commercial ou à la mauvaise équipeDéfinissez le commercial et l’équipe commerciale comme valeurs fixes, dans l’outil webhook ou dans Zapier.