Skip to content
XMPP adapter for Hubot
Branch: master
Clone or download
markstory Merge pull request #121 from gbonnefille/patch-1
Remove obsolete nodejs versions
Latest commit 486265e Sep 3, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Fix typo Nov 3, 2017
test Update Apr 19, 2016
.gitignore add idea to gitignore Jun 17, 2015
.npmignore update node-xmpp-client to 3.0.0 Dec 24, 2015
.travis.yml Remove obsolete nodejs versions Aug 14, 2018


Hubot XMPP

Connects Hubot to your XMPP network

Build Status


Install dependencies with npm

npm install


There are a few configuration values you can use when getting hubot-xmpp running. The XMPP adapter requires only 3 (5 if you need specify server and port) environment variables to be set to able to use it.



  • HUBOT_XMPP_HOST The host name you want to connect to if its different than what is in the username jid.
  • HUBOT_XMPP_PORT The port to connect to on the jabber server.
  • HUBOT_XMPP_LEGACYSSL Set to 1 to enable legacy SSL port. This requires the host to be defined.
  • HUBOT_XMPP_PREFERRED_SASL_MECHANISM Used to change the encoding used for SASL.
  • HUBOT_XMPP_DISALLOW_TLS Prevent upgrading the connection to a secure one via TLS.
  • HUBOT_XMPP_PM_ADD_PREFIX Make commands work in PMs to hubot without robot name/alias.
  • HUBOT_XMPP_KEEPALIVE_INTERVAL Keep-alive interval in ms.
  • HUBOT_XMPP_RECONNECT_TRY the number of reconnect retry in case of disconnection, default is 5.
  • HUBOT_XMPP_RECONNECT_WAIT the time in ms to wait before reconnecting, default is 5000.

HUBOT_XMPP_ROOMS can be a comma separated list of rooms to join. If your rooms require passwords you should use the jid:password syntax. Room passwords cannot contain ,. Room names must be the full jid of the room for example

HUBOT_XMPP_PM_ADD_PREFIX works by prefixing the private message with hubot name, so a side effect is that the bot ignores commands of type /^command/i.


After installing hubot with npm, you should create a standalone bot:

hubot -c ./my-bot

After creating your new bot, you should modify the package.json and add the hubot-xmpp dependency. After running npm install you should be ready to configure and start up your bot.

Group chat vs private JID

The jabber protocol does not broadcast real user JID in groupchat presence stanzas unless the server/chat room is configured to do so.

If you need to send private chat in response to a groupchat message, use hubot's send method with the groupchat jid and envelope.user.type = 'direct'. hubot-xmpp will then automatically resolve the JID to a private chat JID, and private message the sender.

If you need to get the private chat JID, you can use 'msg.envelope.user.privateChatJid' where msg is the parameter of hubot's "route" callback.


robot.respond /talk to me$/i, ( msg ) ->
  # Simply reply
  msg.reply "Hello #{}. Your private JID is #{msg.envelope.user.privateChatJID}"

robot.respond /talk to me in private$/i, ( msg ) ->
  msg.envelope.user.type = 'direct'
  msg.send "Hey #{}! You told me in room #{} to talk to you."
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.