Slack Integration

Get notifications and manage issues from Slack.

Setup

Connect Slack from Settings → Integrations. The OAuth v2 flow will ask you to select a Slack workspace and channel for notifications. Velocity requests the following scopes:

  • chat:write — post messages to channels
  • commands — handle slash commands
  • app_mentions:read — respond to @mentions
  • links:read + links:write — unfurl Velocity URLs

Notifications

Once connected, Velocity can post to a channel you choose when:

  • An issue is created
  • An issue changes status
  • An issue is assigned
  • Someone comments on an issue

Pick the channel and the events under Settings → Integrations → Slack, and invite the Velocity app to that channel (/invite @Velocity). A bulk change of more than three issues posts one summary instead of a message per issue.

Slash Commands

Use /velocity in any Slack channel to interact with Velocity:

/velocity create "Fix login bug" --priority high
/velocity search auth issues
/velocity status ENG-42
  • create files an issue and posts it to the channel. --priority (or -p) takes urgent, high, medium, low or none. Issues go to the default team set in the Slack integration's settings, or the workspace's first team, and are attributed to the person who connected Slack.
  • search lists up to five issues whose titles match, visible only to you.
  • status shows an issue's status, priority and assignee, visible only to you.

URL Unfurling

When someone pastes a Velocity issue URL in Slack, the integration automatically unfurls it into a rich preview showing the issue title, status, priority, and assignee.

Security

Incoming requests from Slack are verified using Slack's request signing. The integration validates the X-Slack-Signature header against the signing secret to prevent spoofed requests.