Skip to main content

Odoo Sync

Odoo Sync connects your MonoChat workspace to your Odoo database, on Odoo Online, Odoo.sh or your own server. It:

  • sends your customers' name, phone number, e-mail address and mapped profile fields to their Odoo contact or CRM lead, and creates one when there is none,
  • reads the contacts and leads changed in Odoo every 10 minutes and updates the matching customers in MonoChat,
  • posts each closed conversation as a note in the chatter of the customer's contact or lead,
  • shows the customer's invoices and sales orders beside the conversation, and sends a payment link for an unpaid invoice,
  • registers the payment on the invoice in Odoo when the customer pays the link.

Before you start​

You need:

  1. Odoo 17 or later with API access. Odoo gives API access on its Custom plan; an Odoo you host yourself has it too.
  2. An API key. In Odoo, open Preferences › Account Security of the user the app should act as and press New API Key. Odoo shows the key once: copy it. Odoo recommends a dedicated user for integrations, with only the access it needs.
  3. The apps you use in Odoo. Contacts are always synced. Leads need the CRM app, orders the Sales app and invoices the Invoicing or Accounting app.
  4. A payment system in MonoChat to send payment links. The app uses your default payment system.

Connect Odoo​

  1. Install the app from MonoStore.
  2. Open Settings › Odoo.
  3. Enter your Odoo address (for example https://yourcompany.odoo.com) and the Database name.
  4. On Odoo 18 and earlier, enter the Login of the user the API key belongs to. Odoo 19 and later do not need it.
  5. Paste the API key and press Save, then Test connection.

The app uses Odoo's JSON-2 API on Odoo 19 and later and JSON-RPC on earlier versions; the screen shows which one it connected through. The API key is never shown again; leave it empty to keep the saved one. Only the owner or a manager can change these settings. When you change the address or the database, enter the API key again.

What is synced​

SettingWhat it does
Sync customers withWhere a MonoChat customer is created when Odoo has no record for them: Contacts or CRM leads.
Add new Odoo records with a phone number as MonoChat customersA contact or lead created in Odoo after you connect, with a phone number, becomes a MonoChat customer your team can message.
Post each closed conversation to the record's chatterWhen a conversation is closed, its messages since the last note (up to the last 100) are posted as a note in the chatter. Internal notes are left out.
JournalThe bank or cash journal the payment of a paid link is registered in. Without one, Odoo chooses.
Field mappingUp to five profile fields, each with the technical name of an Odoo field (Odoo shows it in developer mode) and a direction: Both ways, To Odoo only or From Odoo only. Name, phone number and e-mail address are always synced.
  • From MonoChat to Odoo: when a customer's profile changes, the app finds their contact or lead by e-mail address or phone number, or creates one, and sends only the values that changed.
  • From Odoo to MonoChat: every 10 minutes the app reads the contacts and leads changed in Odoo and updates the customers they are linked to, or the customer with the same phone number or e-mail address. A value that came from Odoo is not sent back.
  • When a lead's customer later appears as an Odoo contact, the customer is linked to the contact.
  • Settings › Odoo shows when the last read ran and its error, if it failed.
  • A record that cannot be applied in MonoChat does not stop the read: the screen shows how many were skipped, with the last one and why.

Beside the conversation​

The Odoo card beside the conversation lists the customer's latest invoices, with what is still due and whether they are paid, and their latest sales orders. On an unpaid invoice, Send payment link sends the customer a message with a payment link for the amount still due.

Use it in your flows​

Add a Function node to a flow under Settings › Automation › Flows and pick one of the app's nodes. See Flows.

NodeWhat it doesOutputs
Odoo · Send orders or invoicesSends the customer their unpaid invoices or their latest sales orders (number, amount and date) under the heading you write.Sent, None, Not in Odoo
Odoo · Send invoice payment linkCreates a payment link for the customer's oldest unpaid invoice, for the amount still due, and sends it with your message. Write {invoice}, {amount} and {link} in the message where they go.Sent, No invoice, Not in Odoo, No payment system

Not in Odoo means the app found no Odoo contact for the customer. When Odoo refuses the request, the node takes its failed branch.

Use it with your AI agent​

Add the app's tools to your AI agent:

  • Odoo · Read the customer's orders and invoices gives the agent the customer's latest sales orders and invoices, with amounts, dates and what is still due.
  • Odoo · Get an invoice payment link gives the agent a payment link for the invoice the customer names, or their oldest unpaid one, to share in its reply.

When the customer pays​

A payment link is in the invoice's currency. When the customer pays it, the app registers the payment on the invoice in Odoo, in the journal you chose, with MonoChat and the payment's number as its memo. An invoice that is already paid in Odoo is left as it is.

Good to know​

  • Odoo cannot notify MonoChat yet, so changes from Odoo reach MonoChat within 10 minutes.
  • Records changed in Odoo before you connect are not read. A customer is linked to Odoo when their profile changes, a conversation closes or the app reads a change in Odoo.
  • The app acts in Odoo as the user of the API key: it sees and changes what that user may.