Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sdelements/hubot-lets-chat
Hubot Adapter for Let's Chat
https://github.com/sdelements/hubot-lets-chat
Last synced: about 22 hours ago
JSON representation
Hubot Adapter for Let's Chat
- Host: GitHub
- URL: https://github.com/sdelements/hubot-lets-chat
- Owner: sdelements
- Archived: true
- Created: 2013-04-29T04:54:04.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-12-05T02:35:33.000Z (almost 9 years ago)
- Last Synced: 2024-10-08T14:06:15.460Z (about 1 month ago)
- Language: CoffeeScript
- Size: 16.6 KB
- Stars: 58
- Watchers: 14
- Forks: 10
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Let's Chat Hubot Adapter
This is a WIP and will probably be unreliable for a while, so use at your own risk!
## Overview
You already have a Let's Chat server running, now you want to add hubot.
We're going to install a new stock hubot, and install this hubot "adapter" so it can talk to Let's Chat.
## 1. Install a hubot
Create a new hubot. There are several ways to do this but the simplest might be using this `hubot` command:
```
hubot --create myhubot
```
You might also like to use the [yeoman hubot installer](https://github.com/github/generator-hubot). Check out the [hubot docs](https://hubot.github.com/docs/) for help getting a hubot running.
### 2. Install the Adapter
Once your hubot is working, change directory into your new bot code:
`cd myhubot`
Then install the adapter with npm:
`npm install hubot-lets-chat --save`
### 3. Optional environment variables
Set the following environment variables:
- `HUBOT_LCB_ROOMS` You can see these IDs in the URL for the room. NOTE: this is a _comma-separated list_.
- `HUBOT_LCB_TOKEN` can be found in the Let's Chat interface. Click on your username and look under "Auth Tokens."
Set these two environment variables with `export`:
```
export HUBOT_LCB_TOKEN=NTRiNjg5NmYyMDZiMzEwMDAwYTAxNmZiOjE0ZTg2ODMwYz...
export HUBOT_LCB_ROOMS=5279facb1015642226000011,5394ffbabdea44e815000003
```
Additionally, three more environment variables are *optional* and have default values:
```
export HUBOT_LCB_PROTOCOL=http
export HUBOT_LCB_HOSTNAME=localhost
export HUBOT_LCB_PORT=5000
```
## 4. Create a new user in Let's Chat
In the Let's Chat web interface, create a user with the same @name as your bot, like `@myhubot`.
You can customize it when you boot the hutbot, like `./bin/hubot --adapter lets-chat --name myfancyname`.
Tip for Gmail users: Let's Chat 0.3 uses [gravatar]("http://gravatar.com") for avatars. So if you want to customize the bot avatar, you could use a Gmail alias like [email protected], then customize that avatar in Gravatar.
### 5. Let's go! Start the server.
To get the hubot running, start the server with the `lets-chat` adapter.
```
bin/hubot -a lets-chat
```
If everything goes well, your bot will join you in your Let's Chat instance.
Enjoy skynet, I hope you're happy with yourself.