MailDesk docs
Using MailDesk

Link email to an Odoo record

4 min read Odoo 18.0

Connect an email to the Odoo record it is about, such as a lead, a ticket or an order. The email then appears in that record's chatter.

Who this is for: everyday MailDesk users. You need: MailDesk Pro, a connected mailbox, and normal Odoo access to the record you want to link. Edition notes: see Plans and included features.

A link joins one email to one Odoo record. Linked emails appear in the record's chatter, so colleagues see the correspondence there. Links are stored only in MailDesk and Odoo. Creating, changing or removing a link does not change the email on your mail server and sends nothing to the sender.

A link stays with the email when you archive it, move it to another folder or change its labels. MailDesk also carries the links to the other messages in the same conversation.

Before you begin

  • MailDesk Pro is installed and a mailbox is connected.
  • You can open the record type you want. If you cannot open CRM, for example, leads are not offered in the picker.
  • Optional: the matching integration (CRM, Helpdesk, Sales, Calendar) adds a side panel for that record type and lets you create a record from the email. An administrator installs it and switches it on for the mailbox.
  1. Open the email, or select one or more rows in the message list.
  2. Click Link to Record in the toolbar. You can also right-click a row and choose Link to Record…. The Connect Records window opens.
  3. Choose the kind of record. Tiles shows the record types your administrator set up. All models lets you pick any record type you may read; type in the filter box to find it, for example Lead/Opportunity or Ticket.
  4. Type a name, e-mail, tag or reference in the search box, then click the record in the results. To also show this email on the record itself, turn on Show this email on the linked record.
  5. Click a record in the results.

What you should see: the record is highlighted with a check and appears in the Linked Records list on the right. Click as many records as you need. Clicking a linked record again unlinks it.

The Connect Records window with the record type on the left, search results to click, and the Linked Records list on the right

Changes are saved at once

Changes are saved as soon as you select or remove a record. Closing the window does not undo them.

  1. To check a record first, use the eye button for a quick preview, or the arrow button to open it in a new browser tab.
  2. When you finish, click Save Changes or Cancel. Both buttons only close the window. They do not save or undo anything.

What you should see: the email shows the record in its Linked Records list, and the email appears in the record's chatter the next time the record is opened. See Discuss an email with your team.

  1. Open Link to Record on the email.
  2. In Linked Records, click the × next to the record, or click the record in the results.

What you should see: the record leaves the list at once. Only the link is removed. The email and the record are not deleted.

Create a record from an email (with an integration)

  1. Open the email.
  2. Open the panel of the integration, for example the CRM panel.
  3. Choose the create option, for example Create Lead/Opportunity.
  4. Complete and save the new record.

What you should see: the new record is linked to the email automatically.

Attach a reply to a record while you write it

  1. Start a reply or a new message.
  2. Click Bind to record in the composer and pick the record.
  3. Write and send the message.

What you should see: after sending, the message is linked to that record.

If one email is linked to several records of the same type, MailDesk marks one link as primary and the others as secondary. Replies you send and replies you receive are logged to the primary record's chatter. The first record you link, or the record you create from the email, becomes primary. This applies per record type, so an email can have a primary lead and a primary ticket.

If it does not work

You see Check Safe next step
No Link to Record button Pro is not installed, or the email is a draft The action is on received and sent emails, not drafts. Ask your administrator about Pro
No side panel for a record type The integration is not installed or not on for this mailbox You can still link with Link to Record
A record type is missing from the picker You have no Odoo access to that app Ask for the access
The email is not in the record's chatter The record was open before you linked Reload the record
You linked the wrong record Unlink it as described above

Next step

Discuss an email with your team