yannickglt / alfred-slack

The Slack workflow for Alfred app
GNU General Public License v2.0
330 stars 31 forks source link
alfred alfred-workflow alfred3-workflow slack

alfred-slack

Gitter

Open conversation with a contact in Slack

To start

  1. Download and install Slack.alfredworkflow

  2. Create a custom app for your team following these steps.

  3. Once you have your client ID and Secret, visit the address https://yannickglt.github.io/alfred-slack/ to generate a unique code for authentication in the Workflow.

    1. Enter your team name in the first field and your client ID in the second one, then click on the button "Generate code".

      image

    2. Authorize the app to access your Slack team with the rights below.

      image

    3. Copy your generated unique code in your clipboard.

      image

  4. Launch the slack workflow with the parameter --add-client followed by the concatenation of the generated unique code and client Secret separated by a colon (e.g.: UNIQUE_CODE:CLIENT_SECRET). You can add several clients if you want to collaborate with several teams. You just need to repeat the two last steps.

    Example:

    slack --add-client 1234567890.123456789012|1234567890.123456789012.abcdef1234:1234567890abcdef1234567890abcdef
  5. Launch the cache refresh by taping the command --refresh.

    Example:

    slack --refresh

    The cache refresh may take up to several minutes depending on your organization size.

  6. Enjoy!

    Note: install the Packal Updater workflow if you want automatic updates.

How to use

Create an app for your team

  1. Go to the URL https://api.slack.com/apps/new and click on the button Create a Slack app.

    image

  2. Give it an app name e.g.: "Alfred Workflow", select your team in the list and click on the button Create App.

    image

  3. Note the client ID and Secret!

    image

:warning: Never share the client secret on the web or on public repository

  1. Go to the section OAuth & Permissions (under the Features category), add the two redirect URLs http://yannickglt.github.io/alfred-slack/ and https://yannickglt.github.io/alfred-slack/ and click on Save URLs.

    image