Git Product home page Git Product 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).

rocket.chat.app-slackline's People

Contributors

dependabot[bot] avatar heilerich avatar

Watchers

 avatar

rocket.chat.app-slackline's Issues

/slackline command not appearing

I followed all steps to create a Slack app and install it on my workspace.
On Slackline I entered the Slack app ID and Secret.

When I try to run the command /slackline login on a Rocket Chat channel it says it doesn't recognize the command.

I did run the following cUrl command and it returns an Internal Error:

curl -X POST https://chat.mydomain.org/api/apps/public/f36c9423-c624-49f7-a077-318ade5dc13b/slackevent

This is the log registered for the command above:

April 23, 2022 3:06 PM: "apiExecutor" (1ms)
Instance: gnK3pNkTi72A47zKG
debug: 2022-04-23T18:06:16.691Z Caller: anonymous OR constructor

[
  "slackevent's post is being executed...",
  {
    "method": "post",
    "headers": {
      "host": "localhost:5000",
      "user-agent": "curl/7.68.0",
      "accept": "*/*",
      "x-forwarded-for": "000.0.217.00",
      "x-forwarded-host": "chat.mydomain.org",
      "x-forwarded-server": "chat.mydomain.org",
      "connection": "Keep-Alive"
    },
    "query": {},
    "params": {},
    "content": {}
  }
]

warning: 2022-04-23T18:06:16.691Z Caller: failRequest -> failRequest

[
  "Received invalid call so slackevent endpoint",
  {
    "request": {
      "method": "post",
      "headers": {
        "host": "localhost:5000",
        "user-agent": "curl/7.68.0",
        "accept": "*/*",
        "x-forwarded-for": "000.0.217.00",
        "x-forwarded-host": "chat.mydomain.org",
        "x-forwarded-server": "chat.mydomain.org",
        "connection": "Keep-Alive"
      },
      "query": {},
      "params": {},
      "content": {}
    },
    "message": "No request type"
  }
]

debug: 2022-04-23T18:06:16.691Z Caller: anonymous OR constructor

[
  "slackevent's post was successfully executed."
]

The log for the GET oauth curl command is basically the same with this difference: "message": "Expected code & state"

What else could I do to further debug and troubleshoot this?

Thanks!

Could not find channel with name [channel-name] on slack

I've added the Slackline app to the #faq private channel but this error keeps happening:

image

I created a new app to make sure I didn't miss any installation steps but it gives the same error.
I've added the app to the channel but it didn't help.
I'm not seeing any error in the log file...
image

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.