Slack Snap-in
The Slack Snap-in lets you scale your customer support in Slack. With the DevRev Slack Snap-in, you can:
- Enhance support provided via Slack Connect channels
- Sync your Slack conversations with the DevRev inbox
- Let your customers create conversations from Slack
- Create DevRev tickets without leaving Slack
- Share and view work details
- Receive DevRev Slack notifications
Installing the Slack Snap-in
Follow these steps:
- Install the Slack Snap-in from the DevRev Marketplace.
- Select the dev org to install the Snap-in and confirm the install dialog.
- Enable the features you want and fill in the configurations.
- You can find a Slack channel ID by going to channel details
- Select an existing connection to Slack or establish a new connection.
- The connection needs to be an-org wide connection, make sure to check Make connection available to your DevOrg.
- NOTE: This requires that the user establishing the connection to Slack has permissions to install Slack Apps. Depending on your Slack workspace settings, you may need to ask an administrator to establish the connection or approve your installation request.
- Leave the sources as Create new or select existing sources with matching names if they have been created already.
Using the Slack Snap-in
In order to make use of these features, the Slack user initiating them must have a DevRev account. Specifically the Slack user email should match that of a user in DevRev.
Support via Slack Connect
The DevRev Snap-in offers various features to enhance and scale support provided via Slack connect channels. A Slack connect channel is a shared resource with one (or, rarely, more) external organization(s). You can enable this feature for one or more connect channels. To enable these features for a Slack connect channel, you will need to associate the connect channel with one or more customers. Once this association is made, any new ticket created in this channel will be associated with the specified customer and you can track selected Slack threads in your DevRev inbox.
To activate this feature
- Invite the @DevRev bot to the Slack connect channel.
- Run
/devrev link = <Customer external ref>
, for example:/devrev link = example.org
. You can find the value of the customer external ref in the External ref field of the selected customer in the Customers page in the DevRev app.
To deactivate this feature
You can remove the link between the your customer and the Slack channel by following these steps:
- Go to the Customers page in the DevRev app and select the customer to unlink. Copy its External ref.
- Run the command
/devrev unlink = <Customer external ref>
inside the Slack channel. For example:/devrev unlink = example.org
.
Sync support conversations
You can enable a 2-way sync between customer conversations in Slack threads and the DevRev inbox. This feature can only be used in a Slack connect channel. There are two ways to use this feature:
Sync via a DevU created ticket
- Create a ticket in a Support via Slack Connect enabled channel.
- The ticket has to be created from a RevU message, specifically from a message created by the other Slack organization's users.
- Check the Sync the thread with a conversation on DevRev checkbox.
Sync via a RevU (customer) initiated conversation
This feature allows customers to create a conversation in DevRev via Slack. When a user uses one of the configurable keywords in a Slack Connect channel, they will be prompted if they would like to create a conversation. If the user confirms, a new DevRev conversation will be created and a thread in Slack will be started. DevRev will sync the Slack thread with the DevRev conversation.
To enable this feature, Enable RevUser to create a conversation must be set in the Slack Snap-in configuration. The keywords can be configured via Keywords to enable 'send support request'.
Create tickets
You can create tickets in DevRev from Slack messages. To activate this feature in a private channel, you will need to invite the @DevRev bot.
Create a ticket from a Slack message
- Hover over a message in Slack and select the more actions menu (⋮).
- Select Create a ticket.
- Fill in the title. Other settings are optional.
- Submit the form.
Create a ticket with a slash command
- Run
/devrev create-ticket
. - Fill in the title. Other settings are optional.
- Submit the form.
Share and view work details
You can share the details of work (tickets or issues) or view them privately with the /devrev
Slack command. To activate this feature in a private channel, you will need to invite the @DevRev bot.
Share work details
Run /devrev show TKT-#
or /devrev show ISS-#
. You can include up to five space separated items, for example: /devrev show TKT-# ISS-# TKT-#
.
Privately view work details
Run /devrev view TKT-#
or /devrev view ISS-#
. You can include up to five space separated items, for example: /devrev view TKT-# ISS-# TKT-#
.
Receive DevRev Slack notifications
You can receive Slack notifications for the following DevRev events:
- A new ticket was created
- Must set Notify on Slack for created tickets
- A new conversation was created
- Must set Enable conversation notifications
- A new reply to an existing conversation
- Must set Enable conversation notifications
- NOTE: After a notification is sent for a new reply, it will not send another for the same conversations for at least 10 minutes.
List of available commands
You can run /devrev help
to display a list of available commands and their descriptions. Note: Slack doesn't support app commands in the threads.