Simple Data Pipe connector for slack.com

🚫 This project is no longer maintained.

This connector uses the Slack REST API to fetch messages from one or more channels. The Simple Data Pipe SDK is used to store the data in Cloudant. One JSON record is created for each message in the selected channel(s):

#####Message record structure

{
 "..." : "<cloudant document properties such as _id and _rev>",
  "channel": {
    "id": "<slack_channel_id>",
    "name": "general-stuff"
  },
  "message": {
    "type": "message",
    "user": "<slack_user_id>",
    "text": "Who turned off the light?",
    "ts": "<timestamp>"
  },
 "pt_type": "<slack_channel_id>"		 		 
}

Note: System messages (e.g. @somebody joined #channel) are included in the data set by default.

Need to load data from other sources? Check out the connector repository.

Pre-requisites

General

Verify the following:

• You have a valid user id for the Slack team you want the Simple Data Pipe to access.
• The Slack team is configured to allow application access.
• You are registered as a Slack Developer to configure OAuth access for the Simple Data Pipe.

Deploy the Simple Data Pipe

Deploy the Simple Data Pipe in Bluemix using the Deploy to Bluemix button or manually.

Services

This connector does not require any additional Bluemix service.

Install the Simple Data Pipe connector for Slack

When you follow these steps to install this connector, add the following line to the dependencies list in the package.json file:

"simple-data-pipe-connector-slack": "git://github.com/ibm-cds-labs/simple-data-pipe-connector-slack.git",

Enable OAuth support and collect connectivity information

You need to register the Simple Data Pipe application before you can use this connector to load data.

• TODO? Yup!

Using the Simple Data Pipe connector for slack.com

To configure and run a pipe

1. Open the Simple Data Pipe web console.
2. Select Create A New Pipe.
3. Select Slack Data Source for the Type when creating a new pipe.
4. In the Connect page, enter the application id and secret from the Slack application settings page.
5. When prompted, select a Slack team you belong to and authorize the Simple Data Pipe application to access it in read-only mode.
6. Select a channel (or All channels) from which to load messages.
7. Schedule or run the data pipe now.

License

Copyright [2016] IBM Cloud Data Services

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.