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.
- Goto Create Slack App
- Enter a name and select your workspace
- Click
OAuth & Permissions
in the Sidebar, enable the following scopesusers:read
,groups:history
,groups.write
,groups.read
,mpim:history
,mpim:write
,mpim:read
,im:history
,im:write
andim:read
and save. - Click
Add new redirect URL
. Enter the url for theoauth
endpoint from the Slackline settings page in your Rocket.Chat instance, click add and save. - Click
Event Subscriptions
the Sidebar and enable Events - Enter the url for the
slackevent
endpoint from the Slackline settings page in your Rocket.Chat instance as request URL. - Subscribe to the
message.groups
,message.im
andmessage.mpim
events. - Click
OAuth & Permissions
in the Sidebar. Click install app to workspace.
These instructions are for individual users of the RC instance:
- To use the app enter
/slackline login
anywhere. - Click the link, login to slack
- 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. - 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).