Using Bots

{:style="width='100%' height='auto'"}

Rocket.Chat supports chatbot and messaging automation integrations, enabling chat-ops workflows with multi-channel, multi-user, public and private interactions.

We are building out support for multiple frameworks, including:

• bBot - complete
• Hubot - complete
• Botkit - in development
• Rasa - in development
• Botpress - development

Some Rocket.Chat server packages implement internal bots (e.g. SlackBridge). That type of integration is not documented here. See the Bots FAQ for more on that distinction.

To contribute to features under development see our Bots Project issues.

Getting Started

These are the basic steps for using bots with Rocket.Chat.

1. A bot user must be created by an admin on the server
2. The bot is run as a separate process using your chosen framework or platform
3. The bot environment must be pre-configured by setting environment variables
4. You provide scripts to define the bot's behaviour according to the requirements of your framework
   • e.g. See Running a bBot bot

Quick Links

• Bots FAQ
• Bots Architecture
• Creating Bot Users
• Configuring the Bot Environment
• Running a bBot Bot
• Running a Hubot Bot
• Running a Botkit Bot
• Running a Rasa Bot
• Running a Botpress Bot

References

Configuration and implementation details for components of the Bots Architecture can be found in their project READMEs:

• Rocket.Chat JS SDK
• bBot Rocket.Chat boilerplate
• Hubot Rocket.Chat boilerplate
• Hubot Rocket.Chat adapter