# 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](mailto:undefined), and click on the **More** icon in the left-hand sidebar.

<figure><img src="/files/4sX7bvgDF0PtacsKIECj" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/afyJolsBW4E4XlTyrJ3d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/Ye2PYJDhncEkMmlfnKS4" 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="/files/cEIvMNLd4f7iadjX9ej6" 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="/files/AbYd9fjmV5NcrosMnKdm" 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="/files/WW9WHM86npiWqnLdG71e" 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="/files/UOUm5P5QiHvGDoWiGmYn" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/528zJtUzyTQj2WZyBVtS" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/flny63vcO02B1jBSf1rs" 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="/files/hHau0mkQWGAwwN7ZGXoY" 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="/files/RfSW6wFfsOj3DZhalJjR" 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.botpenguin.com/settings/integrations/google-calendar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.