🗓️ Google Calendar Integration

Allow your AI agent to check availability and book appointments directly into your Google Calendar — in real time, during conversations.

Prerequisites

• A Google account with Google Calendar
• Access to Google Cloud Console
• Admin access to the HoookAI dashboard

Step 1 — Create a Google Cloud Project

Go to console.cloud.google.com → New Project. Give it a name like "HoookAI".

Step 2 — Enable Google Calendar API

In your project: APIs & Services → Library → search for "Google Calendar API" → click ENABLE.

Step 3 — Create OAuth 2.0 Credentials

APIs & Services → Credentials → Create Credentials → OAuth client ID

• Application type: Web application
• Authorized redirect URIs — add: https://dashboard.hoookai.com/api/v1/google-calendar/callback

Copy the Client ID and Client Secret.

Step 4 — Configure OAuth Consent Screen

APIs & Services → OAuth consent screen. Fill in:

• App name: HoookAI
• Homepage URL: https://hoookai.com
• Privacy policy URL: https://hoookai.com/privacy.html
• Authorized domain: hoookai.com

While in Testing mode — add test users (Google accounts) that are allowed to connect. To allow everyone, publish the app and submit for Google verification.

Step 5 — Save Credentials in HoookAI

In Dashboard → your agent → Integrations → Google Calendar → open Google OAuth App Settings:

• Paste your Client ID
• Paste your Client Secret
• Copy the Redirect URI shown (read-only) and verify it matches what you added in Google Cloud

Click Save Settings.

Step 6 — Connect Your Google Account

Click Sign in with Google. You'll be redirected to Google's authorization page. Grant calendar access. You'll be redirected back to HoookAI — the status will show Connected ✅.

Step 7 — Set the Calendar Prompt

After connecting, a Calendar Prompt field appears. Describe how the AI should handle bookings. Example:

When a client wants to book an appointment:
1. Ask for their name, phone number, and preferred date/time
2. Check available slots for that day
3. Create the event with: client name + phone in description
4. Confirm the booking to the client with exact time

Working hours: Monday–Saturday 10:00–19:00
Session duration: 60 minutes