Workflow Actions
Create a Dedicated Chat in Microsoft Teams
Microsoft Teams
Business
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. |