Create tickets from email
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)
- Open MailDesk ▸ Configuration ▸ Mailboxes ▸ Mailbox Accounts and open the mailbox.
- Open the Settings tab and find the card Helpdesk Ticket Workflow & Support Routing.
- Switch Enable on and set the options you need.
- Save the mailbox.
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
- Open an email in MailDesk.
- Click the Helpdesk button (life-ring icon) on the email toolbar.
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.
Step 3: Create a ticket from the email
- Click Create Ticket.
- A ticket opens, filled in from the sender and the email. Choose the team, set the priority and save.
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.
Step 4: Link the email to an existing ticket
- Click Link Existing.
- In Link to Existing Ticket, choose a team to narrow the list, then choose the ticket.
- Tick Make Primary if this should be the main ticket for the email. (This option appears when the email already has linked tickets.)
- Click Link.
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.
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.
What you should see: in MailDesk, the Helpdesk button shows a badge with the number of linked tickets.
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.