MS Teams

The Teams integration leverages webhook URLs to send incident details. To start sending incident details to a specific channel or workflow, add the webhook URL for that workflow during the Add the Workflow URL to BigPanda step in integration installation.

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 Incident Data or Primary Alert Tags can be added. Any tags added during integration configuration will be included in all shares for this integration. If a tag does not have a value, it will be sent with an N/A value.

Once configured, the Teams workflow 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 workflow from the available options. All workflows added to this integration will appear in the list.

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 and manual share can be customized for the destination channel. The Message Preview pane shows a sample built from a real incident in the sharing environment, so you can see the result before you save.

Option	What it does
Link type	Chooses which link recipients receive. The BigPanda app link opens the full incident and requires a login. The preview page link does not require a login, which suits channels that include people without BigPanda accounts.
Incident Data	Adds incident properties and incident tags to the message.
Primary Alert Data	Adds tag values from the primary alert, which is the oldest and most severe alert correlated into the incident. Use this when responders need to see the specific host, service, or check that triggered the incident rather than the incident summary alone.
Additional Message	Adds your own text to the share. The text also appears in the incident's activity feed.
AutoShare Delay	Changes how long BigPanda waits before the first share. Incidents resolved within the delay period are not shared at all.

Mandatory fields cannot be removed per share

Fields marked as mandatory during integration configuration are included in every share for that integration, and cannot be removed from an individual AutoShare rule. To change them, update the Teams integration settings.

Test the share before saving

Click Test AutoShare at any point during configuration to send the sample message to the destination channel.

If a red error message appears, the channel webhook is likely misconfigured. Review the integration configuration for missing or mismatched values.

Troubleshooting

Symptom	Likely Cause	Solution
The Primary Alert Data list shows no results when configuring an AutoShare rule.	The tag list did not load in time. This is more likely in organizations with a large number of alert tags.	Close and reopen the dropdown. If it still does not load, contact BigPanda Support and include your organization name and the time you tried.
Test AutoShare returns a red error message.	The destination channel webhook is misconfigured.	Review the Teams integration configuration for missing or mismatched values, then test again.