MailDesk docs
Odoo integrations

Create tickets from email

4 min read Odoo 18.0

Turn a support email into an Odoo Helpdesk ticket, link an email to a ticket that already exists, and keep the conversation on the ticket.

Who this is for: support agents (daily use) and MailDesk administrators (one-time setup per mailbox).

You need:

  • The MailDesk Helpdesk Integration module (maildesk_mail_client_helpdesk).
  • MailDesk Pro, and MailDesk Basic below it.
  • The Odoo Helpdesk app. This is an Odoo Enterprise app.
  • At least one Helpdesk team, and a connected mailbox that syncs.

Which MailDesk edition includes this module is described in Plans and included features.

Before you begin

  • Install the module and check that Helpdesk is installed. Install steps are in Install MailDesk.
  • Administrators: turn the integration on for each mailbox that needs it (Step 1). It is off by default.
  • Agents: you need normal Odoo Helpdesk access, including membership of the team whose tickets you create or edit. The panel works as you, so the Helpdesk access rules still apply. See Security and access rights.

Step 1: Turn on Helpdesk for a mailbox (administrator)

  1. Open MailDesk ▸ Configuration ▸ Mailboxes ▸ Mailbox Accounts and open the mailbox.
  2. Open the Settings tab and find the card Helpdesk Ticket Workflow & Support Routing.
  3. Switch Enable on and set the options you need.
  4. Save the mailbox.

The Helpdesk Ticket Workflow and Support Routing card on the Settings tab of a mailbox account, with Enable switched on

What you should see: the card expands and shows Defaults, Permissions and Automation.

Group Options
Defaults Default Helpdesk Team, Show SLA Status, Auto Reopen on Customer Reply (off by default)
Permissions Allow Create Ticket, Allow Link Ticket, Allow Unlink Ticket, Allow Stage Change, Allow Ticket Priority Change, Allow Assignee Change
Automation Auto-link by Reply Headers, Auto-link by Subject Token, Log Agent Replies, Log Customer Replies

Step 2: Open the Helpdesk panel on an email

  1. Open an email in MailDesk.
  2. Click the Helpdesk button (life-ring icon) on the email toolbar.

The life-ring Helpdesk button on an open email

What you should see: the Helpdesk panel opens beside the email. If nothing is linked yet, it says No Helpdesk tickets linked yet and offers Create Ticket and Link Existing.

The Helpdesk panel for an email that has no ticket linked yet

Step 3: Create a ticket from the email

  1. Click Create Ticket.
  2. A ticket opens, filled in from the sender and the email. Choose the team, set the priority and save.

Creating the first Helpdesk ticket from a customer email

What you should see: the ticket appears in the panel as a card with team, stage, priority and assignee. The first linked ticket carries the Primary badge.

The Helpdesk panel showing the first linked ticket as a card

  1. Click Link Existing.
  2. In Link to Existing Ticket, choose a team to narrow the list, then choose the ticket.
  3. Tick Make Primary if this should be the main ticket for the email. (This option appears when the email already has linked tickets.)
  4. Click Link.

The Link to Existing Ticket window

Step 5: Manage tickets from the panel

An email can have more than one ticket. Each card shows team, stage, priority and assignee. When Show SLA Status is on, a card also shows an SLA label (OK, At risk or Breached) and the deadline. You can open a ticket in a popup or in a new browser tab. If the administrator allowed it, you can change the Stage, Priority or Assignee in the card.

Two linked tickets, one with the quick-edit fields open in the Helpdesk panel

Unlinking is safe

Unlinking removes only the link between the email and the ticket. The ticket is not changed or deleted.

Step 6: Check the conversation on the ticket

When reply logging is on, the emails of the thread appear in the ticket's chatter.

A Helpdesk ticket form with the linked email in its chatter

What you should see: in MailDesk, the Helpdesk button shows a badge with the number of linked tickets.

The Helpdesk button with a badge that shows how many tickets are linked

Reopen a ticket on a customer reply (optional)

With Auto Reopen on Customer Reply on, a customer reply that is linked to a ticket moves the ticket from the default On Hold stage back to In Progress. This works only when the team has those stages. It is off by default.

How automatic linking works

When Auto-link by Reply Headers or Auto-link by Subject Token is on (both are on by default), MailDesk links a follow-up email on its own, but only when the match is exact:

  • Reply headers: the reply belongs to an email that is already linked.
  • Subject token: the subject contains a token such as [HD-1234] that names one ticket.

MailDesk does not guess from similar text.

If it does not work

Symptom Check Safe next step
There is no Helpdesk Ticket Workflow & Support Routing card. Is the module installed? Is the Settings tab open? Install the module, then reload the mailbox form.
There is no Helpdesk button on emails. Is Enable on for this mailbox? Do you have access to this mailbox? Ask an administrator to turn it on or give you mailbox access.
Create Ticket or Link Existing is missing. The permission options on the card. Ask an administrator to switch on Allow Create Ticket or Allow Link Ticket.
Odoo shows an access error on a ticket. Your Helpdesk access and team membership. Ask your Odoo administrator for Helpdesk access.
The ticket did not reopen after a customer reply. Is Auto Reopen on Customer Reply on? Does the team have the On Hold and In Progress stages? Change the stage by hand in the panel.

For other problems, see Troubleshooting.

Next step

Use MailDesk with Calendar to turn emails into meetings.