workboardworkboard

Discord

Kaneo can post task activity to a Discord channel whenever events occur in a project. This uses Discord's incoming webhook feature, so no bot or OAuth setup is required.

Create a Discord webhook

  1. Open Discord and go to the channel you want notifications in.
  2. Click the gear icon to open Channel Settings.
  3. Go to Integrations then Webhooks.
  4. Click New Webhook.
  5. Give the webhook a name (e.g. "Workboard") and optionally set an avatar.
  6. Click Copy Webhook URL. It will look like:
https://discord.com/api/webhooks/000000000000000000/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

URLs using discordapp.com are also accepted.

Connect Discord in Workboard

  1. Open Settings in the sidebar.
  2. Under Projects, select the project you want to connect.
  3. Open the Integrations tab.
  4. Expand the Discord section.
  5. Paste your webhook URL.
  6. Optionally add a channel name label for your own reference.
  7. Choose which events to subscribe to (see below).
  8. Click Connect.

Once connected you can enable or disable the integration with the toggle, update event subscriptions, or disconnect entirely.

Supported events

Event Default Description
Task created On A new task is created in the project
Task status changed On A task moves to a different status column
Task priority changed Off A task's priority is changed
Task title changed Off A task's title is edited
Task description changed Off A task's description is edited
Task comment created On A new comment is added to a task

You can toggle any combination of these events in the integration settings at any time.

Message format

Workboard sends Discord embed messages with:

  • A title describing the event (e.g. "Task Status Changed")
  • Task name with a clickable link to the task in Workboard
  • Fields for project, status, and priority
  • The name of the user who triggered the event

Make sure KANEO_CLIENT_URL is set to your public Workboard URL so task links work correctly.

Updating the webhook

To change the webhook URL after connecting, paste the new URL in the webhook field and click Save Changes. If you leave the field empty, the existing URL is kept.

Disconnecting

Click Disconnect to remove the integration. This deletes the stored webhook URL and all event settings for that project. You can reconnect at any time by pasting a new webhook URL.