Useful (?) slash commands and miscellaneous integrations for Slack.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
SlackCommander
.gitattributes
.gitignore
LICENSE
README.md
todo-private.png
todo-public.png
whois-result.png

README.md

SlackCommander

Useful (?) slash commands and miscellaneous integrations for Slack.

Built with Nancy and can easily be hosted as a free Azure Website.

Build status

Installation

Setup instructions for the /todo feature can be found here.

Todo list

A simple todo list per conversation (channel/direct message/private group). Use the /todo command together with one of the supported operators to manage the list. Operators are:

  • [empty] Displays the list to you.
  • show Displays the list to everyone in the conversation.
  • add [text] Adds an item to the list. The item gets a numeric ID automatically.
  • tick [id] Marks an item as "done".
  • untick [id] Marks an item as "not done".
  • remove [id] Removes an item from the list.
  • trim Removes all ticked (done) items.
  • clear Removes all items.
  • help Display usage information.

Example:

/todo add Update SlackCommander readme
/todo add Get coffee
/todo add Get to inbox zero
/todo

SlackCommander /todo response

/todo tick 1
/todo tick 3
/todo show

SlackCommander /todo show response

As stated above, each conversation gets its own list and everyone in the conversation is free to manage it. Use the Slackbot channel if you want a personal list, or create a private group with no other members (good for todo-per-topic).

Whois lookup for e-mail addresses or Twitter handles

/whois [e-mail address]
/whois [Twitter handle]

Performs a lookup and sends a brief summary of who the person behind the e-mail address or Twitter handle is to the current channel. Requires a FullContact API key (the free tier currently includes 250 lookups per month).

Example:

/whois @SlackHQ

SlackCommander responds to the current channel with something similar to this:

SlackCommander /whois example response

Misc. integrations

  • MailChimp webhook for new subscribers - automatically posts a notification to a preconfigured Slack channel about the new list signup + initiates a whois lookup (which is also posted to the channel when complete).

  • Send e-mail to Slack - set up a Mailgun route to forward incoming e-mail to any Slack channel.

Mailgun route details
=====================

Filter expression: match_recipient("^(?P<slackChannel>[\w]+)\.(?P<webhookId>[\w]+)@yourdomain.net$")

Action: forward("https://yourslackcommander.com/webhooks/mailgun/\g<webhookId>/\g<slackChannel>")

(webhookId should be a hard-to-guess token to prevent spam etc.)