Importing Historical Meetings

How historical sync works#Copy link

When you first connect your Google Calendar via OAuth, Agency Hero automatically kicks off a historical sync in the background. There is nothing to trigger manually — the moment your calendar is connected, the process begins.

The sync covers a fixed window:

• 6 months back — past meetings from the last six months
• 90 days forward — upcoming meetings over the next three months

Because it runs as a background process, you don’t need to stay on the settings page or wait for it to finish. You can continue using Agency Hero normally while the sync completes.

Note: The 6-month lookback window is fixed and is not currently configurable. The sync targets your primary calendar by default; any calendar selection preferences you’ve set in Calendar Sync Settings will also apply.

What gets imported#Copy link

The historical sync captures calendar event metadata. For each meeting in the sync window, Agency Hero imports:

What is NOT imported#Copy link

Historical meetings are metadata only. The sync does not backfill:

• ❌ Transcripts or recordings
• ❌ Extracted intelligence items (decisions, action items, risks)
• ❌ Any content from video conferencing platforms

If you want transcripts and AI-extracted intelligence for future meetings, those are captured automatically when the bot joins live meetings going forward.

Future meetings discovered during sync#Copy link

The sync window extends 90 days into the future, so Agency Hero will also pick up upcoming meetings during the initial sync. Any future-dated meeting that has a valid conference join link (Google Meet, Zoom, etc.) and falls within the 90-day window is automatically handed off to the Meeting Lifecycle Workflow — the same pipeline that handles ongoing meetings.

This means bot scheduling, recording, and post-meeting intelligence processing will run for those meetings exactly as they would for any newly created event. No additional setup is required.

Workspace assignment#Copy link

Historical meetings are assigned to workspaces using the same meeting rules that govern ongoing meetings — attendee matching, email domain patterns, title keywords, and any explicit workspace configurations you have set up.

Workspace assignment runs as a separate background pass after the calendar sync completes, so it may take a short time after sync finishes for all meetings to appear in the correct workspaces.

To ensure accurate assignment:

1. Go to Settings → Meeting Rules
2. Review your rules for attendee matching, domain patterns, and title keywords
3. Make any adjustments before or shortly after connecting your calendar

Meetings that don’t match any rule will remain unassigned until you configure a matching rule or manually assign them.

Monitoring sync progress#Copy link

You can track the status of the historical sync at any time from Settings → Calendar, under the Sync Status panel.

While syncing, the panel shows:

• Sync status — Running, Completed, or Error
• Events processed — Count of calendar events ingested so far
• Calendars synced — Which calendars have been processed
• Meetings queued — Upcoming meetings handed off to the bot scheduling pipeline

Updates appear in real time as the sync runs.

On completion, the panel displays:

• A completed_at timestamp
• Total events processed
• Total calendars synced
• Number of upcoming meetings scheduled for bot lifecycle

If an error occurs, the panel shows a last_error message with actionable guidance. Common causes include calendar permission issues or OAuth token expiry — re-authorizing your Google Calendar connection from the same settings page typically resolves these.

How historical data is used#Copy link

Once imported, historical meetings are immediately available across the platform:

• Workspace timelines — Past meetings appear as timeline entries in the relevant workspaces
• Topic detection — Recurring meeting titles establish topic patterns that the AI uses to categorize future meetings
• Relationship mapping — Participant overlap across meetings surfaces key stakeholders and communication patterns
• Meeting cadence analysis — Historical frequency and timing inform engagement patterns for each client or workspace
• AI agent context — When you ask questions or request insights, AI agents draw on the full meeting history, not just recent activity

Large calendar histories are processed with recent meetings prioritized first. Older data continues processing in the background and becomes available progressively.

What to do after sync completes#Copy link

Once the sync finishes, a few quick checks will help you get the most from your historical data:

1. Review workspace timelines — Open each workspace and confirm that past meetings are appearing and correctly assigned
2. Check Meeting Rules — Go to Settings → Meeting Rules and adjust any rules if meetings landed in the wrong workspace or remained unassigned
3. Explore AI insights — Try asking an AI agent a question about a client relationship or recurring topic — historical meetings are now part of its context
4. Verify upcoming meetings — Check that meetings in the next 90 days with join links have been queued for bot scheduling (visible in the Sync Status panel)

No further action is needed to keep your calendar in sync — Agency Hero will continue to pick up new and updated calendar events automatically going forward.