Slack-chat-with-SMS

You love Slack? Now anyone can send you text messages / SMS. The conversation starts in its own Slack channel, and you can reply /sms anything you like.

Preview

Setup and configuration

git clone git@github.com:arthur-flam/slack-chat-with-sms.git
cp config.js.sample config.js
npm install

Before you type npm start, you will need to setup the [Slack] integration and SMS integration... Sorry it is a bit long, but consider how amazing it is to chat with anyone via SMS through Slack.

First of all type your hostname/ip/protocole in the new config.js file.

Setting up Nexmo (inexpensive and friendly SMS provider)

  1. Get a Nexmo account
  2. Get a sms-enabled phone number and type it in the config.js file.
  3. Copy-paste the APP_ID or KEY and APP_SECRET available on the API settings on the config file.
  4. Configure the SMS settings for you number. The Callback URL should be http://YOUR_HOSTNAME/v1/sms/in

Slack integration

  1. Type your team name (like NAME.slack.com) in the config file.
  2. Setup a slash command as a custom integration. This will let you reply with /sms :
    • As URL use http://YOUR_HOSTNAME/v1/hook
    • As command name use /sms or reply. /s is already the search command!
    • Check method is POST
    • You can copy-paste the command token in the config.js file
    • Use any custom, name, icon, label, description...
  3. Create an API token. This will enable our app to act on your behalf and create / post on channels.
    • Set it for you team
    • It should look like this xoxp-ffff-ffffff-ffffff-fffffff

Starting the app

npm start

You should be live.

Contributors & Contributing

I will be more than happy to receive pull requests and hear about bugs/issues :)