Heybot!
A sleek command based Skype chat bot for your team
About
Heybot! is a bot that came up from our own requirement at Wingify to enable everyone to run automated tasks easily from Skype chats. It gives you a simple framework to write commands that your team can run, with provision of restricted access to some commands by power users only.
Its written over Microsoft's bot framework, designed to be extensible for any sort of task in small and large teams. Bot framework based bots work out of the box with Skype, but the same bots can act as a base for a Messenger, slack etc bot too. As of now, Heybot! has been tested on Skype only and the instructions here are for Skype.
Setup
- Clone this repository.
- Run
npm install
to install all node dependencies. - Copy
creds.template.js
tocreds.js
and replace the parameters with appropriate values. Read more. You can also have the same parameters as environment variables instead of putting them in creds.js. Note thatcreds.js
must still exist. - Add valid SSL certificate files in the repository. Those files are read by
app.js
. The names of the files should bessl.key
&ssl.crt
. This is required because the server must be running on valid secure endpoint. - Run
npm start
to run the bot server. Similarly you can stop by runningnpm stop
. - Congratulations! You should now have Heybot! running successfully! You can now add your bot to Skype from your bot page.
Important: As the bot you'll register with Microsoft would be for your team and won't be of much use to general users, you'll need to keep it in preview mode instead of publishing it to the marketplace. Though, note that in preview mode the maximum number of chats the bot can be added to is limited (100 currently). You can make the best use of this limit by adding the bot only to group chats instead of everyone adding it on personal chats. Hopefully, Microsoft will enable us to have private bots in future.
Using Heybot!
Running any command on Heybot! is as simple as saying the command name prefixed with !
.
Eg. to run the ping
command, you need to type: !ping
(or @yourbotname !ping
if on a group chat).
To see list of all available commands, say help
(without the !)
Third party commands
- Command_Name - A one line intro about the command.
If you have written a useful or fun command for Heybot!, open up a pull request adding your command to the above list with a link to your github repository.
Read about writing your own commands.
Development
Read docs for how Heybot! works internally.