Microsoft Teams Blameless Bot

The Teams Blameless Bot allows users to easily orchestrate incidents with less toil and provides a comprehensive framework to work through incident resolution and data collection.

note

We recommend you first read through our Microsoft Teams integration setup docs and install the bot first.

Getting Started

Once the Blameless bot is installed, you can start an incident in Teams by mentioning the bot @blamelessbot from any channel that the Blameless Bot has access to.

@ message Blameless bot

Upon mentioning the bot, it will provide you a list of command options, including starting an incident and showing recent incidents.

blameless bot commands outside an incident

Starting an Incident

  1. Click on "Start Incident". The bot will then prompt you to specify a type, severity, and description.
Start incident command

Once the incident starts, the bot will create a dedicated incident channel and display a summary.

Incident rundown summary

Incident Management via the Blameless Bot

After creating an incident, it's time to work through the incident and manage it with the help of the bot, including tasks, roles, incident lifecycle, data collection and more. The dedicated incident channel will be populated with the incident summary for immediate context.

Incident rundown summary

As a first step, the incident creator will be prompted with some suggested actions to start managing the incident.

Suggested initial commands

In addition to the initial suggestions, the Blameless Bot provides several commands to facilitate workflows during the incident.

@ message Blameless botAll commands

The following table lists available bot commands to help manage the various aspects of an incident.

CategoryAvailable Commands
IncidentAssign Incident Role
Set Incident Status
Set Incident Type
Set Incident Description
Set Incident Severity
Show Incident
Invite User to Incident
Mark Incident as Duplicate
Resolve Incident
Delete Incident
TasksAdd Task
Assign Task
View All Tasks
View Your Tasks
TagsShow Tags
Manage Tags
On-CallShow On-Call
Show Escalation Policy
Trigger Alert
Timeline EventsAdd Timeline Message
Show Timeline Events
AdvancedAssign Postmortem Role
Send Postmortem as Email

Incident Commands

Assign Incident Roles

Users can assign roles by selecting a role/user combination from the dropdowns.

Assign Role

Upon role assignment, the bot will show a success message and display the tasks list for the current incident phase.

Role assigned

Set Incident Status

Users can move the incident through the various phases by selecting the incident phase they'd like to transition to.

Set incident status

Set Incident Type

Users can set the incident type by selecting a new incident type.

Set incident type
note

As noted in the window, changing the incident type will not affect the tasks created for the incident, based on the previous incident type.

Set Incident Severity

Users can change the incident severity by selecting a new severity.

Set incident severity

Set Incident Description

Users can set the incident description by entering a description in the text area.

Set incident description

Resolve Incident

When you are ready to resolve an incident, simply select the option from the dropdown and the bot will resolve the incident and you may begin the postmortem process.

Upon resolution, the bot will provide a final, updated, incident rundown summary in the channel, and an updated task list for the Resolved state.

Resolve incidentResolved state task list

Delete Incident

Upon deleting an incident, the bot will delete the incident channel, as well as the incident itself from the Blameless system.

Show Incident

The Show Incident command will show the latest incident rundown in the incident channel.

Incident Rundown

Invite User to Incident

You can explicitly invite users to the existing incident by selecting the user from the dropdown. Invited users will automatically be added to the incident team in our web UI as Participants.

Invite User

Mark Incident as Duplicate

To mark an incident as a duplicate specify the other, duplicate, incident and its ID. As a result, the bot will mark the incident as a duplicate in the Blameless system, adjust the status to DUPLICATED, and add an entry to the incident timeline to reflect the change.

Mark as duplicateMarked as duplicateDuplicate entry in timeline

Tasks

The Blameless bot facilitates managing tasks during an incident via several commands designed to allow for ease when adding, assigning, and completing your incident tasks.

Tasks provide a mechanism by which you can ensure that certain items are completed or suggested during an incident lifecycle. These tasks can be assigned to each phase of the incident, as well as to a specific role or owner.

As the incident progresses through each subsequent phase, the tasks for that phase will become available.

Add Task

  1. To create a new task, first select a task assignee type:
  • a role specific task or
  • a user specific task
  1. Next, based on your assignee type selection, select either a user or a role to assign the new task to.
  2. Finally, enter a task description and add the task.
Add task

Upon successfully creating a new task, the bot will present the task list which includes the newly created task.

Newly added task

Interacting with Tasks

  1. To mark a task as complete or incomplete, simply select the "View Tasks" command.
  2. Toggle the task checkboxes accordingly.
  3. Click "Update".
Interact with tasks

Upon successfully toggling task states, the bot will respond with a summary of the task changes.

Updated Tasks

Tags

The Blameless bot allows you to capture metadata during an incident via our flexible tags mechanism. You can manage and view tags by category helping you to enrich your incident data and reporting.

  1. To add or remove tags, select the "Manage Tags" option.
Manage TagsTags added

You can view your tags at any time via the "View Tags" command.

View Tags

On-call

The Blameless bot allows you to streamline your on-call workflow during an incident, including the ability to show on-call, escalation policies, and take action by triggering alerts.

Show on-callShow on-callShow on-callShow on-call

Incident Timeline

You can view the incident timeline at any time, and add a custom event to the timeline via the bot by using our Timeline commands.

View timeline
  1. Select the "Add Timeline Message" command.
  2. Enter the message in the Description field.
  3. Click on "Add Timeline Message".
Add timeline event

During an incident, users can also capture important messages, files, and images as highlights to the incident timeline via the messages action menu. In the top right of the message box click on the ellipse (...) to bring up the “More actions” menu and select “Capture highlight” to automatically capture the text as a new timeline event.

Message actions menuEvent captured

Advanced Commands

From the advanced menu, users can leverage postmortem related commands, including assigning postmortem roles, and the ability to send the postmortem via email.

Assign postmortem roleSend postmortem as email

Supported Integrations

The Blameless bot supports a variety of integrations that provide streamlined workflows during an incident, including JIRA for ticketing, Zoom for video bridge, and Pagerduty for on-call management.

JIRA

With our Blameless bot JIRA integration, a corresponding ticket will be created for each incident, and you may also create follow-up actions as needed during the lifecycle of an incident.

Incident rundown summary

Follow-up Actions

Follow-up actions can be created at any time during an incident.

Simply describe the follow-up action in the Teams chat and then mouse over the message. In the top right of the message box click on the ellipse (...) to bring up the more actions menu and select "Capture as follow-up action" to automatically create a JIRA ticket from the selected text.

Create follow-up actionFollow-up actions success

Zoom

With our Blameless bot Zoom integration, a Zoom video bridge will be displayed in your incident rundown so you can collaborate more effective over video together.

Incident rundown summary

PagerDuty

With our Blameless bot PagerDuty integration, you can streamline your on-call workflow during an incident, including the ability to show on-call, escalation policies, and take action by triggering alerts.

Show on-callShow on-callShow on-callShow on-call