Skip to main content

Integrations

Discord

HacknPlan's Discord integration allows teams to execute project commands and receive updates directly in Discord.

It supports two command groups:

  • Team commands: for linked HacknPlan users with project permissions
  • Community commands: for non-team users (for example, bug reports and feature suggestions)

Create an integration

In HacknPlan, open Administration -> Integrations, then select New in the Discord panel.

Authorize the HacknPlan bot in your Discord server and accept all requested permissions.

After authorization, configure integration settings in HacknPlan.

Community command configuration

You can define where report-bug and suggest-feature create items:

  • target category
  • target board (or backlog)

Default behavior:

  • report-bug creates bug tasks (if Bug category exists)
  • suggest-feature creates user stories

Team commands require account linking.

Workflow:

  1. each team member runs /request-access in Discord for the project
  2. in HacknPlan integration settings, map Discord users to HacknPlan users
  3. validate and save

You can revoke access per user at any time.

Configure permissions in Discord

In Discord, go to Server Settings -> Integrations -> HacknPlan -> Manage.

Configure:

  • roles and members allowed to use commands
  • channels where commands are allowed
  • command-level overrides

Ensure the HacknPlan bot/role is added to channels where commands will be used.

Team commands

  • create-task
  • create-subtask
  • create-story
  • create-story-task
  • create-board (admin)
  • change-stage
  • change-importance
  • add-comment
  • assign-user
  • send-to-board
  • send-to-backlog
  • log-work
  • toggle-subtask
  • view-item
  • view-board
  • list-subtasks
  • list-story-tasks

Most commands support a project argument when multiple projects are connected to the same server.

Community commands

  • report-bug
  • suggest-feature

These commands open a Discord modal for title and description input and do not require linked HacknPlan user identities.