Glossary of Jeli Slackbot Commands

A list of commands for Jeli's Incident Response bot.

Lesleanne Blakeley avatar
Written by Lesleanne Blakeley
Updated over a week ago

🐣 Getting Started with the Jeli Slackbot

The one command you need to know: /jeli

Getting help from Jeli's Slackbot and additional resources: /jeli help

Contextual help: /jeli help

Contextual help: /jeli help

All of the Jeli Bot Commands can be listed in Slack by running the /jeli help command at any time from any channel Jeli is added to, it’s an ephemeral message, so only you will see it. The help command is contextual, meaning it will suggest different commands depending on whether you’re in an incident channel (in the middle of incident response) or trying to import data from other Slack channels, but you can expand it to provide a list of all our commands.

If you forget everything else: /jeli

If you forget everything else: /jeli

We get it, learning a bunch of commands is a lot, if you forget everything, you can enter /jeli and we’ll prompt you with our most common commands.

🤖 Creating an Incident

Open a new incident: /jeli open

Open a new incident: /jeli open

Initiate incident response with a single click. Include the available information about the incident in the Add More Details section, and utilize any configured integrations in the Use Integrations section.

No field is required, if you do not add a name we will generate one for you from a randomized list of adjectives and nouns.

We’ll send you an ephemeral message **confirming the incident has been created ** with a link to the generated slack channel. We’ll also notify your selected broadcast channels that an incident has been created.

Add More Details

Every field in this section is optional, just add what you know now such as the:

  • Summary

  • Severity

  • Add or remove relevant Broadcast Channels

  • Assign yourself to a role within response

All of these fields are editable during response as well through various slash commands.

Use Integrations

Currently your Incident Settings will determine the default selections on this page and can be changed on a per-incident basis here, including:

Please note that using the Primary Jira ticket integration does change the naming scheme of the incident channels.

Incident Channel Naming

  • When an incident is created the generated Slack channel name will follow this format: #jeli-[incident number]-[incident name] such as #jeli-29-docs-pages-are-down

  • If you elect to have a primary Jira ticket automatically created, it will add the Jira ticket number as a prefix on the channel name as opposed to the #jeli- prefix: #[jira ticket project and ticket id]-[incident name] such as #inc-133-payroll-is-down

  • If you do not add a name we will generate one for you from a randomized list of adjectives and nouns and the channel name will get the #jeli- prefix or the Jira ticket prefix based on your configurations, such as #eng-34-full-lemon

  • To distinguish demo incidents from actual events, the naming differs: #jeli-demo-[incident name]-[YYYY-MM-DD] such as #jeli-demo-just-testing-2023-06-20

  • if Jeli is currently undergoing an incident of our own impacting incident creation, we have fallbacks in place which will change the name format to: #jeli-[incident name]-[YYYY-MM-DD] such as #jeli-emails-are-delayed-2023-06-21

Aliases: /jeli incident, /jeli open-incident, /jeli start, /jeli start-incident

Add a summary to an incident: /jeli summary

Add a summary to an incident: /jeli summary

Type what you know about the issue so far and update it when anything significant changes.

The summary is the main description of the incident. It is displayed in the overview responders can use to get up to speed in the incident channel. As well as in the incident notification sent to the broadcast channels, where those not involved in active response can stay up to date on the status of response.

To quickly update the status without opening a dialog box use /jeli summary [type out summary before hitting enter]

Aliases: /jeli update-summary

Add a severity level to an incident: /jeli sev

Add a severity level to an incident: /jeli sev

Select from the severity options of 0, 1, and 2, provide some in the moment context behind your decision and customize the broadcast based on the severity. Severity is not required and can be disabled by request.

To quickly set the severity without opening a dialog box use /jeli severity [severity level number]

Aliases: /jeli severity, /jeli set-severity

🤹 Assigning Incident Roles

Set or Update an incident commander: /jeli ic

Set or Update an incident commander: /jeli ic

Select to assign anyone in Slack as the main point of contact for incident coordination. Anyone can use this command in the incident channel to claim or pass off the incident commander responsibilities.

When an incident commander is set, we update the role in the overview and broadcast channels. We also ping the assignee in the incident channel with the role prompt configured in settings, and DM them the same prompt for easy reference.

To quickly assign without opening a dialog box use /jeli incident-commander [@username|me]

Aliases: /jeli incident-commander, /jeli set-ic

Set or Update a communications lead: /jeli cl

Set or Update a communications lead: /jeli cl

