# Connecting to Discord ## What is the Discord integration? With the Discord integration you can do a number of things on Dework that help make the platform work the way you want to engage your team and community. ## How to connect Dework to Discord **Step 1**: In the space/project that you want to connect to your Discord server, click on `Connect to Discord` at the top. ![Settings > Discord Integration > Connect to Discord](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FPsGz8RE6nPgv2JLVYfFU%2FIntegrations-Discord-01.jpg?alt=media\&token=7d5e709e-456f-4fc0-a468-b74e8131bf89) **Step 2**: You will redirected to a Discord page where you can select which server you want to connect to the Dework space. Select the server from the dropdown and click `Continue`. ![Select the server to connect to Dework](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F9SQYP4rhNypm9h3EAApu%2Fimage.png?alt=media\&token=baa4b508-8a57-4982-b16a-96bde07225a5) **Step 3**: By clicking `Authorise`, you will add the Dework bot to your server with the requested permissions so that it can operate seamlessly. ![Authorise adding the Dework bot to your serve](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FH1bhD4oUvALjD6z713f5%2FIntegrations-Discord-03.jpg?alt=media\&token=7a74b4d1-24d5-4a19-9576-128feb26ff1c) ## **What Discord integrations are there** Once authorised you will be returned to Dework where you can customise the integration on how you want to keep your server updated about the project's progress. There are 3 parts for Discord integration: **Good for Discussions**, **Tasks Awareness** and **Community Suggestions**, where you can find what suits your need most. ![Start customising the integration](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FwbnidRpSh48qeEgF39Yo%2FIntegrations-Discord-04.jpg?alt=media\&token=62c3b1eb-4a7c-4a9b-bd1e-d2e919705a73) Review how you want Dework updates to get shared to your Discord server. **Good for Discussions** * A thread per task on the channel you select is especially great for projects where you want to discuss or share feedback on each of this space/project's tasks. ![Task discussion thread integration for Discord](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F6nQpi1lMZtcc50F3foJn%2Fgood%20for%20discussion.PNG?alt=media\&token=02d4cf5d-b5a6-48d5-b42d-5a5f7b513969) **Tasks Awareness** * A message sent to a Discord channel when a task is created can be used to inform your community of new tasks/bounties on this space/project. * The status board with all open tasks option posts a message that syncs with Dework to show all open tasks for this space/project. ![Task awareness integrations for Discord](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FxlaE4xAkpAKVTQox6EuP%2Ftask%20awareness.PNG?alt=media\&token=f915a13b-8ad9-4b92-be8d-f9ce152953e6) **Community Suggestions** * A message sent to a Discord channel when a community suggestion is created can keep your team (or community) up to date with the latest inputs, so they can upvote or learn more. * The community suggestions status board provides you with a synced list of the top voted community suggestions for this project directly in a Discord server channel. ![Community Suggestion integrations for Discord](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2Fc3z6LsWLhHk46yX9bdqK%2Fcommunity%20suggestons.PNG?alt=media\&token=a3a6ffba-a679-4287-8bf7-ef18572a8012) #### **Activity Feed** * A message sent to a Discord channel when an activity feed update is posted on Dework can ensure more visibility or action from contributors ![Activity Feed integration for Discord](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FCQtXdhwwyIS7CCLaMSVm%2FIntegrations-Discord-05.6.jpg?alt=media\&token=38fc8535-dbca-4123-ab2f-aee4f8f3e90d) ## How to setup a Discord integration ### Create a thread when a task is assigned to someone **Step 1**: Click `Connect` next to `Create a thread when a task is assigned to someone`. Then select which channel on your Discord server you want to connect the Dework space/project to. ![Select the channel for the Discord integration](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FkkULqP3ptbF44U6eMODk%2Fdiscord%20integration%202.png?alt=media\&token=1d63b2a8-0f8d-49cc-bcba-64f3fadd3473) **Step 2**: Then click `Connect` and you're all set! ![Now this Discord channel will have threads created for assigned tasks](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FleiDKAw746AJFLHu41Lm%2Fdiscord%20integration%203.png?alt=media\&token=145c5e59-de4c-4894-bc52-2eda8f5b0f9d) {% hint style="success" %} After connecting to the Discord channel, you will start receiving updates directly in your Discord as tasks get assigned and move into progress. {% endhint %} ![Sample Discord updates and thread creation for tasks in Dework](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FpAKm9edff8A7PMh2U2La%2Fdiscord%20integration%204.png?alt=media\&token=fc6c466a-7229-4e23-ba5a-1fd5383e3f94) ### **Send a message when a task is created** Click `Connect` next to `Send a message when a task is created` to be able to select the channel you want to see all the newly created tasks. Then select the relevant channel from the dropdown. ![Connectiion to Discord channel for task creation message](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F0YpSNOOC2aYNuo9gzLaX%2FTask%20awareness%20connection%201.PNG?alt=media\&token=a4dbe55f-008e-4e80-8e4f-ee1dc9815631) {% hint style="success" %} After connecting to the Discord channel, you will start receiving updates directly in your Discord as tasks get created. {% endhint %} ![Task creation message in the Discord channel](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FNMZ6RiVzpyITayillaU5%2FTask%20awareness%20connection%202.PNG?alt=media\&token=f279c08d-9b6d-4101-9c1a-a5a5da06237a) ### **Post a status board with all open tasks** Click `Connect` next to `Post a status board with all open tasks` to connect to the channel you want to have an overview of open tasks. Then select the channel from the dropdown. ![Connectiion to Discord channel for task status board](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FHTuO7x1aXoMGPh57vw0O%2Ftask%20awareness%20status%20board%201.PNG?alt=media\&token=12a3afb4-af62-44b5-8165-ba4daad499ea) {% hint style="success" %} After connecting to the Discord channel, you will start seeing the status board for all open tasks from the Dework space/project directly in your Discord. {% endhint %} ![Task board message in the Discord channel](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F3zEPaaJMRTqA1dbFc4Mk%2Ftask%20awareness%20status%20board%202.PNG?alt=media\&token=89723cca-9cc2-44e0-939b-6404546970ad) ### **Send a message when a community suggestion is created** Click `Connect` next to `Send a message when a community suggestion is created` to connect to the channel you want to be notified with newly created community suggestions. Then select the channel from the dropdown. ![Connectiion to Discord channel for community suggestion creation message](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FPgldcjrIbQKg7OZFQAUM%2Fcommunity%201.PNG?alt=media\&token=58a1c69c-8461-46fe-944c-d04b3685461e) {% hint style="success" %} After connecting to the Discord channel, you will start receiving community suggestion updates directly in your Discord as new suggestions get created. {% endhint %} ![Community suggestion message in the Discord channel](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FmY8gI5TvP5xOriBMDluN%2Fcommunity%202.PNG?alt=media\&token=401f0bd2-2d13-46cc-a5b4-5571bd1c6926) ### **Post a status board with all community suggestions** Click `Connect` next to `Post a status board with all community suggestions` to connect to the channel you want to have a overview of community suggestion. Then select the channel from the dropdown. ![Connectiion to Discord channel for community suggestion status board](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F0lYL0PWmdjojTcf6cWd8%2Fcommunity%20overview%201.PNG?alt=media\&token=7217bd70-7728-4279-8acf-f3276685d3b0) {% hint style="success" %} After connecting to the Discord channel, you will start seeing the Community Suggestion status board that lists them directly in your Discord. {% endhint %} ![Community suggestion status board message in the Discord channel](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FVFOsqZQjPy5JiGEzpjrQ%2Fcommunity%20overview%202.PNG?alt=media\&token=2bc55ffc-41c1-4638-81ac-23c193404280) ### Send a message when the activity feed is updated Click `Connect` next to `Send a message when the activity feed is updated` to connect to the channel you want to be notified with newly created Activity Feed updates. Then select the channel from the dropdown. {% hint style="info" %} **Note**: Learn more about the Activity Feed on [setup-your-first-space](https://dework.gitbook.io/product-docs/guides-for-orgs/setup-your-first-space "mention") {% endhint %} ![Connectiion to Discord channel for activity feed update message](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FQGKfBuTrzX0VjmeyA0CW%2FIntegrations-Discord-07.61.jpg?alt=media\&token=aa39fe91-2389-4df7-8df9-5493801671d9) {% hint style="success" %} After connecting to the Discord channel, you will start receiving activity feed updates directly in your Discord as new updates get created. {% endhint %} ![Activity Feed update in the Discord channel](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FNAEWJRIRQchfWZOHi8GF%2FIntegrations-Discord-07.62.jpg?alt=media\&token=deb7ff0e-90e2-4373-9c8c-16ea425532bf) ## Notes * You can also connect to Discord at the top of any space/project and then go to `Settings` to customise the Discord integration. ![Click on ⚙️ to customise the integration](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FrpqsBLYrZsxXhjeyFy0q%2FIntegrations-Discord-08.jpg?alt=media\&token=3949fc4f-7360-4a8c-b4f7-5b371a1b745a) * When you use nested a space/project under the one you setup with a Discord integration, the notifications of the nested space/project will be pushed to the same Discord channels. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://dework.gitbook.io/product-docs/guides-for-orgs/connecting-to-discord.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.