Readme updated, return code check added for api call

In this pull request:

* there is some updated the documentation (describing how to get the slack token and add the environment variable to wercker)
* Code added that checks the return value from slack.
* some tests. You need to have an environment variable set to run it. So I've disabled them in the wercker.yml (to keep the build/pull request green).