A library for creating a full Slack client
Last updated 4 years ago by grand_pubba .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @grand_pubba/slack-client 
SYNC missed versions from official npm registry.

Node.js Slack Client Library

Travis-CI Build Status

Build Status


This is a Slack client library for Node.js. It's intended to expose all of the functionality of Slack's Real Time Messaging API while providing some common abstractions and generally making your life easier, if you want it to.

This code has been built to support our hubot-slack adapter. Most other functionality isn't yet supported, and documentation is minimal, at best.


npm install slack-client --save


Slack = require 'slack-client'

slackToken = 'xoxb-YOUR-TOKEN-HERE' # Add a bot at https://my.slack.com/services/new/bot and copy the token here.
autoReconnect = true # Automatically reconnect after an error response from Slack.
autoMark = true # Automatically mark each message as read after it is processed.

slack = new Slack(slackToken, autoReconnect, autoMark)

slack.on 'open', ->
    console.log "Connected to #{slack.team.name} as @#{slack.self.name}"

slack.on 'message', (message) ->
    console.log message

slack.on 'error', (err) ->
    console.error "Error", err


A full example of how to use this module from Node.js can be found in the /examples directory.


Here's the most direct way to get your work merged into the project.

  1. Fork the project
  2. Clone down your fork
  3. Create a feature branch
  4. Hack away and add tests, not necessarily in that order
  5. Make sure everything still passes by running tests
  6. If necessary, rebase your commits into logical chunks without errors
  7. Add yourself to package.json as a contributor
  8. Push the branch up to your fork
  9. Send a pull request for your branch


Copyright © Slack Technologies, Inc. MIT License; see LICENSE for further details.


  1. Better/any timeouts on initial websocket connection
  2. Better/any timeouts on API calls
  3. Document the connection options, etc
  4. Emit more events around unreads and mentions

Current Tags

  • 1.5.0-2                                ...           latest (4 years ago)

2 Versions

  • 1.5.0-2                                ...           4 years ago
  • 1.5.0-1                                ...           4 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 2
Dependencies (4)
Dev Dependencies (9)
Dependents (1)

Copyright 2014 - 2016 © taobao.org |