Hubot adapter for Gitter
CoffeeScript
Clone or download
Latest commit 946967c Mar 13, 2018
Permalink
Failed to load latest commit information.
doc Updating documentation Aug 20, 2014
src Fix get users. Jan 3, 2017
.gitignore Adding the test to the ignored files Aug 14, 2014
LICENSE Initial commit Aug 10, 2014
README.md readme: remove changelog Mar 6, 2018
package.json Version 1.0.0 Mar 13, 2018

README.md

hubot-gitter2

Improved Hubot adapter for Gitter


There was already one adapter hubot-gitter but after trying to fix many missing things from it, I decided to write one from scratch.

Gitter chat

At the time this is written, here is the advantages of this one:

  • namespaced environment variables for the configuration
  • handling robot.send room: 'room id or uri', 'my message'
  • gathering information from users in all rooms correctly
  • not handling messages that the bot itself is sending

Installation

  • install Hubot and CoffeeScript: npm install -g hubot coffee-script
  • create your bot and install its dependencies:
npm install -g yo generator-hubot
mkdir -p my-bot
yo hubot
  • save hubot-gitter2 as dependency: npm install --save hubot-gitter2
  • start the bot using the right adapter: HUBOT_GITTER2_TOKEN=<your token> ./bin/hubot -a gitter2 --name <your bot name>
    • HUBOT_GITTER2_TOKEN: get your personal token there after sign-in
    • the bot will automatically listen on the rooms it has joined.

Troubleshooting

  • If your bot is not responding to mentions, make sure hubot was started with the same --name parameter as its GitHub username.