# Google Calendar

## What is Google Calendar?

Google Calendar is a widely used cloud-based scheduling tool from Google that helps individuals and organizations plan, manage, and track events. It offers features such as multi-calendar support, automated reminders, real-time synchronization across devices, and integrations with productivity tools, making it a cornerstone for efficient time and resource management.

{% embed url="<https://youtu.be/GirQAFZdd7U>" %}

***

## Benefits of Integrating Google Calendar with AI Agent

* **Automated Scheduling**: Eliminate the need for manual appointment booking as the AI Agent can directly create and confirm calendar events.
* **Real-time Synchronization**: Events and updates made through BotPenguin instantly reflect in Google Calendar, ensuring accuracy.
* **Reduced No-Shows**: Automated reminders sent via the AI Agent minimize missed appointments.
* **Streamlined Customer Experience**: Customers can schedule meetings, demos, or consultations directly during the chat without extra steps.
* **Multi-User Flexibility**: Supports multiple team members’ calendars, enabling intelligent routing and booking across availability slots.

***

## Steps to Integrate Google Calendar with AI Agent:

### Step 1: Access Integrations

1. Log in to [BotPenguin](https://app.gitbook.com/u/jErGksPiNCXXJ01rLQHkXvpwTFw1), and click on the **More** icon in the left-hand sidebar.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FNqFqbo6MiBAiPLzPqDQa%2Fimage.png?alt=media&#x26;token=332135f7-71b2-4279-aa3c-e5be12f8cf79" alt=""><figcaption></figcaption></figure>

2. Navigate to **Integrations → Google Calendar**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F0Wa5mrOVLkFanRtWhaso%2Fimage.png?alt=media&#x26;token=65aa52b0-40d9-468d-b5d1-d9ec5801b821" alt=""><figcaption></figcaption></figure>

3. On the Google Calendar page, click **Connect → Connect Google Calendar**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FMB7WDpSXiXysJEDri5uC%2Fimage.png?alt=media&#x26;token=b2adb57d-6388-45a9-bf3d-b03bd3ac750a" alt=""><figcaption></figcaption></figure>

4. Complete the **Google Sign-In process** and allow permissions.

***

### Step 2: Configure Google Calendar Accounts

1. After connection, you will see a configuration table with:
   1. **Configuration Name** (email ID).
   2. **Details** (connected account information + access token).
   3. **Status Toggle** (enable/disable connection).
   4. **Actions** (delete an integrated account).

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fc404PR1QHrKr2xuCpzQD%2Fimage.png?alt=media&#x26;token=f04e4726-2085-4e94-a04a-53811fc05f60" alt=""><figcaption></figcaption></figure>

2. To add another account, click **Add New Configuration** and repeat the sign-in.

***

### Step 3: Prepare Custom Attributes (Mandatory)

1. Go to the left-hand sidebar and click on More.
2. Scroll down and select Settings.
3. Click on Custom Attributes and then click Add Attribute.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FRhBxU9adomoph7beLvXb%2Fimage.png?alt=media&#x26;token=a37759c8-f289-484d-ac14-79a6af6fb339" alt=""><figcaption></figcaption></figure>

4. A table will appear with three options. Select the third option: **Save Agent Response**.
5. Fill in the following details:
   * **Attribute Key**: A unique identifier for the key (e.g., `meeting_title`).
   * **Attribute Name**: The display label (e.g., *Meeting Title*).
   * **Attribute Type**: Choose from available formats such as Select, Event, Timing, or use the earlier examples (*Single Line Text*, *Multi-Line Text*, *Date & Time Picker*).

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FlA1Jnhv16DsCjG9sSXIk%2Fimage.png?alt=media&#x26;token=da4b0401-67c7-44f0-81ba-8f905b941bd1" alt=""><figcaption></figcaption></figure>

6. Make attributes for all 5 of the needed attributes. They are:
   1. Summary
   2. Description
   3. Start Time
   4. End Time
   5. Email
7. Repeat the process until all required attributes are created.

***

### Step 4: Add Google Calendar Actions to Agent

1. In the Agent Instructions editor, type a backslash (`/`) in the Agent Actions search bar.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fnm1mWrGkc5e9FugBjwV2%2Fimage.png?alt=media&#x26;token=742926e1-c299-41ab-bf34-5927ea1e58fa" alt=""><figcaption></figcaption></figure>

2. Search for Google Calendar and select the required action (e.g., *Google Calendar Create Event*).

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F0I6qIhcHOE9KvHsYbDvq%2Fimage.png?alt=media&#x26;token=fc151aa2-efbe-4d6c-a405-8cce39a1ca75" alt=""><figcaption></figcaption></figure>

3. Choose the credentials/configuration (Google account) to link with this action.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FgEEQOFKFgIBg954s3Qcb%2Fimage.png?alt=media&#x26;token=c6061911-93f3-4114-aee5-3acd10a776ff" alt=""><figcaption></figcaption></figure>

***

### Step 5: Map Data Fields

In the **Configuration screen**:

1. For each Google Calendar field (Summary, Description, Start Time, End Time, Email), map it to the **corresponding custom attribute** you created earlier.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FBbXFDskWhrDHbygdxPBE%2Fimage.png?alt=media&#x26;token=489cb016-3158-4578-a66c-663c7cd3f488" alt=""><figcaption></figcaption></figure>

2. Leave **Fallback Values** empty unless a default is required.

***

### Step 6: Test the Integration

In the **Test screen**, provide sample data for all five fields:

**Example:**

* Summary: *Product Demo*
* Description: *30-min walkthrough of features*
* Start Time: 2025-09-19T17:30:00+08:00
* End Time: 2025-09-19T17:30:00+09:00
* Email: *<client@example.com>*

Click **Test Data**.

* If successful, the event will be created in Google Calendar.
* If failed, an error message will appear explaining the issue (e.g., invalid time format).

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fso11bCDsU6qrb7vC5spS%2Fimage.png?alt=media&#x26;token=3645bf2b-6889-4b84-b30d-e10820a7c60a" alt=""><figcaption></figcaption></figure>

***

### Step 7: Deploy

1. Once the test passes, click **Finish**.
2. The integration will now appear in your agent’s code instructions as a **green oval box** (e.g., *Google Calendar Create Event*).
3. Your AI Agent is now fully integrated with Google Calendar!

***

## **Frequently Asked Questions (FAQs)**

<details>

<summary>Do I need a Google account to use the integration?</summary>

Yes. You must have a valid Google account with access to Google Calendar in order to connect and sync with BotPenguin’s AI Agent.

</details>

<details>

<summary>Can I connect multiple Google Calendar accounts?</summary>

Yes. You can integrate multiple Google Calendar accounts. Each account will appear as a separate configuration under the integration settings.

</details>

<details>

<summary>What happens if I disable a configuration?</summary>

Disabling a configuration will temporarily stop event syncing for that account. You can re-enable it anytime by toggling the status back on.

</details>

<details>

<summary>Is it mandatory to create custom attributes?</summary>

Yes. Custom attributes are required to capture user inputs (like event title, date, or participants). Without these attributes, the AI Agent cannot create or manage events in Google Calendar.

</details>

<details>

<summary>Can the AI Agent manage existing events in my calendar?</summary>

Currently, the integration focuses on creating new events based on user input. Managing or editing existing events is subject to the permissions you grant during integration.

</details>

<details>

<summary>What happens if the Google token expires?</summary>

If the Google token expires, you will need to re-authenticate by reconnecting your Google account from the integration settings.

</details>

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.