The Slack Message Agent bridges Slack and DevRev, automatically creating DevRev issues, tickets, or incidents from Slack messages. With @mentions assignment enabled, it parses @mentions to auto-assign owners and spectators, posts confirmation links back in the thread, and prompts users when required context is missing.

Install

1. Install the DevRev Slack app.

2. Install the Slack message agent in your org.

Configure the custom Slack bot

1. Go to Slack API and create a new app From scratch.

2. Go to Basic Information → App Credentials and copy the Signing Secret.
   ▎ 💡 Save this somewhere safe — you'll need it when configuring DevRev.

3. Add bot scopes
   Go to OAuth & Permissions → Bot Token Scopes and add the following:

   Scope	Purpose
   app_mentions:read	Trigger on @bot mentions (required for @mention assignment)
   channels:history	Read messages in public channels
   channels:join	Allow bot to join channels
   channels:read	Read  public channel metadata
   chat:write	Post confirmation messages and prompts in threads
   files:read	Download file attachments from messages
   groups: history	Read messages in private channel
   groups: read	Read private channel metadata
   metadata.message:read	Read message metadata
   team:read	Resolve workspace URL for Slack thread links
   usergroups:read	Resolve @group mentions
   users:read	Resolve @user mentions to display names
   users:read.email	Map Slack users to DevRev users by email

4. Click Install to Workspace (or Reinstall if updating scopes), then copy the Bot User OAuth Token.

5. Go to Event Subscriptions → toggle Enable Events to ON.

6. Under Subscribe to bot events, add:

   1. app_mention — fires when someone @mentions the bot (required for @mention assignment flow)

   2. message.channels — fires on all public channel messages (for non-mention mode)

   3. message.groups — fires on all private channel messages (for non-mention mode)
      ▎ ⚠️ Leave the Request URL blank for now. You'll paste the Trigger URL from DevRev in a later step.

7. Add the bot to channels.

8. Invite both the custom Slack bot and the DevRev Slack Bot into each Slack channel you want to monitor.

Configure DevRev

1. Install the Slack Message Agent snap-in from the DevRev Marketplace.

2. Under Keyrings, enter:

   1. Slack Signing Token → the Signing Secret from step 2

   2. Slack Bot Token → the Bot User OAuth Token from step 3

3. Add Channel IDs for the object types you want to create:

   Input	What it does
   Incident Channel IDs	Messages in these channels create incidents
   Ticket Channel IDs	Messages in these channels create tickets
   Issue Channel IDs	Messages in these channels create issues

   ▎💡 Finding a Channel ID: Right-click the channel name in Slack → View channel details → the ID is at the bottom of the panel.

   ▎⚠️ A channel should only appear in one list. Do not add the same channel to incident, ticket, and issue lists.

4. Toggle the corresponding Sync switches to enable bidirectional custom field sync (Slack thread link, channel, timestamp) for each object type.

5. Select a Part ID — the DevRev part to associate with created tickets and issues. Required when ticket or issue channels are configured.

6. Select an Account ID — the default account for new rev users created from Slack. Required when ticket channels are configured.

7. Toggle Enable @Mention Assignment to ON to activate the full assignment flow.

   Behavior	When enabled ✅	When disabled ❌
   Owner assignment	First @mentioned person becomes the owner	owned_by is empty
   Spectators	Additional @mentioned people added as watchers	No watchers
   Title cleanup	@mentioned names stripped from the title	Names may appear in title
   Missing @mention	Bot replies asking user to @mention an assignee	Object created without owner
   File-only messages	Bot prompts user to include a description	Object created with minimal title
   Confirmation	Bot posts DevRev link + assignees in thread	No confirmation posted
   Forwarded messages	Original message content used for title	Same behavior

   Example:

   ▎ A user posts: @bot @alice @bob Fix the login page

   ▎ → Agent creates an issue titled "Fix the login page"

   ▎ → Alice is set as owner, Bob as spectator

   ▎ → Bot posts a confirmation in the thread with the DevRev issue link

8. Toggle Improve workflow line breaks to ON if you use Slack Workflow forms — this expands compact field formatting into separated paragraphs in DevRev.

9. Click Save. The snap-in will display a Trigger URL.

10. Go back to your Slack app → Event Subscriptions → paste the Trigger URL into the Request URL field. Slack will verify the URL automatically.

11. Click Save Changes in Slack.

TroubleShooting