Rocket.Chat¶
A connector for Rocket.Chat.
Requirements¶
An account from Rocket.Chat chat service or from your own server
The Personal Access Token details(user-id and token) generated from within your account settings
Configuration¶
connectors:
rocketchat:
# required
user-id: "1ioKHDIOD"
token: "zyxw-abdcefghi-12345"
# optional
bot-name: "mybot" # default "opsdroid"
default-room: "random" # default "general"
group: "MyAwesomeGroup" # default to None
channel-url: "http://127.0.0.1" # defaults to https://open.rocket.chat
update-interval: 5 # defaults to 1
Notes:
Opsdroid will only listen to one channel/group at a time.
A group is a private channel - this takes priority over a channel when trying to connect to the service.
The name of the channel room is meant to be added without the #.
Opsdroid will keep pinging the chat service to see if new messages were received; you can increase/decrease the time between pings by adding the param
update-interval
. Note: Opsdroid will only read the last received message.
Usage¶
FabioRosado Owner 6:11 PM
hi
opsdroid @FabioRosado Owner 6:11 PM
Hi FabioRosado
In this example, I was using my own account to interact with opsdroid through Rocket.Chat, so you can see that even though opsdroid replied to “hi”, the actual username shown was mine - this happens because I used my personal access token to test the connection.
This will also give you the possibility to just use a single account and interact with opsdroid through the chat service
since the name will always be changed to whatever bot-name
is set in config.yaml
.