Select to assign anyone in Slack as the main point of contact for incident communication. Anyone can use this command in the incident channel to claim or pass off the communication lead responsibilities. When a communications lead is set, we update the role in the overview and broadcast channels. We also ping the assignee in the incident channel with the role prompt configured in settings, and DM them the same prompt for easy reference.

To quickly assign without opening a dialog box use/jeli communications-lead [@username|me]

Aliases: /jeli communications-lead, /jeli set-cl

📣 Updating an Incident

Update the status of an incident: /jeli status

Update the status of an incident: /jeli status

Type an update on the current status of the incident to be sent to the incident channel and added to the update thread in the broadcast channels. Think of this like live-tweeting the incident, the status field has a limit of 240 characters.

To quickly update the status without opening a dialog box use /jeli status [type out status message before hitting enter]

Update the status of an incident: emoji or message shortcut

Update the status of an incident: emoji or message shortcut

You can convert an existing Slack message from any channel into a status update with our message shortcut,

Or react to a message with the 📣 :mega:, 📌 :pushpin:, or 📫 :mailbox: emoji to turn any message in the incident channel into a status update.

Aliases: /jeli status-update

Update an incident’s stage: /jeli stage

Update an incident’s stage: /jeli stage

Incidents often don’t follow the same path every time. Throughout response you can change the stage of the incident as you gain new information and pivot into different efforts.

The bot will prompt you to add some context to what led to those changes, to help inform stakeholders and give you a record free of hindsight biases for your incident review.

Our stages are simple: Investigating, Identified, and Mitigated. Having an understanding of “where we are within the incident” breaks the incident into smaller chunks and helps responders, both within engineering and on the customer communication side, reorient themselves around what new tasks they may be expected to perform in the next stage.

There is no single path to resolution: you can easily move back and forth between the stages as you gain new information and pivot your response.

Create follow ups: /jeli remind

Create follow ups: /jeli remind

Create follow ups to remind yourself or others to work on once impact is mitigated.

You can view them anytime with /jeli reminders

To quickly create a follow up without opening a dialog box use /jeli remind [me or @user] [type out follw up before hitting enter]

Add a link to an incident: /jeli link

Add a link to an incident: /jeli link

Add multiple links to the overview of the incident like quick access links to an incident video call, reference doc, and relevant dashboards.

Use the display text to describe what’s being linked.

Aliases: /jeli add-link

Create and link jira tickets: /jeli jira

Create and link jira tickets: /jeli jira

Create new Jira issues and link existing issues. For more information see our docs on:

Create a Statuspage.io incident: /jeli statuspage

Create a Statuspage.io incident: /jeli statuspage

Use Jeli’s Statuspage.io integration to share regular updates on your company’s status page to keep stakeholders and customers informed during an incident.

For more details, see our docs:

ℹ️ Finding information during an incident

Get the overview for a current incident: /jeli info

Get the overview for a current incident: /jeli info

Provides the full overview of the current incident, shown in the incident channel but is only visible to whomever runs the command. This will be shown automatically to everyone as they join the incident channel for the first time (it will only be visible to the individual who has just joined).

The incident overview is also what is visible in the broadcast channels and includes:

  • Incident Title

  • Incident Stage

  • When the incident was opened

  • Incident Severity

  • Link to the incident Slack channel

  • Summary

  • Assigned Incident Commander

  • Assigned Communications Lead

  • Added Links

  • And the most recent status update

Aliases: /jeli overview

Get the full list of statuses for an incident: /jeli history

Get the full list of statuses for an incident: /jeli history

Displays the most recent status update first and lists the entire status history in reverse chronological order. It is shown in the incident channel but is only visible to whomever runs the command.

The full list of status updates is also visible in a thread under the message containing the incident overview in the broadcast channels.

Aliases: /jeli status-history

Get a list of follow ups created: /jeli reminders

Get a list of follow ups created: /jeli reminders

Displays the full list of followups created during the incident. It is shown in the incident channel but is only visible to whomever runs the command. From here you can edit follow ups and mark them as done.

Aliases: /jeli followups, /jeli list-followups, /jeli followups-list

Get a list of active incidents: /jeli active

Get a list of active incidents: /jeli active

Displays all active incident response using the Jeli IR bot in your Slack workspace.

Helpful for when you’re not sure if someone’s already opened an incident for an issue, if you’re tracking multiple incidents at a time, or even if you lost track of your incident slack channel in a sea of other incident slack channels.

