In order to talk to your chatbot there must be a bot user pre-configured on the Rocket.Chat server.
An admin user is required to create a special user account which the bot will use to login and listen for messages or send messages.
You must login to your Rocket.Chat server as an Admin user and then create a new user:
From Administration > Users menu
+ to make a new user
Enter Name, Username, Email (tick verified) and Password
Disable Require password change
bot from role selection and click Add Role
Disable Join default channels recommended, to avoid accidental listening
Disable Send welcome email
Your bot will be configured to login to Rocket.Chat server with the designated bot username and password by using these credentials in the bot's environment
Note that for bots email, a common workaround to avoid creating multiple accounts is to use Gmail +addresses, e.g.
firstname.lastname@example.org. See this issue for more
Your bot will usually respond to all messages addressed directly to the bot user (depending on the particular bot framework). i.e. Messages prepended with
BOT_NAME or a preconfigured
If the bot is configured to listen on Direct Messages (
RESPOND_TO_DM=true), the prepend is not necessary (it's automatically added internally) so the bot should respond to all messages in the DM channel.