Aller au contenu principal

Odoo Sync

Odoo Sync connecte votre espace de travail MonoChat à votre base de données Odoo, sur Odoo Online, Odoo.sh ou votre propre serveur. L'application :

  • envoie le nom, le numéro de téléphone, l'adresse e-mail et les champs de profil associés de vos clients à leur contact ou piste CRM dans Odoo, et en crée un s'il n'existe pas,
  • lit toutes les 10 minutes les contacts et pistes modifiés dans Odoo et met à jour les clients correspondants dans MonoChat,
  • publie chaque conversation fermée comme note dans le chatter du contact ou de la piste,
  • affiche les factures et commandes de vente du client à côté de la conversation, et envoie un lien de paiement pour une facture impayée,
  • enregistre le paiement sur la facture dans Odoo quand le client paie le lien.

Avant de commencer​

Il vous faut :

  1. Odoo 17 ou plus récent, avec accès à l'API. Odoo donne accès à l'API avec son plan Custom ; un Odoo que vous hébergez vous-même y a aussi accès.
  2. Une clé API. Dans Odoo, ouvrez Preferences › Account Security de l'utilisateur au nom duquel l'application agira et cliquez sur New API Key. Odoo n'affiche la clé qu'une fois : copiez-la. Odoo recommande un utilisateur dédié aux intégrations, avec seulement les accès nécessaires.
  3. Les applications Odoo que vous utilisez. Les contacts sont toujours synchronisés. Les pistes demandent l'application CRM, les commandes l'application Ventes et les factures l'application Facturation ou Comptabilité.
  4. Un système de paiement dans MonoChat pour envoyer des liens de paiement. L'application utilise votre système de paiement par défaut.

Connecter Odoo​

  1. Installez l'application depuis MonoStore.
  2. Ouvrez Paramètres › Odoo.
  3. Saisissez l'Odoo address (par exemple https://yourcompany.odoo.com) et le nom de la Database.
  4. Sur Odoo 18 et antérieur, saisissez dans Login (Odoo 18 and earlier) l'identifiant de l'utilisateur à qui appartient la clé API. Odoo 19 et ultérieur n'en ont pas besoin.
  5. Collez l'API key, cliquez sur Save, puis sur Test connection.

L'application utilise l'API JSON-2 d'Odoo à partir d'Odoo 19 et JSON-RPC sur les versions antérieures ; l'écran indique laquelle est utilisée. La clé API n'est plus jamais affichée ; laissez le champ vide pour garder celle enregistrée. Seuls le propriétaire ou un manager peuvent modifier ces paramètres. Si vous changez l'adresse ou la base de données, saisissez à nouveau la clé API.

Ce qui est synchronisé​

ParamètreCe qu'il fait
Sync customers withOù un client MonoChat est créé quand Odoo n'a pas de fiche pour lui : Contacts ou CRM leads.
Add new Odoo records with a phone number as MonoChat customersUn contact ou une piste créé dans Odoo après la connexion, avec un numéro de téléphone, devient un client MonoChat à qui votre équipe peut écrire.
Post each closed conversation to the record’s chatterQuand une conversation est fermée, ses messages depuis la dernière note (au plus les 100 derniers) sont publiés comme note dans le chatter. Les notes internes sont exclues.
JournalLe journal de banque ou de caisse où le paiement d'un lien payé est enregistré. Sans choix, Odoo décide.
Field mappingJusqu'à cinq champs de profil, chacun avec le nom technique d'un champ Odoo (Odoo l'affiche en mode développeur) et un sens : Both ways, To Odoo only ou From Odoo only. Le nom, le numéro de téléphone et l'adresse e-mail sont toujours synchronisés.
  • De MonoChat vers Odoo : quand le profil d'un client change, l'application trouve son contact ou sa piste par adresse e-mail ou numéro de téléphone, ou en crée un, et n'envoie que les valeurs modifiées.
  • D'Odoo vers MonoChat : toutes les 10 minutes, l'application lit les contacts et pistes modifiés dans Odoo et met à jour les clients qui y sont liés, ou le client ayant le même numéro de téléphone ou la même adresse e-mail. Une valeur venue d'Odoo n'y est pas renvoyée.
  • Quand le client d'une piste apparaît ensuite comme contact Odoo, le client est lié au contact.
  • Paramètres › Odoo indique quand la dernière lecture a eu lieu et son erreur si elle a échoué.
  • Un enregistrement qui ne peut pas être appliqué dans MonoChat n'arrête pas la lecture : l'écran indique combien ont été ignorés, avec le dernier et la raison.

À côté de la conversation​

La carte Odoo à côté de la conversation liste les dernières factures du client, avec le montant restant dû et leur état de paiement, ainsi que ses dernières commandes de vente. Sur une facture impayée, Send payment link envoie au client un message avec un lien de paiement du montant restant.

Dans vos flux​

Ajoutez un nœud Fonction à un flux sous Paramètres › Automatisation › Flux et choisissez l'un des nœuds de l'application. Voir Flux.

NœudCe qu'il faitSorties
Odoo · Send orders or invoicesEnvoie au client ses factures impayées ou ses dernières commandes de vente (numéro, montant et date) sous le titre que vous écrivez.Sent, None, Not in Odoo
Odoo · Send invoice payment linkCrée un lien de paiement pour la plus ancienne facture impayée du client, du montant restant, et l'envoie avec votre message. Placez {invoice}, {amount} et {link} dans le message.Sent, No invoice, Not in Odoo, No payment system

Not in Odoo signifie que l'application n'a trouvé aucun contact Odoo pour le client. Quand Odoo refuse la requête, le nœud prend sa branche d'échec.

Avec votre agent IA​

Ajoutez les outils de l'application à votre agent IA :

  • Odoo · Read the customer's orders and invoices donne à l'agent les dernières commandes de vente et factures du client, avec montants, dates et reste dû.
  • Odoo · Get an invoice payment link donne à l'agent un lien de paiement pour la facture que cite le client, ou sa plus ancienne facture impayée, à partager dans sa réponse.

Quand le client paie​

Un lien de paiement est dans la devise de la facture. Quand le client le paie, l'application enregistre le paiement sur la facture dans Odoo, dans le journal choisi, avec MonoChat et le numéro du paiement comme mémo. Une facture déjà payée dans Odoo n'est pas modifiée.

Bon à savoir​

  • Odoo ne peut pas encore notifier MonoChat, donc les changements d'Odoo arrivent dans MonoChat en moins de 10 minutes.
  • Les fiches modifiées dans Odoo avant la connexion ne sont pas lues. Un client est lié à Odoo quand son profil change, qu'une conversation se ferme ou que l'application lit un changement dans Odoo.
  • L'application agit dans Odoo en tant qu'utilisateur de la clé API : elle voit et modifie ce que cet utilisateur a le droit de voir et de modifier.