hubot-kato

Kato adapter for Hubot

Showing:

Popularity

Downloads/wk

12

GitHub Stars

11

Maintenance

Last Commit

7yrs ago

Contributors

4

Package

Dependencies

3

License

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Kato Hubot Adapter

Description

The Kato Hubot adapter allows you to use Hubot in your Kato team.

Installation

Install Hubot (consult the Hubot documentation for more information):

$ sudo npm install -g yo generator-hubot

Create a new bot:

$ mkdir myhubot
$ cd myhubot
$ yo hubot

You will be asked which adapter to use, type kato.

image

Configuration

First, create a new Kato account for your bot. It’s best to create a new email address, eg. kato-bot@mycompany.com and invite this address to your Kato team. Verify the email and set a name for your bot in its new account (that name shows up when it posts a message).

Next, you will need to set some environment variables:

$ export HUBOT_KATO_LOGIN="katobot@mycompany.com"
$ export HUBOT_KATO_PASSWORD="5prz8OKty6"

Usage

Once that’s done, you can start Hubot with Kato as the adapter:

$ ./bin/hubot -a kato

Please ignore npm WARN and deprecated messages, they are generated by packages unrelated to the Kato adapter. You shoud be able to see your bot online in Kato just a few seconds after you ran this command.

Notes

The Kato addapter supports listening for commands in

  • all unrestricted rooms
  • restricted rooms, to which it has been explicitly added
  • 1 on 1 chats with the bot itself

You can address your bot by beginning a message with its name, which defaults to Hubot. You can change this and also set an alias using the following additional environment vars:

$ export HUBOT_NAME="Frank"
$ export HUBOT_ALIAS="!"

Your bot should now reply to !ping with PONG.

The bot will not respond to itself.

Optional Logging

Log filename (the default is kato-hubot.log):

$ export HUBOT_KATO_LOG_FILE="path/filename.log"

Log level (one of error, debug, or info. Default is error):

$ export HUBOT_KATO_LOG_LEVEL="debug"

Copyright © LeChat, Inc. See LICENSE for details.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100