Calendar - Scheduling

Your personal scheduling assistant

Overview

Calendar is your scheduling hub in General Bots Suite. Create events, manage appointments, schedule meetings, and let the AI help you find the perfect time. Calendar syncs with your other apps so you never miss an important date.

Features

Views

View	Description
Day	Hourly breakdown of single day
Week	7-day overview
Month	Full month grid
Agenda	List of upcoming events

Calendars

Calendar	Icon	Use For
Personal	🟢	Private appointments
Work	🔵	Professional meetings
Team	🟣	Shared team events
Holidays	🔴	Public holidays

Event Types

Type	Icon	Description
Meeting	👥	Group meetings
Call	📞	Phone/video calls
Reminder	🔔	Personal reminders
All-Day	📅	Full day events
Recurring	🔄	Repeating events

Keyboard Shortcuts

Shortcut	Action
`C`	Create new event
`T`	Go to today
`D`	Day view
`W`	Week view
`M`	Month view
`←` / `→`	Previous / Next period
`Delete`	Delete selected event
`Enter`	Open event details

Scheduling via Chat

Creating an Event

Schedule a meeting with Sarah tomorrow at 2pm

10:30

✅ Meeting scheduled!

👥 Meeting with Sarah

📅 Tomorrow at 2:00 PM

⏱️ Duration: 1 hour

Invitation sent to Sarah.

10:30

Checking Your Schedule

What's on my calendar today?

08:00

📅 Today's Schedule (May 15):

09:00 AM - Team Standup (30 min)

11:00 AM - Client Call (1 hour)

02:00 PM - Project Review (1 hour)

04:30 PM - 1:1 with Manager (30 min)

You have 4 events today.

08:00

Finding Available Time

When am I free this week for a 2-hour meeting?

09:15

🗓️ Available 2-hour slots this week:

• Tuesday 3:00 PM - 5:00 PM

• Wednesday 10:00 AM - 12:00 PM

• Thursday 2:00 PM - 4:00 PM

• Friday 9:00 AM - 11:00 AM

Would you like to book one of these?

09:15

Rescheduling Events

Move my 2pm meeting to 4pm

13:30

✅ Meeting rescheduled!

👥 Project Review

📅 Today at 4:00 PM (was 2:00 PM)

Updated invitations sent to attendees.

13:30

Setting Reminders

Remind me about the dentist appointment on Friday at 9am

11:00

✅ Reminder set!

🔔 Dentist appointment

📅 Friday at 9:00 AM

⏰ I'll remind you 1 hour before.

11:00

API Endpoints

Endpoint	Method	Description
`/api/calendar/events`	GET	List events
`/api/calendar/events`	POST	Create event
`/api/calendar/events/:id`	GET	Get event details
`/api/calendar/events/:id`	PATCH	Update event
`/api/calendar/events/:id`	DELETE	Delete event
`/api/calendar/availability`	GET	Check free/busy

Query Parameters

Parameter	Values	Default
`start`	ISO date	Today
`end`	ISO date	+30 days
`calendar`	Calendar name	All
`view`	`day`, `week`, `month`	`month`

Create Event Request

{
    "title": "Team Meeting",
    "start": "2025-05-16T14:00:00Z",
    "end": "2025-05-16T15:00:00Z",
    "calendar": "work",
    "attendees": ["sarah@company.com"],
    "location": "Conference Room A",
    "reminder": 15,
    "recurrence": null
}

Event Response

{
    "id": "evt-123",
    "title": "Team Meeting",
    "start": "2025-05-16T14:00:00Z",
    "end": "2025-05-16T15:00:00Z",
    "calendar": "work",
    "attendees": [
        {
            "email": "sarah@company.com",
            "status": "accepted"
        }
    ],
    "location": "Conference Room A",
    "reminder": 15,
    "created": "2025-05-15T10:30:00Z"
}

Integration with Tasks

Tasks with due dates automatically appear on your calendar. When you complete a task, it’s marked as done on the calendar too.

Troubleshooting

Events Not Syncing

Refresh the calendar
Check internet connection
Verify calendar is enabled in sidebar
Wait a few minutes for sync

Can’t Create Events

Verify you have write access to the calendar
Check that start time is before end time
Ensure date is not in the past

Missing Invitations

Check spam/junk folder in email
Verify attendee email addresses
Check notification settings

General Bots Documentation