Coding level: Intermediate
Duration: 25 minutes
Project type: Chat app
About this solution
Schedule a meeting in Google Calendar from within a direct message (DM) or a space in Google Chat. You can set specific details for the meeting, such as subject, start time, or duration, or use the default settings for instant meeting scheduling.
How it works
The Chat app script uses slash commands and dialogs to get meeting details from users and schedule a Calendar event. The script includes default meeting settings that can be customized to fit your needs.
Apps Script services
This solution uses the following services:
- Calendar Service: Creates the calendar event from the provided meeting info.
- Base Service: Uses the
Session
class to get the script's time zone. Calendar uses this time zone when scheduling the event. - Utilities Service: Formats the date for the calendar event and encodes the event ID to help get the event URL.
Before you begin
To use this sample, you need the following prerequisites:
- A Google Account (Google Workspace accounts might require administrator approval)
- A web browser with access to the internet
- A Google Cloud project with the Chat API enabled
- To create a project and enable the Chat API, refer to Create a project and Enable Google Workspace APIs.
- A Google Cloud project with the OAuth consent screen configured
- To configure the OAuth consent screen, refer to Configure the OAuth consent screen.
Try it
Step 1: Set up the Apps Script project
- Click the button below to open the Schedule meetings from Google Chat
Apps Script project.
Open the project - At the left, click Overview .
- At the top-right, click Make a copy
.
- In the copied project, at the left, click Project Settings
.
- Under Google Cloud Platform (GCP) Project, click Change project.
- Enter your Google Cloud project number and click Set project.
- At the top-right, click Deploy > New deployment.
- Enter a description for the deployment, such as
version 1
, and click Deploy. - Copy the deployment ID for use in a later step.
Step 2: Configure the Chat API
- In the Google Cloud Console, go to the Chat API page.
Go to Chat API - Click Configuration.
- Configure the Chat API with the following information:
- Name:
Meeting Scheduler
- Avatar URL: Add a URL that points to an image with a minimum size of 256x256 pixels.
- Description:
Quickly create meetings.
- Functionality: Check both boxes to let users message the app directly and add it to spaces.
- Connection settings: Click Apps Script and enter the deployment ID.
- Slash commands: Add slash commands for
/help
and/schedule_Meeting
by taking the following steps:- Click Add slash command and configure it with the following information:
- Name:
/help
- Command ID:
1
- Description:
Learn what this app does.
- Name:
- Click Add slash command again and configure it with the following information:
- Name:
/schedule_Meeting
- Command ID:
2
- Description:
Schedule a meeting.
- Check the Opens a dialog box.
- Name:
- Click Add slash command and configure it with the following information:
- Name:
- Click Save.
- At the top of the page, under App status, update the status to Live - available to users.
- Click Save.
Step 3: Create a meeting
- Open Google Chat.
- Click Start a chat .
- Search for the app's name,
Meeting Scheduler
. - Send an initial message, such as
hello
, to prompt authorization. - When the app replies, click Configure and authorize the app.
- Send
/schedule_Meeting
to the app. - In the dialog, add at least one invitee email address. You can update the other fields or use the default entries.
- Click Submit.
- To view the meeting, click Open Calendar event.
Contributors
This sample is maintained by Google with the help of Google Developer Experts.