XMPP adapter for Hubot.
Connects Hubot to your XMPP network
Install dependencies with
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_HOSTThe host name you want to connect to if its different than what is in the username jid.
HUBOT_XMPP_PORTThe port to connect to on the jabber server.
HUBOT_XMPP_LEGACYSSLSet to 1 to enable legacy SSL port. This requires the host to be defined.
HUBOT_XMPP_PREFERRED_SASL_MECHANISMUsed to change the encoding used for SASL.
HUBOT_XMPP_DISALLOW_TLSPrevent upgrading the connection to a secure one via TLS.
HUBOT_XMPP_PM_ADD_PREFIXMake commands work in PMs to hubot without robot name/alias.
HUBOT_XMPP_KEEPALIVE_INTERVALKeep-alive interval in ms.
HUBOT_XMPP_RECONNECT_TRYthe number of reconnect retry in case of disconnection, default is 5.
HUBOT_XMPP_RECONNECT_WAITthe 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
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
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.
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.
robotrespond /talk to me$/i# Simply replymsgreply "Hello . Your private JID is "robotrespond /talk to me in private$/imsg.envelope.user.type = 'direct'msgsend "Hey ! You told me in room to talk to you."