Code Monkey home page Code Monkey logo

rocket.chat.app-slackline's Introduction

Slackline

Slackline is a Rocket.Chat App that allows users to receive private messages from a connected slack workspace (the RC built-in slackbot does not have access to direct messages and private groups) and also import their private message history.

To use this app the Rocket.Chat administrator must (I) must install this app in the RC instance, (II) create a Slack app in their workspace and (III) enter the Slack app API keys in the settings for this app.

1. Setup Slack Workspace App

  1. Goto Create Slack App
  2. Enter a name and select your workspace
  3. Click OAuth & Permissions in the Sidebar, enable the following scopes users:read, groups:history, groups.write, groups.read, mpim:history, mpim:write, mpim:read , im:history, im:write and im:read and save.
  4. Click Add new redirect URL. Enter the url for the oauth endpoint from the Slackline settings page in your Rocket.Chat instance, click add and save.
  5. Click Event Subscriptions the Sidebar and enable Events
  6. Enter the url for the slackevent endpoint from the Slackline settings page in your Rocket.Chat instance as request URL.
  7. Subscribe to the message.groups, message.im and message.mpim events.
  8. Click OAuth & Permissions in the Sidebar. Click install app to workspace.

2. Usage

These instructions are for individual users of the RC instance:

  1. To use the app enter /slackline login anywhere.
  2. Click the link, login to slack
  3. Go to any private channel of which you want to import the message history and do /slackline import. This can take a few seconds, so don't worry if nothing happens at first.
  4. Enter /slackline enable to receive future messages from any private group, that you are part of, or from direct message conversation. This works only slack to RC, not the other way round.

Caution Due to API restrictions the app cannot check if messages have already been imported. So before importing any private conversations, check that messages haven't been imported already (by somebody else in the conversation) or you will have a lot of duplicates. I am aware of this issue, but I can't fix it until the Rocket.Chat developers implement the according functions in the Rocket.Chat App Engine (which is still in a beta stage).

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.