mustafahasankhan / apps.clickup

This Repository is for the GSOC 2022 ClickUp app integration for Rocket.Chat

ClickUp Integration for Rocket.Chat

The ClickUp App for Rocket.Chat provides a seamless integration between ClickUp and Rocket.Chat and improves collaboration between teams. The application allows users to create and manage thier tasks and workspace, subscribe to task events, create new tasks, edit and delete their tasks, lists, folders, spaces & workspaces and do much more right from Rocket.Chat.

🚀 Features

• Quick and easy setup.
• Login to ClickUp with one click using built-in OAuth2 mechanism.
• Subscribe to Task Events and get notified about new comments, priority changes, assignee updates, etc.
• Retreive and manage tasks right from Rocket.Chat channels.
• Create new tasks from Rocket.Chat and make channel of task assignees.
• Edit the tasks right in Rocket.Chat and share them with other channel members.

🔧 Installation steps

1. Clone this repo and Change Directory:
   git clone https://github.com/RocketChat/Apps.ClickUp.git && cd Apps.ClickUp/

2. Install the required packages from package.json:
   npm install

3. Deploy Rocket.Chat app:
   rc-apps deploy --url http://localhost:3000 --username user_username --password user_password Where:

   • http://localhost:3000 is your local server URL (if you are running in another port, change the 3000 to the appropriate port)
   • user_username is the username of your admin user.
   • user_password is the password of your admin user.

   For more info refer this guide

📲 Setup guide

• Create an app on ClickUp by following these steps:

1. Navigate to Integrations page in team settings.

2. Select the ClickUp API tab.

3. Click on Create an App, enter desired app name and your server's URL without trailing slash in the Redirect URL(s) input box.

4. Click on Create App button to generate a Client ID and Client Secret.

• Fill the details in the ClickUp app on your server by following these steps:

1. Navigate to Administration->Apps.

2. Select the Installed tab.

3. Click on ClickUp, and go to Settings tab.

4. Enter your generated a Client ID and Client Secret and click on Save changes button.

• Start the authorization by using /clickup-app auth slash command.