Get a summary of all the status updates in an active incident: /jeli catch-up

Get a summary of all the status updates in an active incident: /jeli catch-up

This command is most handy when you are joining an active incident channel or are participating in an incident and want to catch-up on all the latest happenings.

Jeli will use the status updates in the incident channel to create an AI summarized write up of what's happened so far.

Aliases: /jeli ketchup

📣 Escalate an Incident

Escalate an incident: /jeli page

Escalate an incident: /jeli page

Page those who are on-call or additional responders using /jeli page. This will trigger the workflow that you set up in your on call platform ie - PagerDuty.

🎁 Wrapping up an incident

Set an incident’s stage to mitigated: /jeli stage

Set an incident’s stage to mitigated: /jeli stage

When moving the incident to the mitigated stage, we also begin creating the Jeli opportunity for when you’re ready to begin your incident review. After you provide an optional reason for the stage change, you will be prompted with the option to rename the incident based on all of the information you’ve gathered throughout response, and provide a new summary.

The new name and summary will be included in the opportunity created in Jeli, as well as updated in the broadcast channels in Slack. Changing the name of the incident will not change the name of the incident channel created in Slack.

Moving to the mitigated stage also means we will no longer send you status update reminders on your set intervals. We know that the time between mitigation and closing out an incident can be vary depending on your organization’s process, so feel free to take your time in this stage.

*Moving to the mitigated stage is not required to close out an incident, address followups, or create a Jeli opportunity. If you skip this stage, we’ll still prompt you with those items upon closing. You can also move back into the identified or investigating stages from mitigated and continue response if need be. (Status reminder intervals will be restored if you return to either identified or investigating stages.)

Address follow ups

Address follow ups

When an incident is moved to the mitigated stage, we send the incident channel the list of follow up items you asked us to remind you about throughout the incident. You can choose to schedule a reminder on a follow up and we’ll ping you again about that item at the time of your choosing.

You can also mark the follow up as done, if you’ve already gotten around to it, or edit the follow up to add more details or to remind someone else about that item.

*Scheduled reminders for follow ups will not ping to remind you if the follow up is marked as done, marked as ignored, or the incident is closed.

👋 Closing out an incident

Close out an incident in a mitigated stage: /jeli close

Close out an incident in a mitigated stage: /jeli close

Moving an incident to closed ends Jeli’s IR bot’s involvement in the incident channel. Since you have already mitigated the incident, closing it will look a little different than if you are closing it from an investigating or identified stage.

You will be prompted to fill out the close modal and any follow-ups you created during the incident will appear after you close the incident with options to:

  • "Schedule a reminder"

  • "Edit" the follow-up

  • "Mark Done" if you've completed the follow-up

We will update the Jeli opportunity with any messages sent in the incident channel since mitigation, and notify you when that is complete. We will also set the final status update with a link to the Jeli opportunity.

The broadcast channels will be updated as well, moving the incident stage to closed, setting an incident closed time, and linking to the Jeli opportunity.

Close out an incident in an investigating or identified stage: /jeli close

Close out an incident in an investigating or identified stage: /jeli close

You can close out an incident at any stage, when closing out an incident that is in the investigating or identified stages.

You will be prompted with the option to rename the incident based on all of the information you’ve gathered throughout response, update severity, provide a new summary and address any follow-ups. The new name and summary will be included in the opportunity created in Jeli, as well as updated in the broadcast channels in Slack.

Changing the name of the incident will not change the name of the incident channel created in Slack.

Jeli will prompt you when you’re closing out an unmitigated incident, and give you the option to instead change the stage of the incident to mitigated if you’d like to do so.

Closing the incident will then ends Jeli’s IR bot’s involvement in the incident channel, and creates an opportunity in Jeli for when you’re ready to begin your incident review. Jeli will then update the channel with a final status indicating that the incident is closed and provide a link to the Jeli opportunity.

The broadcast channels will be updated as well, moving the incident stage to closed, setting an incident closed time, and linking to the Jeli opportunity.

Aliases: /jeli close-incident, /jeli end, /jeli end-incident

🥷 Running a demo incident

Run a demo incident: /jeli demo

Run a demo incident: /jeli demo

Running a demo incident with Jeli’s IR bot gives you all the same features as normal response, but we do not broadcast the incident, or upload the slack channel into Jeli once the incident is closed.

This is great for familiarizing yourself with Jeli’s features without creating any false alarms. You can use it when running stress tests, gamedays, or mock incidents to practice response with your team!

Did this answer your question?