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 notifications to your selected channel when:

  • An issue is assigned to you
  • Someone comments on an issue you are watching
  • An issue you created changes status
  • A cycle starts or ends

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

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.