Workflow Actions
Link Incident Notification Channel in Microsoft Teams
Microsoft Teams
Description
Link a specified Microsoft Teams channel to an incident.
Instructions
- If you have not done so, follow the instructions to Create an Incident Workflow.
- When the instructions prompt you to add actions, select this action.
- Enter the following Inputs and click Save.
- Continue following instructions to Publish the Workflow.
- When the action runs, you will see the Outputs listed below.
Inputs
Field References
Fields with the {+} icon accept Field References, which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click {+}, or enter {{, and select relevant fields. Refer to the Field References article for more information.
| Name | Description |
|---|---|
| Microsoft Teams Organization | Name of the Microsoft Teams Organization the channel is in. Example: PagerDuty. |
| Microsoft Teams Team | Name of the Microsoft Teams Team the channel belongs to. Example: SRE Team. |
| Microsoft Teams Team Channel | Name of the channel inside the specified Team to link to the incident. Examples: general, incidents, sre-war-room. |
Outputs
| Name | Description |
|---|---|
| Channel Name | The name of the newly created Microsoft Teams channel. |
| Channel URL | The web URL to the newly created channel. |
| Result | Value that shows if the action was successful or not. Either Success or Failed. |
| Result Summary | Brief description of what the action did, or a summary of the failure reason if it did not succeed. |
| Error | Description of the error, populated only if the action failed. |
| MS Teams Team ID | The internal ID of the Microsoft Teams team associated with the linked channel. |
| MS Teams Channel ID | The internal ID of the linked Microsoft Teams channel. |
Examples
Example 1: Automatically link a war room channel during a major incident
When a high-severity incident is triggered, use this action to automatically link your sre-war-room channel in the SRE Team within your PagerDuty Microsoft Teams organization. Pair this with a notification action that sends the Channel URL output to responders, so the entire team has immediate access to the coordination channel.