mlh-fellowship / zoomcord

A bot to schedule Zoom meetings through Discord written in Julia.

Idea

Streamline your entire workflow through Discord. Easily start a meeting and share the link with every using the "/zoom" slash command. Schedule meetings and view your upcoming meetings directly in the Discord channel. Additionally get a meeting summary and know exactly when someone joined or left the meeting.

• Start or join Zoom Meetings with one command.
• See real-time how long the Zoom Meeting has been running and its current status right in Discord.
• Keep an eye on who joins or leaves your Zoom Meeting.
• See the meeting and participant summary for your Zoom Meeting after it ends.

Getting started

Prerequisites

• Julia
• Git

Clone

• Clone this repo to your local machine.

$> git clone https://github.com/MLH-Fellowship/ZoomCord.git

Setup Genie server

• Setup Julia environment. This will install all required dependencies and exit.

$> julia
julia> ]activate .
julia> exit()

• Generate a secrets file for signing and encrypting sensitive Genie data.

julia> Genie.REPL.write_secrets_file()

• Start Genie server

$> bin/server

• Visit HOST:PORT/start/ URL on your browser to start Discord bot.

Access the app on http://localhost:8000

OAuth Workflow

The first time you use the Zoom slash command in Discord, you will be asked to login to Zoom (if you are not already logged in) and approve the app's access to Zoom.

Zoom uses OAuth to allow an application to access user-authenticated data for use with third party applications which ZoomCord uses to create meetings and provide other features. The process is somewhat complex and is detailed in the image below:

Note: The application is using JWT workflow until it is approved manually by Zoom.

Technology Stack

• Zoom API : API used to communicate with Zoom.
• Discord.jl : Package to interact with Discord's API.
• Julia : High level programming language for numerical analysis and computational sciences.
• Genie.jl: The highly productive Julia web framework.

Contributors:

• Diaga
• makrandr1999
• abhishalya

License

The project is MIT licensed.

zoomcord's Issues

Register a domain to get HTTPS certificates

• Using Freenom to obtain a free domain because HTTPS can only be served over domains.

Redirect webpage

• A webpage(HTML/CSS) that confirms that the user has successfully authorised the application.

This will be served when zoom redirects the user to our callback URI.

implement bot commands

• Check if the bot has been tagged.

• Create a dictionary (key : value) of commands with their usage.

• Try out embedded cards.

Setup initial deployment

We will be using Digital Ocean to manage deployment.

• Get droplet
• Point A records of domain to droplet
• Install docker on server
• Setup caddy to serve genie over domain

Available at https://www.zoomcord.ml

Setup database and authorisation

Setting up database for storing access tokens after zoom authorisation.

Setup caddy and docker-compose

Zoom API requires endpoints to be secured over HTTPS.

Using Caddy, an open source web server for reverse proxy.

Create a test discord bot

• Checkout Discord.jl and Discord docs.

• Create a test server.

• Invite everyone and set up the bot on the test server.

Register an OAuth application at Zoom marketplace

To use Zoom API, we first need to register an OAuth application. For further documentation:

https://marketplace.zoom.us/docs/api-reference/using-zoom-apis

Create a Genie.jl app

We will need a backend to persist user authorisation information along with providing endpoints to receive events from Zoom API.

Genie.jl