📘
Availability
This workflow action is available on Business and Enterprise for Incident Management pricing plans. Contact the Sales Team to upgrade to an account with this action.

Description

Add a Microsoft Teams dedicated chat to an incident with custom event selection. The chat will include an incident notification card with real-time updates and incident action buttons. This action will also automatically add connected incident responders to the chat.

Event Selection Options

Highlights only: Receives notifications for key incident milestones and important changes in PagerDuty, including when incidents are resolved, reopened, or have priority/status updates.
Status updates only: Receives notifications only when incidents are resolved or when status updates are published in PagerDuty.
All updates: Receives notifications for all incident activity in PagerDuty, including assignments, escalations, acknowledgments, responder actions, workflow changes, and task updates.
No updates: No follow-up notifications are sent after the chat is created.

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	Select the name of the Microsoft Teams Organization the meeting is in.
Chat Name	Enter your preferred chat name. If you do not enter a meeting name, it will default to `incident_{incident-number}`.
User	The owner of the chat. If not provided, the owner will be determined by the current rules described in Incident Workflows.
Event Selection	The webhook events for this chat. See Event Selection Options.

Outputs

Name	Description
Chat URL	The URL for the MS Teams chat. This will be a direct link to the MS Teams chat.
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 if it failed.
Error	Brief description that is populated if the action failed.