Extensible Slack App for link unfurling

Installs: 66

Dependents: 5

Suggesters: 0

Stars: 3

Watchers: 1

Forks: 3

Open Issues: 0


v0.8.0 2018-06-01 17:43 UTC


Slack app for unfurling issue links

Slack App

Create or Manage your app.

You need Verification Token (SLACK_VERIFICATION_TOKEN) for next step.

Under Features:

  • enable Events API for link_shared event with links:read scope.
    1. Click Event Subscriptions on the left.
    2. Click Enable Events.
    3. Click Add Workspace Event and add link_shared.
    4. Click Add Domain and type your domain.
    5. Click Save Changes.
  • add links:write permission scope
    1. Click OAuth & Permissions on the left.
    2. Go to Scopes section and select Add link previews to messages in the list of permissions.
    3. Click Save Changes.
  • enable Incoming Webhooks

Obtain OAuth Access Token (SLACK_API_TOKEN) under OAuth & Permissions


cp env.example .env

Adding providers

The app itself handles no links, you need to add some providers:


If the unfurl is not happening check that the domain is not blacklisted.

If you modify app domains, you need to Install App (/install-on-team as url) again to re-authorize.


Install composer deps and start builtin HTTP server:

composer install
composer run server

To build docker image locally and run it:

docker build -t slack-unfurl .
docker run --rm -p 4390:4390 -v $(pwd)/var/log:/app/var/log -v $(pwd)/.env:/app/.env slack-unfurl

The service is accessible from or just http://localhost:4390/