Connect Odoo
What connecting Odoo does, from caller names to calls logged back, and how to get its details and connect it.
Odoo is Odoo's CRM and business apps. This article explains what connecting it does and how to connect it.
What it does
Your Odoo contacts are copied into your company contacts, so a caller Odoo knows shows by name on every desk phone and app before anyone picks up, and in your call history afterwards.
With call logging on, every finished call is filed in Odoo on the matching record: who took it, how long it lasted, missed calls and voicemails, and the call summary. You can log texts too (one note per conversation once it goes quiet for half an hour), and add a link to the call in the portal. When Odoo doesn't know the caller, you choose to skip the call, or create a new contact.
Contacts sync every 15 minutes (only what changed), with a full sync each day that also removes contacts deleted there.
Before you start
- Plan: On Odoo Online, the Custom plan: the One App Free and Standard plans don't include the external API.
- On our side: a company administrator connects it, once, for the whole company.
Get your details from Odoo
- In Odoo, open your profile and choose Preferences (or My Profile).
- On the Account Security tab, click New API Key.
- Give it a description and a duration, click Generate Key and copy it: it is shown once.
Connect it
- In the portal, go to Contacts and click Connect a CRM (or Connect another CRM). You can also start from Company > Integrations.
- Choose Odoo and fill in:
- Click Connect & sync. The first sync runs straight away and says how many contacts came across.
- To file calls in Odoo, tick Log finished calls into Odoo on the connection, and choose what happens when Odoo doesn't know the caller.
- Odoo URL (https://company.odoo.com): your Odoo address - Database name: on Odoo Online, your instance name: mycompany in mycompany.odoo.com. Elsewhere, ask whoever hosts your Odoo - Login email: the email of the user who made the key - API key: the key from step 3
If it says Needs attention
The connection's card on Company > Integrations shows the last error. The usual causes:
- The key was reset, expired or deleted in Odoo: make a new one and connect again with it.
- The person who made the key lost access or left: make the key as someone who is staying.
- On current Odoo versions an API key lasts at most three months. Make a new one and paste it in before it runs out; the connection says Needs attention when it has.
- Odoo 20 removes the API this connection uses today. Check with support before you upgrade to Odoo 20.
Press Sync now on the connection to try again straight away. To stop, press Disconnect: contacts already copied stay in your contacts, and calls already logged stay in Odoo.
