Azure DevOps Boards is a service for managing the work for your software projects. Teams need tools that flex and grow. Azure Boards does just that, bringing you a rich set of capabilities including native support for Scrum and Kanban, customizable dashboards, and integrated reporting.

With the Azure DevOps integration, HappyFox agents can create work items and monitor work item activity in the Azure Boards projects right from the linked ticket details page.

Applicable Plans: ✖️ Mighty ✖️ Fantastic ✔️ Enterprise ✔️ Enterprise Plus 

Also available on all unlimited agents pricing plans!

HappyFox integration with Azure DevOps allows your agents to:

1. Create a new work item in Azure DevOps from within a ticket and link it.

2. Link an existing work item with a ticket.

3. Edit a work item linked with a ticket.

4. Enable two-way real-time synchronization between Azure DevOps work-item-comments and HappyFox ticket updates/private-notes.

5. Synchronize attachments from HappyFox ticket to Azure DevOps work items.

6. Auto-closing of HappyFox ticket, when linked Azure DevOps work item, is marked done.

Integration Prerequisites

• To create a work item, you must be a contributor to the Azure Boards project. If you don't have a project yet, you can sign up and create a project. For details, see Start using Azure Boards.
• To perform integration setup with HappyFox, you must be a member of the Azure Boards Project Administrators group or Team Administrators group. To get added, see Set permissions at the project- or collection-level or Add Team Administrator.
• Please login to Azure DevOps as an account admin > Navigate to the organization in which you are looking to integrate with HappyFox Helpdesk > Goto Organization Settings > Goto Policies Under Security > Ensure the toggle Third-party application access via OAuth is enabled. 

Integrating Azure DevOps with HappyFox requires the following two steps

1. Authorizing HappyFox to connect to Azure DevOps 

2. Configuring Sync Settings for Azure DevOps app inside HappyFox

Authorizing HappyFox to connect to Azure DevOps

1. Login to HappyFox and navigate to the Main Menu > Apps module.

2. Navigate to Categories > Project Management and click on Azure DevOps app.

3. Click on the Install button below the app logo and then click on the Link Azure DevOps button in the next screen.

4. You will now be redirected to Microsoft login page to authenticate your Azure DevOps account. Enter your credentials or choose your Azure DevOps account and login.

5. Once the login is successful, you will be prompted to authorize the HappyFox app to connect to Azure DevOps. To do this, click on Accept.

6. On successfull authentication, you will be redirected to Azure DevOps apps page in HappyFox.

7. Note: To complete the App Installation, choose the Azure DevOps organization to which you want to integrate and then click on Save. Refer screenshot below.

8. Configure the required sync settings and then click on Save. Enable the integration by switching ON the Enable App toggle at the top, only after the integration is enabled all the sync settings will work.

Configuring Sync Settings for Azure DevOps app

Once Azure DevOps is installed, you can now configure the various synchronization settings that are available.

1. Navigate to Categories > Project Management and click on Azure DevOps app.

2. You will be able to see the linked Azure DevOps account Name and Email address 

3. The Active Azure DevOps organization to which the integration is enabled will be selected as shown below.

4. You can now configure the various synchronization settings between HappyFox and Azure DevOps based on your project needs.

The various sync settings that are available are,

Sync HappyFox Updates to Azure DevOps

Once enabled, Ticket replies and Private notes from HappyFox will be automatically synced as Work Item - Comments inside Azure DevOps.

Sync Azure DevOps Comments to HappyFox

Once enabled, Work Item - Comments from Azure DevOps will be synced as Ticket - Updates in HappyFox.

Sync Attachments

Once enabled, Attachments will be synced from HappyFox to Azure DevOps Work Items

Sync statuses - Status mapping between Tickets and Work Item

Sync Statuses

Once enabled, you can configure the Azure DevOps Project, Work Item type and map the various Work Item statuses to  HappyFox Ticket statuses (as shown below in screenshot) based on which the automatic status sync should happen. 

• Sync HappyFox ticket status when Azure DevOps work item is updated: Once enabled, based on the status mapping settings, status changes happening in Work Items will automatically synced to Tickets  
• Sync Azure DevOps work item when HappyFox ticket status is updated: Once enabled, based on the status mapping settings done, status changes happening in Tickets will automatically synced to Work Items  

NOTE: 

1) Statuses will be synced only based on the status mapping settings done here; statuses that are not configured will not be updated. 

2) Completed state Azure DevOps statuses will sync only with Completed behavior statuses in HappyFox.

Mapping work item status to the respective ticket status 

Enable email notifications for work item comments *

Once enabled, email notifications will be sent to the assigned agent from HappyFox whenever a new comment is synced from Azure DevOps Work Item. The notification template can be customized in the text editor below by inserting merge fields in it. 

Default synchronization Settings, when a new Work item is created or linked from HappyFox. These settings will be taken up as defaults when you create or link a Work Item from HappyFox Ticket. 

5. Voila! You're all set with the Azure DevOps Integration 🎉. Read on to know how to create/link/edit tasks within the ticketing interface.

Linking HappyFox Tickets to ADO Work Items

Look out for the Azure DevOps section in your ticket details page > right sidebar to create a new work item for the ticket or link it to an existing work item in ADO.

Notes:

When Sync Statuses is enabled, if completed behavior statuses are mapped to Azure DevOps work item states, then status sync would require Close this ticket when Azure DevOps Work item is completed to be enabled at the ticket level.

If your account has a custom domain configured and if the Azure Dev Ops integration option is not available/not loading in ticket detail page, please ensure to check from the HappyFox default url <account name>.happyfox.com as well. The integration works from the url through which it was setup.

Creating work items in Azure Boards from HappyFox:

Azure Boards work item information displayed in context of a HappyFox Ticket

Comments in Azure DevOps appearing as Azure DevOps Sync notes in HappyFox:

Sample private notes from HappyFox being synced as comments in Azure DevOps work item: