Email Service Desk for Azure DevOps

Help

Email Service Desk turns email to your Microsoft 365 support mailbox into Azure DevOps work items, and sends your team's replies from the work item as that mailbox. Each connected mailbox is a desk.

Get started

  1. Install the extension in your Azure DevOps organization from the Visual Studio Marketplace.
  2. Connect once. Open Project settings → Email desk and select Connect. Work items are created with that Microsoft sign-in, so emails become work items even when nobody is signed in. One connection covers the whole organization.
  3. Add a desk. Select New desk, give it a name, enter the Mailbox (a shared or user mailbox in your Microsoft 365, such as support@yourcompany.com), pick the Work item type and Area path, and select Connect mailbox.
  4. Allow access to the mailbox, once (next section).

Only project administrators can add or change desks; everyone else in the project can see them and their activity. It works with Azure DevOps Services organizations connected to Microsoft Entra ID; if yours isn't, the Email desk page says so.

Allow access to the mailbox

A Microsoft 365 administrator of the mailbox's organization (Global Administrator or Privileged Role Administrator) allows the app Email Service Desk Mail to read and send email, one time per Azure DevOps organization. After you select Connect mailbox, the panel shows Allow access to <mailbox>:

Once the desk is connected, new emails in the mailbox become work items within about a minute. Emails that were already in the mailbox stay as they are. Nothing in the mailbox is moved, marked read or deleted.

What access the app needs, and why

The app reads new mail in each desk mailbox (Mail.ReadWrite) and sends replies and automatic emails as that mailbox (Mail.Send). These are application permissions, so a desk keeps working when the person who set it up is away or leaves. Microsoft grants them for the whole tenant; the app opens only the mailboxes connected as desks, and only mail that arrives after the desk is added.

Limit the app to the desk mailboxes

Your Exchange administrator can scope the app to the desk mailboxes with RBAC for Applications in Exchange Online. Do it after the first desk is connected. In Exchange Online PowerShell (Connect-ExchangeOnline), with the app's Object ID from Microsoft Entra admin center → Enterprise applications → Email Service Desk Mail:

$id = "<Object ID>"
New-ServicePrincipal -AppId 828f7570-3099-43c3-9798-0f6336e794bf -ObjectId $id -DisplayName "Email Service Desk Mail"
Set-Mailbox -Identity support@yourcompany.com -CustomAttribute15 "EmailServiceDesk"
New-ManagementScope -Name "Email Service Desk mailboxes" -RecipientRestrictionFilter "CustomAttribute15 -eq 'EmailServiceDesk'"
New-ManagementRoleAssignment -App $id -Role "Application Mail.ReadWrite" -CustomResourceScope "Email Service Desk mailboxes"
New-ManagementRoleAssignment -App $id -Role "Application Mail.Send" -CustomResourceScope "Email Service Desk mailboxes"
Test-ServicePrincipalAuthorization -Identity $id -Resource support@yourcompany.com

Desk settings

Open a desk from the list. Each desk has four tabs; select Save after a change.

TabWhat you set
DefaultsThe new work items' Work item type, Area path, Iteration path, Assigned to, Tags (separated by commas) and Priority
SendersAnyone who emails the mailbox, or Only these senders and domains (name@company.com or @company.com)
EmailsDesk name; Send the requester a confirmation when a request arrives; Email the requester when the work item moves to the closing states you tick. Subjects and messages can use {id}, {title}, {first name} and {desk name}
ActivityEvery email the desk received and sent in the last 30 days, and its result

A project can have several desks, one per mailbox: the mailbox decides where an email goes. A mailbox can belong to one desk only.

When an email arrives

Reply by email

Open the work item's Email tab. The conversation is listed newest first, with the reply box on top: check To, add people on Cc, Attach files (10 MB together at most) and select Send. The email goes out from the desk mailbox with its Microsoft 365 display name, threaded with the requester's email, and a copy stays in the mailbox's Sent Items.

On a work item that didn't come from email, the Email tab lets you email someone from it: pick the desk in From. Their replies come back to this work item. Save a new work item before emailing from it.

Discussion comments on the work item stay with the team. Only what you send from the Email tab, and the automatic emails, reach the requester. A desk sends at most 500 emails a day.

If something's wrong

The desk saysWhat to do
Waiting for accessA Microsoft 365 administrator hasn't allowed access yet. Select Allow access, or copy the link for your admin.
Access taken backThe app's access to the mailbox was removed. Select Reconnect, or send the link to your admin.
Mailbox can't be foundThe mailbox was removed or renamed. Delete the desk and add one for the new address.
Sign-in expiredSelect Reconnect on the Email desk page. Emails are kept and become work items once you reconnect.
This area path was deletedPick another area path on the Defaults tab and save. Waiting emails are filed then.

Your data

What the extension reads, stores and for how long: Privacy. To stop it reading a mailbox, delete the desk; to remove its mail access completely, remove the Email Service Desk Mail enterprise application in Microsoft Entra.

Contact

Questions or problems: crosstowntech.com/support. We reply by email.