MailDesk docs
Get MailDesk
Cockpit integration

Cockpit AI briefings for managers

You run a shared inbox — support, sales, or info@ — and several people answer from it. You don't have the hours to open every thread and judge whether the team is on top of things. The MailDesk Cockpit gives you a single screen that already knows the answer, and an AI Insights panel that turns that screen into a short, readable briefing you can act on in under a minute. Instead of skimming conversations, you read one paragraph and a short to-do list — and you know exactly whe

8 min read Cockpit integration

Available in: Cockpit integration (maildesk_mail_client_cockpit). The Cockpit module builds on MailDesk Pro and uses the same AI provider you configure for Pro. Without Cockpit there are no manager briefings; without a configured Pro AI provider the written briefings stay disabled.

You run a shared inbox — support, sales, or info@ — and several people answer from it. You don't have the hours to open every thread and judge whether the team is on top of things. The MailDesk Cockpit gives you a single screen that already knows the answer, and an AI Insights panel that turns that screen into a short, readable briefing you can act on in under a minute. Instead of skimming conversations, you read one paragraph and a short to-do list — and you know exactly where to look first.

The dashboard, in one glance

The MailDesk Cockpit: live KPI cards for incoming, needs-reply, overdue and response time, with the AI Insights panel on the side

The Cockpit is an operational dashboard for the people who own a shared mailbox. Across the top it shows live KPI cards — how much came in, how much needs a reply, how much is overdue, and your average first response time — pulled straight from your real MailDesk accounts. Every number is clickable: open the exact email, the thread, or the backlog row right there, without leaving the screen.

That's useful on its own. The AI Insights panel beside it is what turns those numbers into a decision.

What the AI Insights panel does

The panel sits in the Cockpit's side area. A small badge shows your access tier (for example manager), and below it you get a focused set of actions — each one answers a question a busy manager actually asks.

  • Generate daily briefing — a one-page written summary of your queue: the state of the queue, the risks and anomalies worth knowing about, and 2–4 recommended actions for today. The text writes itself in live, and you can copy it straight into your stand-up notes or a message to the team.
  • Customer escalation risk — ranks the customers most likely to escalate, so you can reach out before the complaint arrives. The ranking is based on open threads, overdue threads, urgency wording, and how long the oldest message has been waiting.
  • Rebalance workload — proposes how to spread open work more evenly across the team when one person is drowning and another has room.
  • Anomalies (last 30 days) — flags any metric that is unusually high or low compared with its recent normal, each with a severity badge, so a quiet spike never goes unnoticed.

The maths is honest — the AI only writes it up

Anomaly detection, mailbox health, and the workload-rebalance scoring are all calculated in plain arithmetic on the Cockpit's own metrics. They never call an AI provider, never cost you anything per run, and are available even before any AI is configured. Only the wording — the briefing text and the reply strategy — is produced by your AI provider. The Cockpit never invents a number; it only narrates the ones it has already computed.

Why managers love it

A manager watching several mailboxes does not have time to read every thread. The daily briefing condenses the whole day into a paragraph and a short action list. The escalation-risk and anomaly tools point you straight at the customers and metrics that need attention first — no opening, no skimming, no guesswork. And because the statistical tools never call an AI model, they are free to run and always available, even on day one before a provider is set up. You spend your morning acting, not investigating.

Run a daily briefing

This is the heart of the page — three clicks from open mailbox to a briefing you can paste into your stand-up.

  1. Open MailDesk → Cockpit from the MailDesk menu.
  2. In the side panel, find the AI Insights block. The badge in its corner shows your tier (for example manager) — that's how you know which actions you'll see.
  3. Click Generate daily briefing.
  4. A briefing panel slides in and the text streams in live, headed by a quiet Thinking… indicator. While it is still writing you can press Stop. When it's finished, the header reads Ready and you can Copy the text or Close the panel.

What the briefing looks like

The briefing arrives in three short sections — State of the queue, Risks & anomalies, and Recommended actions today — built entirely from your real KPIs and any detected anomalies. It's concrete: a couple of sentences of context, the risks worth knowing, and two to four things to do today. Read it, copy it, share it, move on.

The free tools — no provider needed

