Skip to content
/ heybot Public

🤖 A sleek command based Skype chat bot for your team

Notifications You must be signed in to change notification settings

wingify/heybot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Heybot! Logo

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 to creds.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 that creds.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 be ssl.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 running npm 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 !)

Chat screen

Third party commands

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.

References

Maintainers

About

🤖 A sleek command based Skype chat bot for your team

Resources

Stars

Watchers

Forks

Packages

No packages published