MS Teams

🚧

Caution

Limited Availability

This feature is currently available in a limited release. Some functionality is not yet available, but will be released in the near future. See the Coming Soon section for more information.

The MS Teams integration allows you to easily share BigPanda incidents in a customized message to a channel within Teams.

The integration shares incidents from BigPanda to Teams via a webhook. When an incident triggers an AutoShare or is manually shared, it is normalized and sent via webhook to the Teams API.

📘

Standard AutoShare Rules

The MS Teams integration follows standard AutoShare rules. See the Sharing Rules documentation for more information.

Key Features

• Incident updates: Updates to ongoing incidents will be sent to your MS Teams channel in real time.
• Streamline workflows Invite your team members to the MS Teams channel(s) specifically pertaining to them, clearly designating responsibilities and saving time.
• Communication optimization: Team members can collaborate together, capitalizing on a diverse knowledge base of expertise to tackle each issue.
• Customizable messages: Configure what data is included in MS Teams messages for each AutoShare rule, selecting from alert tags, incident metadata, and incident tags.
• Preview: Sample message content helps you visualize how your teams will see incidents within MS Teams.

Coming Soon

• Multi-channel support: Teams integrations will no longer be tied to a specific channel. Configure AutoShare rules for all channels associated with that Teams webhook.

Install the Integration

Create an App Key

Create an app key in BigPanda.

👍

Integration Specific

You'll need a separate app key for each integrated system.

Configure the Teams Incoming Webhook

Configure the Teams incoming webhook to accept BigPanda requests, if applicable. Then, use the form below to specify the webhook URL.

In order to create Incoming Webhook for your Teams Channel you can use the following guide.

• Enter the full Incoming Webhook URL where BigPanda will send the request.

• For example: https://teams-incoming-web-hook.com

Note: Please complete Step 1: Create an App Key before configuring the webhook below.

After the form is complete, click Configure incoming webhook uri.

Add Sharing Channels

The Teams integration leverages channel-specific webhook URLs to send incident details. To start sending incident details to a specific channel, add the webhook URL for that channel during the Configure the Teams Incoming Webhook step in integration installation.

👍

Finding Channel Webhooks

Each channel in teams has a unique webhook URL. Channel webhook links can be created and found in the channel details within Teams. Follow the Teams instructions to create an incoming webhook or locate an existing webhook for a channel.

By default, a Teams incident share includes a link to the incident in the BigPanda console, information on the incident status, and the check tag value.

The default tags can be adjusted or additional mandatory Incident Data or Primary Alert Tags can be added. Any tags added during integration configuration will be included in all shares for this integration. An incident share will fail if the incident does not have values for the mandatory tags.

❗️

Mandatory Tags Must Have Values

An incident share will fail if the incident does not have values for the mandatory tags. Only add mandatory tags if you are sure that they will be added to every alert or incident.

📘

Primary Alert

The Primary Alert for an incident is the oldest most severe alert in the Incident. If a more severe alert comes in it will be the new primary alert.

Sharing to MS Teams

Once configured, the Teams integration can be selected as a destination for AutoShare and Manual sharing of incidents.

To send incident information to a Teams channel:

1. Select the Teams integration name from the Share via field when configuring an AutoShare rule, or Sharing an incident.

2. Select the Teams channel from the available options. All channels added to this integration will appear in the list. See the Share to Multiple Channels section for details on adding additional channels to the integration.

❗️

Manual Share Only

Incidents can currently only be manually shared to MS Teams from the expanded Incident Details pane.

Adjust Sharing Rules

All BigPanda shares include a link to the triggering incident in BigPanda.

Some mandatory incident and primary alert data fields may have been configured during integration configuration. These fields will be included by default in all autoshare rules or manual shares for that integration.

Additional customization can be added when configuring an AutoShare rule or as part of a Manual share.

Customize the Message

Each AutoShare rule or Manual share can be customized to better fit the needs of the members of the destination Teams channel.

Adjust available fields as desired:

• Link type - Choose whether viewers can access additional incident details in the BigPanda app, or in a preview page. Login is required for the BigPanda app, but not for the preview page.
• Incident Data - Include incident properties and tags in the message.
• Primary Alert Tags - Include information about the oldest, most severe alert in the incident.
• Additional Message - Add textual context or details to the share.
• AutoShare Delay - Change the delay time for the initial share. Incidents that are resolved in the delay period will not be shared. Read more about AutoShare delay in the Manage AutoShare documentation.

NOTE: The mandatory fields added during integration configuration cannot be removed per share. To adjust these fields, update the settings for the Teams integration.

During configuration, the Message Preview pane will create a sample message based on an incident from the sharing environment.

At any time during AutoShare configuration, click Test AutoShare to send the sample message to the destination channel. If a red error message appears, there may be a configuration issue with the channel webhook. Review the integration configuration for mismatched or missing values.

When satisfied with the sharing settings click Share or Create AutoShare.

Uninstall the Integration

Deleting an integration requires that you remove the integration in both the integrated system and BigPanda. We recommend that you first uninstall the integration on the integrated system to prevent traffic from being sent and rejected by BigPanda, since the app_key will not exist once you delete the integration in BigPanda.

❗️

Caution During Replacement

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Stop Sending Data from BigPanda

In BigPanda, disable any settings that send data to the integrated system. This includes modifying or removing AutoShare rules or Environments that are tied to the integration.

Delete the Integration in BigPanda

Take the following steps to delete the integration from BigPanda:

1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
2. In the integration details on the right of the page, click the trash icon, then confirm you want to delete the integration. The integration will be removed immediately.

❗️

️Data Removal

This procedure does not remove any data from BigPanda or the integrated system. As needed, remove data from each system before deleting the integration.