jdrew1303 / hubot-skype-web

A Skype adapter for Hubot that connects via Skype web.

hubot-skype-web

A Skype adapter for Hubot that connects via Skype web.

This adapter allows integrating your Hubot with Skype.

Available functionality:

• Sending / Receiving messages in personal chats with contacts
• Sending / Receiving messages in group chats with anyone in the group (non-contacts included)

What's missing:

• Sending / Accepting / Rejecting contact requests
• Sending / Receiving of files
• Recognizing contact presense (appearing online ; going offline..etc)

Also note that this adapter can not connect to the old P2P group chats. That's a general limitation of Skype's web offerings as the old P2P groups don't go through Skype's servers. Read more about cloud-based and P2P-based Skype groups here

Getting started

1. Install PhantomJS. This adapter depends on phantom which expects you to manually install the PhantomJS binary and expose it in PATH
2. Export necessary environment variables.
3. Add hubot-skype-web as dependency in your package.json: npm install hubot-skype-web --save
4. Start your hubot with the Skype Web adapter: hubot --adapter skype-web

Configuration

This adapter can only be configured via Environment variables.

Mandatory Environment variables:

• HUBOT_SKYPE_USERNAME String - hubot's skype account username
• HUBOT_SKYPE_PASSWORD String - hubot's skype account password in plain text

Optional Environment variables:

• HUBOT_SKYPE_RECONNECT Integer, default: 240 - The duration between reconnects in minutes. Minimum value is 20. Reconnect does not disturb hubot's uptime.
• HUBOT_LOG_LEVEL String [debug|info|notice|warning|error|critical|alert|emergency], default: info - Set the log level of Hubot. The SkypeWeb adapter can output extensive debug messages.
• HUBOT_SKYPE_MAX_MESSAGE_LENGTH Integer, default 1500 - The maximum length of the message, longer messages are splitted

Contributing

Patches are welcome. Browse the documentation to get started.

Troubleshooting

Please fill in issues to this Github project istead of emailing me directly. Keeping the communication here saves me from answering multiple emails for the same things.

You may have troubles running this under Linux with PhantomJS 1.9. You should try using 2.0. At the time of writting this there is still no official build. You can find my build here.

License

The MIT License (MIT). Please see LICENSE file for more information.