https://github.com/kuy/gmeet-slash-cmd

Slack integration for Google Meet
https://github.com/kuy/gmeet-slash-cmd

google-meet productivity serverless slack typescript

Last synced: 3 days ago
JSON representation

Slack integration for Google Meet

• Host: GitHub
• URL: https://github.com/kuy/gmeet-slash-cmd
• Owner: kuy
• Created: 2020-05-05T06:50:49.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-01-07T17:50:40.000Z (almost 2 years ago)
• Last Synced: 2024-07-30T18:54:47.234Z (4 months ago)
• Topics: google-meet, productivity, serverless, slack, typescript
• Language: TypeScript
• Homepage:
• Size: 719 KB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 20
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
## Slack integration for [Google Meet](https://meet.google.com/)

Provides a slash command `/meet` to get & share meeting URL of [Google Meet](https://meet.google.com/) quickly on Slack.

## Install

*This integration is not listed on [Slack App Directory](https://slack.com/apps) yet.*

Please wait for verification or setup it as your own custom app.

## Setup (for developers)

**Work in Progress**

### Requirements

- Domain name, which managed by you

- [Node.js](https://nodejs.org) 14.x

- [Serverless Framework CLI](https://www.serverless.com/framework/docs/getting-started/)

- [Amazon Web Service](https://aws.amazon.com/console) account (key and secret)

  - Uses Lambda, API Gateway, and Route 53

- [Google API project](https://console.developers.google.com/apis/dashboard)

### Overview

1. Choose domain name

2. Setup Google API project

3. Create Slack app

4. Deploy to AWS

5. Install app to organization

#### Domain name

Choose domain name which is used for accepting request from Slack and callback from Google OAuth. In this tutorial, use `https://gmeet.example.com` for example.

#### Google API project

Create a new project from [Google API Console](https://console.developers.google.com/apis/dashboard) and enable Calendar API.

To get OAuth credentials, `Credentials > Create Credentials > OAuth client ID`.

Application type is **Web Application**, Authorized redirect URL is `https://gmeet.example.com/callback`. Note down **Client ID** and **Client Secret** for later steps.

Don't forget to setup [OAuth consent screen](https://console.developers.google.com/apis/credentials/consent) and add `example.com` to [Authorized domains](https://support.google.com/cloud/answer/6158849?hl=en#authorized-domains).

#### Slack app

[Create a Slack app](https://api.slack.com/apps) with a slash command `/meet`. The request URL is `https://gmeet.example.com/create`.

#### Deploy to AWS

Before deploying to AWS, create `config.json` on the root directory (copy and rename `config.json.example`).

`clientId` and `clientSecret` are credentials of Google API project you created.

`redirectUrl` is url of OAuth callback, e.g. `https://gmeet.example.com/callback`.

`profile` is profile name of your local configuration for AWS CLI.

Let's deploy. `sls deploy`

You may need to associate your domain `https://gmeet.example.com` and an endpoint of API Gateway.

#### Install app

A slash command `/meet` will be enabled by installing app. Browse [your apps](https://api.slack.com/apps) and install it to your organization.

## License

MIT

## Author

Yuki Kodama / [@kuy](https://twitter.com/kuy)