Setting up Microsoft Teams integration with HappyFox Service Desk

Microsoft Teams serves as a comprehensive communication and collaboration hub, seamlessly integrating persistent workplace chat, video conferencing capabilities, file storage solutions, and a wide array of application integrations.

The seamless integration of HappyFox Service Desk with Microsoft Teams enables effortless incident pushing between the two platforms, ensuring immediate updates and streamlined collaboration.

Overview:

With HappyFox Service Desk - Microsoft Teams integration, 

• Create Incidents: Requesters and agents with the necessary permissions can create incidents directly within the HappyFox Service Desk platform from Microsoft Teams.

• Receive Notifications: Requesters and agents will receive notifications in Microsoft Teams whenever a new incident is created or closed within HappyFox Service Desk.
• Update Incidents: An agent can add a reply, a private note for reference, and change the incident properties such as assignee, assignment group, priority, and status. These changes will be synced with the respective HappyFox Service Desk incident.

Note: It is possible to integrate multiple teams within your Microsoft Teams workspace with your HappyFox Service Desk account.

Installation Instructions ⚙: 

Permission Alert 🔐: You require Manage App Settings managerial permission to install or configure the Microsoft Teams app for your HappyFox Service Desk account.

• Please log in to your HappyFox Service Desk account as an agent.

• Go to Apps, then Chat, and select Microsoft Teams from the menu.

• Please click on "Install."

• On the following screen, click on the Add to Teams button

• You will be redirected to the Microsoft Teams Marketplace. Click on the Get It Now button located on the left pane.

• You will be redirected to your Microsoft Teams application and presented with a HappyFox Service Desk app pop-up.

• Click the dropdown menu next to Add and select Add to Teams. Then, proceed to add the app to the desired team in your Microsoft Teams workspace.

• After adding the app, navigate to the general channel of the team. You should receive a welcome message from HappyFox Service Desk app.

• Authorize your HappyFox Service Desk account with the linked team by clicking the Link HappyFox button inside a message from the app.

• You will be redirected to a new page, where you will be prompted to enter your HappyFox Service Desk account’s subdomain. Proceed to authenticate your HappyFox Service Desk account using your agent credentials.

• If the previous action is successful, you will be redirected back to your Teams account, and a message stating Successfully Authenticated will be displayed.
  
  Alert: Please note that there might be a delay of 1-2 minutes in receiving responses from HappyFox Service Desk bot. We kindly ask for your patience in this regard.

Configuring Channel Notifications in Service Desk 🛎:

• After successfully installing the integration, you will be directed back to the Microsoft Teams channel, where you'll see a Successfully Authenticated message. Click the Configure button within that message to navigate to the Microsoft Teams Manage page inside HappyFox Service Desk. Alternatively, you can also visit Apps >> Chat >> Microsoft Teams >> Manage.

• In the Notify Microsoft Teams section, map the Microsoft Teams channel to receive notifications for selected incident events within chosen teams.

• List of currently supported incident events:

  • New Incident: This event occurs when an incident is created.

  • Incident closure: This event occurs when an incident moves to a completed behavior status.

• Agents can configure multiple notification rules for various incident events across different teams to be posted to a single Teams channel. This flexibility allows for efficient  notifications within your organization.

• Ensure to click on the "Save" button after configuring your notification rules to apply the changes.

Important note 📝 : By default, as of today, only public channels can be configured to receive notifications. This is due to the current guidelines set by Microsoft.

Create Incidents:

• To initiate an incident, simply click on the Happyfox Service Desk icon located within the corresponding team's channel.

• Within the "Create incident" dialog box, select the Service Desk team you wish to create an incident for, provide the subject and description, and then click on the "create" button.

• The requester will receive confirmation that the incident has been created successfully.

Receiving Notification

•  After creating the incident, the requester will get a chat notification confirming that the new incident has been successfully created. They will also receive a summary with the incident details.

Update Incidents

• The agent assigned to the respective team will receive incident details once the incident is created.

• The agent can add a reply, a private note for reference, and change the incident properties such as assignee, assignment group, priority, and status. These changes will be synced with the respective HappyFox Service Desk incident.

Disabling Microsoft Teams Integration from HappyFox Service Desk:

If you wish to temporarily pause notifications for the Microsoft Teams channel, you have the option to disable the integration.

• In Happyfox Service Desk, navigate to the "Apps" section, then select "Chat", and choose Microsoft Teams.

• Click Manage and deactivate the toggle in the Basic Settings section.

• Click on Confirm to finalize the process and disable the Microsoft Teams app.

Important Note ❗️: Disabling the integration will not delete its configuration, and you can re-enable it with the same Microsoft Teams channels at any time.

Unlinking Microsoft Teams Integration from HappyFox Service Desk:

You have the option to permanently unlink the existing Microsoft Teams integration from your HappyFox Service Desk account. This action will unlink all your existing linked Microsoft Teams accounts simultaneously.

Alert🚨: Unlinking the Microsoft Teams app will delete your current integration configuration.

• In Happyfox Service Desk, navigate to the "Apps" section, then select "Chat", and choose Microsoft Teams.

• Click Manage, and then click Unlink in the Basic Settings section.

• Click on Confirm to finalize the process and unlink the Microsoft Teams app.

FAQ:

1. Can I integrate multiple Microsoft Teams channels within my Microsoft Teams workspace with HappyFox Service Desk? 
   Yes, you can integrate multiple Teams channels with your HappyFox Service Desk account. Each channel can be configured to receive notifications for specific incident events, allowing for tailored communication and collaboration. 
    
2. Is it possible to receive notifications in private channels within Microsoft Teams? 
   Presently, notifications are exclusively compatible with public channels as per Microsoft's guidelines. External application integrations for receiving notifications are not supported in private channels.
    
3. How do I temporarily pause notifications for a Microsoft Teams channel?  
   To temporarily pause notifications, you can disable the integration for the specific Teams channel. Navigate to the "Apps" section in HappyFox, select "Chat," choose Microsoft Teams, click "Manage," and deactivate the toggle in the Basic Settings section. Confirm the action to disable the Microsoft Teams app temporarily.
    
4. Can I customize the types of incident events for which notifications are sent to Microsoft Teams?
   Yes, you can customize the types of incident events for which notifications are sent to Microsoft Teams. HappyFox allows you to configure notification rules for specific incident events, such as new incidents, incident closures. You can choose which events trigger notifications based on your organization's needs.
    
5. Can I uninstall or remove the Microsoft Teams integration if needed?
   Yes, you can uninstall or remove the Microsoft Teams integration from your HappyFox Service Desk account if needed. Simply navigate to the "Apps" section, select "Chat," choose Microsoft Teams, and click on the appropriate options to manage or unlink the integration. Keep in mind that uninstalling the integration will remove its configuration, but you can re-enable it later if required.

Conclusion:

The integration between HappyFox Service Desk and Microsoft Teams offers a powerful solution for streamlining incident management processes and enhancing collaboration within organizations. By seamlessly pushing incidents between HappyFox Service Desk and Teams channels, teams can ensure instant updates and efficient communication across platforms. With easy installation steps, customizable notification settings, and the ability to integrate multiple Microsoft Teams channels, this integration facilitates smoother workflows and improved productivity. As organizations continue to embrace digital transformation, leveraging tools like HappyFox Service Desk and Microsoft Teams integration becomes increasingly valuable in maintaining effective communication and addressing incidents promptly.