A Keybase chat bot that gives you a link to join a Zoom instant meeting.
Running
In order to run the Zoom bot, there needs to be a running MySQL database in order to store OAuth data.
On that SQL instance, create a database for the bot, and run db.sql to set
up the tables.
Build the bot using Go 1.13+, like such (in this directory):
go install .
Create an OAuth App on the Zoom Marketplace. Fill in all of
the necessary details (name, description, etc.). Additionally, set the redirect URL and whitelist as
https://mydomain.com/zoombot/oauth, add user:read and meeting:write to the Scopes and set the deauthorization
notification endpoint URL as https://mydomain.com/zoombot/deauthorize.
The bot sets itself up to serve HTTP requests on /zoombot. The HTTP server
runs on port 8080. You can configure nginx or any other reverse proxy
software to route to this port and path.
If you accidentally run the bot under your own username and wish to clear the
! commands, run the following:
keybase chat clear-commands
Restricted bots are restricted from knowing channel names. If you would like
a bot to announce or report errors to a specific channel you can use a
ConversationID which can be found by running:
keybase chat conv-info teamname --channel channel
By default, bots are unable to read their own messages. For development, it may be useful to disable this safeguard.
You can do this using --read-self flag when running the bot.
You can optionally save your Zoom credentials inside your bot account's private KBFS folder.
To do this, create a credentials.json and use the --kbfs-root flag to specify the folder that it's in
(example: --kbfs-root /keybase/private/<YourZoomBot>). The credentials.json file should follow this format:
There are a few complications running a Keybase chat bot, and it is likely
easiest to deploy using Docker. See https://hub.docker.com/r/keybaseio/client
for our preferred client image to get started.