Skip to main content
The TalkChief integration for Odoo CRM does two things:
  • Logs every call in Odoo. Each finished TalkChief call is added as a note in the chatter of the matching Odoo lead, opportunity or contact, with the result, the agent, talk time and a link to the recording.
  • Puts TalkChief in Odoo’s top bar. With the TalkChief app installed in Odoo, agents click a phone number in Odoo, check it in the TalkChief panel and select Call. Incoming calls show the caller and their lead or contact in the same panel.
This guide is for Odoo Online databases (yourcompany.odoo.com), version 18, 19 or 20.

Get TalkChief Phone on the Odoo Apps store

Free. Download it for Odoo 18.0, 19.0 or 20.0, then follow Install the TalkChief app in Odoo.

What the integration does

  • Logs every external call: inbound and outbound calls are added as a note in the record’s chatter. Calls between two TalkChief extensions are not logged.
  • Finds the right record: TalkChief looks for an open lead or opportunity with exactly the caller’s number (or the number you dialed), then for a contact. Formats such as +15551234567, +1 555-123-4567 and a local number in the caller’s country match.
  • Shows who handled the call: the note’s author is the agent’s Odoo user when their email matches their TalkChief email, otherwise the record’s salesperson, otherwise the Odoo user whose API key you connected.
  • Can create leads for new numbers: when you turn on Create leads for new numbers, TalkChief creates a lead with the number and the caller ID name, assigned to the agent. It is off for new connections.
  • Links the recording: when the call was recorded, the note links to the recording.
  • Adds the agent’s note and outcome: after a call, the agent can add a note and an outcome in the TalkChief panel. They’re added to the same call note.
  • Adds the AI call summary, if you want: with AI transcription on, TalkChief can add the call’s AI summary to the same note once it’s ready, with a link to the full transcript. This is off until you turn it on.
  • Calls from Odoo’s top bar: click a phone number in Odoo and it goes into the TalkChief dial pad. Make and answer calls through your computer or your TalkChief phone. See Call from Odoo.
Each logged call looks like this in the chatter:
An Odoo chatter note: Outbound call, Answered, agent, talk time, time, recording link, call ID, Logged by TalkChief, and the agent's note with the outcome

A call logged by TalkChief, with the agent's note and outcome

Calls usually appear in Odoo within a minute or two of hanging up.

Before you start

  • You are a company admin in TalkChief.
  • Your Odoo database runs on Odoo Online (yourcompany.odoo.com), version 18 or later, with the CRM app.
  • You can sign in to Odoo as an administrator. You need it to install the TalkChief app and to create an API key that doesn’t expire.
  • Each agent who calls from Odoo has a TalkChief phone line.
  • One Odoo database can be connected to one TalkChief company.
Call logging uses Odoo’s external API. Odoo’s documentation lists API access under its Custom plan, so depending on your plan it may not be available. If Odoo refuses API access when you connect, TalkChief says Odoo refused API access; check your Odoo plan, then connect again.

Install the TalkChief app in Odoo

The TalkChief app adds TalkChief to Odoo’s top bar. It’s free, contains no Python code and stores nothing in Odoo.
1

Find TalkChief in the Odoo Apps store

Open TalkChief Phone on the Odoo Apps store for your Odoo version: 18.0, 19.0 or 20.0. Odoo shows your version in Settings, at the bottom of the page. Select Download for v …. You get a zip file.
The TalkChief Phone page on the Odoo Apps store, with the Download button and the 18.0, 19.0 and 20.0 versions
2

Turn on developer mode in Odoo

In Odoo, open Settings, scroll to the bottom and select Activate the developer mode.
3

Import the app

Open Apps and select Import Module in the top menu. Choose the zip file you downloaded, leave Force init and Load demo data unticked, and select Install.
Odoo's Import Module window with the module file field and the Install button
4

Reload Odoo

Reload the page. The TalkChief icon appears in Odoo’s top bar, for every user of the database.
Odoo.sh and on-premise: TalkChief currently works with Odoo Online databases (yourcompany.odoo.com) only, for both call logging and the top-bar panel.
To update the app later, download the new version from the store and import it the same way (leave Force init unticked).

Connect Odoo in TalkChief

Create an API key in Odoo

1

Open your preferences

Sign in to Odoo as an administrator, select your avatar in the top right, then Preferences (or My Preferences).
2

Create the key

Open the Account Security tab and select New API Key. Odoo asks for your password. Enter a description such as “TalkChief”. If Odoo asks for a scope, choose RPC. Choose Persistent Key as the duration, so the key doesn’t expire.
3

Copy the key

Copy the key Odoo shows. Odoo shows it only once. You don’t need to keep it anywhere else: paste it into TalkChief in the next step.
Keys of users who are not administrators expire after at most 3 months. When a key expires, the Odoo card in TalkChief asks you to reconnect with a new key.

Connect Odoo

1

Open Integrations in TalkChief

In the TalkChief web app, select Integrations under Configuration in the sidebar. The page opens on the CRM tab.
2

Start the connection

On the Odoo card, select Connect.
3

Enter your Odoo address and key

Enter your Odoo address (for example yourcompany.odoo.com; you can paste the address from your browser) and paste the API key, then select Connect.
4

Odoo 18 only: enter the login

If your database runs Odoo 18, TalkChief also asks for the login (the email) of the user who created the key. Enter it and select Connect again. Odoo 19 and later don’t need it.
5

Check the connection

