Skip to content

datadotworld/slack-app

Repository files navigation

Slack-app

data.world slack application.

How it works

Once you've the app up and running and installed in your workspace (See CONTRIBUTING.md for setup instructions) you can perform the following actions :

   1. OAuth handshake / User binding
   2. Unfurling of data.world links 
   3. Subscribe / Unsubscribe to Dataset, Project or Account using slash commands.
OAuth handshake / User account binding

This means binding a user's slack account to his/her data.world account and there by giving data.world slack app the permission to perform read, write and webhook operations on behalf of the user. User can revoke permission at will from data.world settings page.

Account binding is required to be able to run data.world slash commands. Hence, the data.world slack app will prompt the user to complete Account binding any time he/she tries to use any of the available commands in slack.

Unfurling of data.world links

Any data.world link pasted in a slack channel will be automatically unfurled, this requires at least one slack user in the workspace to have completed account binding. For ambiguous urls like workspace url, the underlying dataset or project will be unfurled.

Subscribe / Unsubscribe to Dataset, Project or Account using slash commands

Using the /data.world user can perform a series of actions on a slack channel(private or public) where data.world bot is a member. To make use of these slash commands, slack user must have completed account binding successfully. below is a list of commands and there description

  1. Subscribe to a data.world dataset : /data.world subscribe [owner/datasetid]

  2. Subscribe to a data.world project. : /data.world subscribe [owner/projectid]

  3. Subscribe to a data.world account. : /data.world subscribe [account]

  4. Unsubscribe from a data.world dataset. : /data.world unsubscribe [owner/datasetid]

  5. Unsubscribe from a data.world project. : /data.world unsubscribe [owner/projectid]

  6. Unsubscribe from a data.world account. : /data.world unsubscribe [account]

  7. List active subscriptions. : /data.world list

  8. Show this help message : /data.world help

Releases

No releases published

Packages

No packages published

Languages