Calendar Setup Guide

Connecting Your Calendar

For the AiTalk AI to book appointments or check schedules, you just need to connect it once to your Google Calendar or Outlook (Microsoft) Calendar. Follow the steps below and you'll be done in 5–10 minutes.

Why do I connect it myself?

Your calendar events stay right inside your own Google / Microsoft account. AiTalk does not copy or store your events separately — it only uses your calendar when it needs to create or check an appointment.

That's why, just once at the start, you grant permission from your own account for "AiTalk to use my calendar." You then paste the two values created during this setup into AiTalk, and the connection is complete.

What you'll need

The connection requires two values — named exactly as they appear on the AiTalk screen:

• Client ID — the connection ID
• Client Secret — the connection secret

You'll also need a Redirect URI address, but this is already shown on the AiTalk screen — just use the Copy button next to it.

You create the values above in the Google or Microsoft admin console, following the guide below. It's not difficult — just follow the steps in order.

Connecting Google Calendar

For Google Calendar, you create the values in an admin console called Google Cloud.

1. Create a project

• Go to https://console.cloud.google.com/projectcreate
• Enter any project name (e.g. "AiTalk Calendar") → Create
• If you already have a project, you can use it as-is.

2. Turn on the calendar feature

• In the top search bar, search for Google Calendar API, open it, and click Enable.

3. Set up app info and permissions (Google Auth Platform)

• In the left menu, go to Google Auth Platform (formerly: OAuth consent screen) and click Get started
• Under Branding, enter basic info such as app name and support email, then save
• Under Audience, choose the user type — usually External; if your company uses Google Workspace, Internal is simpler
• Under Data Access → Add or Remove Scopes, add the two calendar permissions below (paste the full addresses exactly as shown):
  • https://www.googleapis.com/auth/calendar.events.owned
  • https://www.googleapis.com/auth/calendar.readonly

4. Register the accounts that will connect (if you chose External)

• On the Audience screen, under Test users, add your own and your staff's Gmail addresses.
• Only the accounts registered here can connect. (Rest assured — registering an account does not let people see each other's calendars. Each person connects only their own.)
• If you created it as Internal (company Workspace), this step does not apply.

5. Create the connection values (OAuth client ID)

• Left menu Credentials → Create Credentials → OAuth client ID
• For Application type, choose Web application
• Give it any name (e.g. "AiTalk")
• In the Authorized redirect URIs field → paste the Redirect URI copied with the Copy button from the AiTalk screen
• Click Create, and the Client ID and Client Secret will be shown → copy them.

6. Enter them in AiTalk and connect

• On the AiTalk Google Calendar screen, paste the Client ID and Client Secret, then Save credentials
• Click Connect Google Calendar — a Google sign-in window opens → sign in with an account registered above → Continue (allow)
• Done! The AI can now book and check appointments on this calendar.

Connecting Outlook (Microsoft) Calendar

For Outlook Calendar, you create the values in a Microsoft admin console called Azure.

1. Register an app

• Go to https://portal.azure.com
• Search for App registrations, open it, and click New registration
• Give it any name (e.g. "AiTalk Calendar")
• For account type, choose "Accounts in any organizational directory ... and personal Microsoft accounts". (the option that allows both work accounts and personal Microsoft accounts)
• Redirect URI: set the type to Web, then paste the Redirect URI from the AiTalk screen
• Click Register

2. Create the secret value (Client secret)

• On the registered app screen, go to Certificates & secrets → New client secret
• Enter any description; for Expires, 24 months is recommended → Add
• Copy the Value right away.
• ⚠️ Once you leave this screen, you cannot see the value again. Be sure to copy it now.

3. Grant calendar permissions (API permissions)

• API permissions → Add a permission → Microsoft Graph → Delegated permissions
• Check the following three and add them: Calendars.ReadWrite, offline_access, User.Read
• For a company (organization) account, an administrator may need to click Grant admin consent once. (Not required for a personal outlook.com account.)

4. Enter them in AiTalk and connect

• The two values you need:
  • Application (client) ID — found on the app's Overview screen
  • Client Secret — the Value you copied in step 2
• On the AiTalk Microsoft Calendar screen, paste both values → Save credentials → Connect Microsoft Calendar → sign in to Microsoft and allow → done!

If something goes wrong

If you get stuck during setup, please contact the AiTalk support team (support@aitalk.ch).