# 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.