How can we help?

Integrating Auvik with Microsoft Teams

Follow

For more information on editing, deleting, disabling, and enabling integrations, see How do I edit, delete, disable, or enable integrations?

Auvik connects to Microsoft Teams for alert notifications using an incoming webhook, which is initially configured in either Office 365 or the desktop app. Then create the new integration in Auvik.

Before you get started creating a group, first make your Microsoft account allows all apps to be used and is in no way restricted. To check this, log in as an Office 365 administrator. From the Admin section, click Admin Center > Teams. From the Teams admin center, click Teams Apps > Permissions Policies. Click the organizations app settings and update the third-party apps to allow all, or at least unblock incoming webhooks. If this is the first time you’ve allowed access to third-party apps, it can take up to an hour or more for Microsoft to sync the settings and allow connectors to be attached.

Microsoft Teams integrations can only be managed from your MSP dashboard.

Enable Microsoft Teams

The first step is to ensure Microsoft Teams has been enabled. For this, you’ll need Office 365 admin rights. Note: Enabling Microsoft Teams enables it for your entire organization.

  1. Log into your Office 365 web portal.
  2. Click Office 365 in the top navigation bar.
  3. Click Admin.

  1. From the Office 365 Admin Center side navigation bar, click Settings, then Services & add-ins.

  1. In the search field, enter Microsoft Teams.
  2. Once located, select the row for Microsoft Teams.
  3. Select the on/off switch to turn on Microsoft Teams.

MSTeams3.png

  1. Update the rest of the details as you see fit. There will be some settings that must be set under the Microsoft Teams & Skype for Business Admin Center.
  2. Click Save.

Now that Microsoft Teams has been enabled, you can complete the setup in Office 365 or the desktop app.

Configuring Microsoft Teams in Office 365

Create new groups

  1. Log into your Office 365 web portal.
  2. Click Office 365 in the top navigation bar.
  3. Click Admin.
  4. From the Office 365 Admin Center side navigation, click Groups, then Groups.

MSTeams20.png

  1. Click the Add a group button.
  2. Select Office 365 as the type and click Next.

MSTeams24.png

  1. Enter a name for the group, and a description. Click Next.
  2. Enter an email address for the group. We recommend it be the same as the group name. Select the privacy level and check Create a team for this group. Click Next.

MSTeams25.png

  1. Select the owners of the group. Click Next.
  2. Review the group details. If there are any updates to be made, click the Back button until you’re at the detail to be updated and follow the steps again. Once all details have been confirmed as accurate, click Create group.

MSTeams26.png

  1. Click Close.
  2. From the list of available groups, click the name of the newly created group.

MSTeams27.png

  1. Click the Microsoft Teams tab. This takes you to the Microsoft Teams admin center.
  2. From the side navigation, expand Teams and click Manage Teams.

MSTeams28.png

  1. From the list of teams, click the row for the new team just created.
  2. Click the Add Members button.
  3. From the list of available users, check each one to be added.
  4. Click Apply.
  5. If all members have been added, click Close.

Creating a new group webhook

  1. Log into your Office 365 web portal.
  2. Click Office 365 in the top navigation bar.
  3. Click Outlook.
  4. Scroll down to the groups in the left-hand tree. Click the name of the new group.
  5. Click the three dots. Click Settings.
  6. Click Connectors.
  7. In the search field, enter Incoming.

MSTeams6.png

  1. Click Incoming Webhooks.
  2. Click Add.
  3. Provide a name for the webhook and click Create.
  4. Copy the webhook URL. You’ll need this when creating a new integration in Auvik.

  1. Click Done.

Add users to the group

Now that your group has been configured for a webhook, you’ll want to add the users who will be monitoring the group for new Auvik alerts.

  1. From the Outlook side navigation bar, click on a group you want to add users to.
  2. From the group navigation, click the 3 dots, then click Members.

  1. Click Add members.

  1. Search for the members to be added to the group.
  2. Once all members have been selected, click Save.

Configuring Microsoft Teams in the desktop app

Create new groups

  1. Log into your Microsoft Teams desktop application.
  2. From the side navigation, click Teams.

MSTeams11.png

 

  1. Click the gear at the bottom of the team navigation.

MSTeams30.png

  1. Click Create a team.
  2. You have two options for creating a new team.
    1. Option 1 Build a team from scratch. Use if you’d like to create a new team with new configuration.
      1. Click the type of team to create: Private, Public, or Org-Wide.
      2. Enter a name for the team.
      3. Click Create.
      4. Enter the name of team members who should have access to the group. Click Add. Or click Skip to add users at a later time.
    2. Option 2 Create from…. Use if you’d like to create a new team with the same settings as an existing team.
      1. Click Team
      2. Click on the team you want to copy configuration from.
      3. Enter a new name for the copied team. Select the privacy level for the group and any or the settings you’d like copied to the new team.
  3. Click Create.

Creating a new team webhook

  1. From the Microsoft Teams desktop app side navigation bar, click on the team for which you want to add a webhook. If needed, expand Teams to see the groups available.
  2. From the team navigation, click the 3 dots, then click Connectors.

MSTeams16.png

  1. In the search field, enter Incoming.
  2. Click Incoming Webhook.
  3. Click Add.

MSTeams17.png

  1. Provide a name for the webhook and click Create.
  2. Copy the webhook URL. You’ll need this when creating a new integration in Auvik.

MSTeams18.png

  1. Click Done.

Add users to the group

Now that your group has been configured for a webhook, you’ll want to add the users who will be monitoring the team for new Auvik alerts.

  1. From the Microsoft Teams desktop app side navigation bar, click on the team for which you want to add new members. If needed, expand Teams to see the groups available.
  2. From the team dashboard, click Add More People.

MSTeams23.png

  1. Search for the members to be added to the team and click Add.
  2. Once all members have been selected, click Close.

Managing integrations for multiple locations

For corporate IT managing a single network with multiple locations

Be aware that Auvik can’t currently distinguish alerts that come from different locations (say, the Cleveland office and the Houston office) on a network running a single Auvik collector. All of your Auvik alerts will feed into a single Microsoft Teams group. To have alerts sent to multiple Microsoft Teams groups, it’s best to create a new integration for each group you’d like to post to.

For MSPs managing multiple networks

As for corporate IT, alerts from different locations running a single Auvik collector will feed into a single Microsoft Teams group. We’ll specify the company name for each notification so you know which notifications apply to which client. Or you can choose to create a new integration for each group.

How to add a new Microsoft Teams integration

  1. Click Integrations in the side navigation bar.
  2. Hover over the Add Integration button and select Microsoft Teams.
  3. In Auvik, fill in the following detail:
    1. Integration name
    2. URL
  4. Click Test Connection to confirm your settings are accurate.
  5. Click Save.

Configure a notification channel

Before you can use the integration with Microsoft Teams, there’s one final configuration step: creating a notification channel to be associated with the Auvik alerts you’d like sent to the integrated platform.

If the test connection spins or a failed message appears, see How do I troubleshoot issues with my Auvik / Microsoft Teams integration? for possible resolutions.

Finding integrated alerts

Auvik alerts can be posted to existing Microsoft Teams groups or a new groups you create. The channel can be public or private.

If Auvik alerts to fail appear in your Microsoft Teams group, see How do I troubleshoot issues with my Auvik / Microsoft Teams integration? for possible resolutions.

Was this article helpful?
0 out of 2 found this helpful
Have more questions? Submit a request