The Odoo card moves to your connected integrations with a Connected label.
TalkChief stores the API key encrypted and uses it only to log calls and find callers in Odoo.

Choose what gets logged

On the connected Odoo card in Integrations, select the settings (gear) icon. The Odoo settings window shows the connected account and switches you can change at any time. Each change applies to calls that end afterwards.
TalkChief's Odoo settings window: Log calls, Log missed calls, Create leads for new numbers, Add the AI call summary to each call, and Disconnect
Add the AI call summary to each call needs AI transcription. Without it, the switch is locked and says what’s missing.

Call from Odoo

The TalkChief panel opens from Odoo’s top bar, so each agent can make and answer TalkChief calls without leaving Odoo.
1

Open TalkChief from the top bar

In Odoo, select the TalkChief icon in the top bar. The TalkChief panel opens in the corner of the page. Until someone opens it once in a browser, the app does nothing there.
The TalkChief panel in Odoo: Available status, the dial pad and the Call button
2

Sign in to TalkChief

Select Sign in and sign in with your TalkChief account in the window that opens. Each agent signs in once on their own computer.
3

Choose where calls ring

Open the panel’s menu (⋯) and, under Calls ring, choose This browser to talk through your computer, or My TalkChief phone to use your desk phone or the TalkChief app. With This browser, allow the microphone when your browser asks.
4

Place a call

On a lead, opportunity or contact, select Call next to the phone number (Odoo 20), or select the phone number itself (Odoo 18 and 19). The number goes into the TalkChief dial pad, with the matching record under it. Check it and select Call in the panel. Odoo never places a call by itself.
An Odoo lead with the Call button next to its phone number, and the TalkChief panel with the number and the matching lead in the dial pad
5

Receive a call

When a call comes in, the panel shows the caller and, when Odoo has their number, their lead or contact. Answer in the panel or on your TalkChief phone. Select Open record to see the record in Odoo; your Odoo page doesn’t change by itself, so nothing you were editing is lost.
6

Add a note and an outcome

When the call ends, type a note and pick an outcome in the panel. They are added to the call’s note in the chatter.
The panel works while Odoo is open in a browser tab. You can hide it with × and calls still come in. If the panel is hidden when a call comes in, you hear it ring (with This browser) or your TalkChief phone rings; open the panel to see the caller. The panel works only in the Odoo database your TalkChief company is connected to.

Data TalkChief uses in Odoo

With your API key, TalkChief: The TalkChief app in Odoo sends the TalkChief panel only the phone numbers you click, and the panel tells Odoo only which lead or contact to open when you select Open record. TalkChief doesn’t change your leads’ stages, values or other fields, and it doesn’t copy your Odoo records into TalkChief.

Disconnect Odoo

To stop logging calls, open Integrations in TalkChief and select the trash icon on the Odoo card (or Disconnect in the Odoo settings window), then confirm. When you disconnect:
  • Calls are no longer logged in Odoo. Calls that were waiting to be logged are dropped.
  • TalkChief deletes the API key it stored.
  • Notes and leads already in Odoo stay there. Nothing is deleted from Odoo.
The key itself keeps working in Odoo until you delete it: in Odoo, open Preferences > Account Security and delete the TalkChief key.

Uninstall the app from Odoo

To remove TalkChief from Odoo’s top bar, open Apps in Odoo, search for TalkChief Phone (remove the Apps filter in the search bar), open it and select Uninstall. Uninstalling the app doesn’t disconnect call logging; disconnect in TalkChief as well if you want logging to stop.

Troubleshooting

Enter the address of your Odoo Online database, such as yourcompany.odoo.com. Databases hosted on Odoo.sh or on your own servers are not supported yet.
Create a new key in Preferences > Account Security (scope RPC if Odoo asks) and try again.
Odoo refused TalkChief’s request to its external API. Odoo lists API access under its Custom plan, so check your Odoo plan, then connect again with your API key.
TalkChief works with Odoo 18 and later. Odoo upgrades Odoo Online databases regularly; connect again after your database is upgraded.
Odoo no longer accepts the API key, usually because it expired or was deleted. Create a new key (choose Persistent Key as an administrator) and select Reconnect. Calls that ended in the meantime are logged once you reconnect, as long as you reconnect within 7 days.
The user whose key you connected may not read or update leads and contacts. Give that user Sales: All Documents and Contacts: Creation, or connect with an administrator’s key.
TalkChief matches the record by its Phone field (and Mobile on Odoo 18), and only an exact match counts. Check that the record has the caller’s number there, preferably with its country code. Won and lost leads are skipped. If Create leads for new numbers is off, calls from numbers Odoo doesn’t have are not logged.
Install the TalkChief app (see Install the TalkChief app in Odoo), then reload the page.
Install the latest version of the app from the Odoo Apps store: download it and import it again (leave Force init unticked), then reload Odoo.
Open TalkChief from the top bar once in this browser; until then the app leaves phone numbers to Odoo. Numbers with an extension (such as ;ext=12) are left to your browser; type them in the panel instead.
You are signed in to a TalkChief company that is connected to a different Odoo database, so the panel doesn’t place or show calls. Open the panel’s menu (⋯), sign out, and sign in with the TalkChief company connected to this database.
Allow the microphone for app.talkchief.io in your browser, or open the panel’s menu (⋯) and select Open in its own window. Calls then ring in that window.
For anything else, contact TalkChief support at support@talkchief.io.