How Google Calendar Sync Works (Two-Way, Busy Blocks, and Conflicts)

Any calendar in the Appointments module can be connected to a Google Calendar account to keep both schedules aligned.

How to connect it

1. Go to Calendar.
2. On the card for the calendar you want to sync, click Connect Google.
3. Sign in with the matching Google account and accept the calendar permissions.
4. Back in Omnifox, the card now shows Google ✓ next to the connected email.

To disconnect, use the same card — the option to unlink is available there without deleting appointments already created.

What syncs (and in which direction)

Sync runs in two distinct directions, not a full mirror:

• Omnifox → Google: every appointment created, rescheduled, or cancelled on that calendar is pushed as an event to the connected Google calendar (created, updated, or deleted as needed).
• Google → Omnifox: times already marked busy on the connected Google calendar (meetings, personal events, anything) are taken into account when computing availability, so Omnifox never offers a time the agent has already blocked in their Google. Google events aren't imported as Omnifox appointments — they're only used to block the slot.

How conflicts are avoided

Since the availability engine checks Google's busy/free status before offering a slot, an event added directly in Google (an internal meeting, say) blocks that time for new bookings in Omnifox, without anyone having to replicate it by hand.

Example

A rep has their personal Google calendar connected. They add an internal meeting from 2:00 to 3:00 PM there. A customer trying to book in Omnifox for that window won't see it in the list of available times, even though Omnifox itself has no appointment on record yet.

Tips

• Connect Google on Agent-type calendars that map to that rep's real personal schedule — that's where it adds the most value.
• If Google doesn't respond (service outage, expired token), Omnifox keeps showing availability based on its own data alone; it never blocks bookings because of that.

Troubleshooting

If a calendar stopped blocking times that are actually busy on Google, the connection token likely expired — click Connect Google again to renew the permission.