These three run entirely on the Cockpit's own data and never contact an AI provider, so they work immediately, cost nothing, and are great for a quick check before you've even set AI up:

  • Anomalies (last 30 days) compares the latest day against a 30-day baseline and lists the metrics that are unusually high or low, each with a severity badge. (Before a provider is configured, this same button reads "Detect anomalies (statistical, no LLM)".)
  • Customer escalation risk lists the customers most at risk, each with a score and a severity.
  • Rebalance workload proposes how to spread open work across the team.

Who can see what — the four tiers

Cockpit uses a four-tier access model, and each tier includes everything the tier below it can do. The written briefings (and the rest of the manager toolkit) are reserved for Manager and above — that keeps the serious, account-wide picture in the right hands.

Tier Group What they can do with AI
Viewer Cockpit Viewer Read KPIs, trends, and drilldowns for mailboxes they can access. No AI actions.
Operator Cockpit Operator + reply-strategy and reply-draft help on their own threads, plus a small "Cockpit Brief Chat" allowance.
Manager Cockpit Manager + the full manager toolkit: daily briefing, weekly summary, anomaly detection, escalation risk, workload rebalance, mailbox health, and workload forecast.
Administrator Cockpit Administrator Everything, across companies, plus AI-provider setup — and no daily limit.

Briefings are a Manager (or higher) action

The daily briefing, weekly summary, anomaly detection, escalation risk, workload rebalance, mailbox health, and workload forecast are reserved for the Cockpit Manager tier and above. An Operator who tries to run one is told the operation is restricted to Cockpit Manager or higher. A standard MailDesk administrator is automatically treated as a Manager for these tools, so they work out of the box for the person who already runs MailDesk.

What you need first

  • The Cockpit module installed. It builds on MailDesk Basic, MailDesk Pro, and the Automation module (plus Odoo's Resource module) — Odoo installs all of these for you automatically.

  • A working AI provider — but only for the written briefings. Cockpit reuses the very same provider you already configured for MailDesk Pro, so there's one key for both. See Set up your AI provider. The statistical tools (anomalies, escalation risk, rebalance, mailbox health) need no provider at all.

  • At least one mailbox account visible to the manager, with some message history so the KPIs have something to report.
  • MailDesk works on Odoo 17, 18, or 19 — the steps above are the same on each.

One AI provider serves both Pro and the Cockpit — set it up once under MailDesk Pro and the written briefings light up

Daily usage limits (quotas)

Every AI action is counted per user, per day, per operation — a fair-use cap that keeps costs predictable. When someone reaches the limit for an operation, MailDesk simply asks them to try again tomorrow or have an administrator raise the cap. Administrators have no daily limit.

Operation Operator / day Manager / day Administrator
Daily briefing — (manager only) 25 unlimited
Weekly summary — (manager only) 10 unlimited
Anomaly detection — (manager only) 50 unlimited
Workload rebalance — (manager only) 50 unlimited
Escalation risk — (manager only) 50 unlimited
Mailbox health — (manager only) 100 unlimited
Workload forecast — (manager only) 20 unlimited
Anomaly explanation — (manager only) 100 unlimited
Reply strategy 30 200 unlimited
Reply draft generator 60 400 unlimited
Cockpit brief chat 10 50 unlimited

See who used how much

Usage is recorded per user and per operation. A manager or administrator can review it under MailDesk → Configuration → SSOT & Cache → Cockpit Debug → Cockpit Next → AI Usage, with totals for calls and tokens, and filters for errors and rate-limited calls — handy for spotting heavy use or a misbehaving provider.

When something looks off

You see Likely cause What to do
The Generate daily briefing button is missing You're below the Manager tier, or no AI provider is ready Have an administrator grant the Cockpit Manager tier and confirm a Pro AI provider is configured
Briefing says it needs an AI provider "to enable daily briefings" No working AI provider in Pro Set up and test a provider — see Set up your AI provider
"Daily AI quota reached for …" The per-day limit for that operation is used up Wait until tomorrow, or ask an administrator (administrators have no limit)
"Operation … is restricted to Cockpit Manager or higher" An Operator triggered a manager-only briefing Run the manager tools as a Manager; Operators have reply-help tools instead
"MailDesk Pro is not installed …" The Pro module is missing from this database Install MailDesk Pro; Cockpit AI reuses Pro's provider
The anomaly / escalation tools work but the written briefings don't The statistical tools need no provider; the written briefings do Configure a Pro AI provider for the written briefings

For provider-side errors (an invalid key, quota exhausted at the provider, an unreachable local server), see the AI troubleshooting page.