Connecting Your Calendar to Voksha

A Premium or Enterprise plan. Calendar booking is included on Premium and Enterprise. It is not part of the Starter plan. If your agent is on Starter, the Calendar page will send you to billing to upgrade before you can connect anything.

Admin access to the calendar you want to use. You will be signing in to the calendar account, so you need its credentials or the ability to approve access.

A decision about which calendar. Voksha supports three:

• Google Calendar, including both personal Google accounts and Google Workspace
• Microsoft Outlook, including Microsoft 365 accounts
• iCloud Calendar, using an Apple ID

Pick the calendar your team actually looks at. The agent will write real appointments to it, so it should be the calendar you check every morning, not a spare one.

Google Calendar connects through Google's standard sign-in flow, so you never type your Google password into Voksha.

1. On the agent's Calendar tab, click Connect Google Calendar.
2. Google asks you to choose an account and shows you what access Voksha is requesting.
3. Approve it. You are returned to the Calendar page, which now shows Connected along with the email address of the account you linked.

That is the whole process. Google's own consent screen handles the security, and Voksha stores the resulting access token encrypted rather than holding your password.

A note on working hours: Google does not expose its working-hours setting in a way Voksha can read, so you will set your availability manually in the next step. See the booking setup guide for how to do that.

Outlook connects the same way as Google, through Microsoft's own sign-in flow.

1. On the agent's Calendar tab, click Connect Microsoft Outlook.
2. Sign in with the Microsoft account whose calendar you want to use and approve the access request.
3. You return to the Calendar page showing Connected and the linked account.

Outlook has one advantage over the others. Microsoft does publish your configured working hours through its API, so when you connect Outlook, Voksha can pull those hours in automatically as a starting point for your booking availability. You can still adjust them afterwards. With Google and iCloud you set the hours by hand.

iCloud works differently from the other two. Apple does not offer a sign-in flow for this, so the connection uses your Apple ID plus an app-specific password. This is a one-time password Apple generates specifically for connecting an outside service, and it can be revoked on its own without affecting your main Apple account.

Step 1: generate the app-specific password.

1. Sign in at appleid.apple.com.
2. Find the sign-in and security section and choose to generate an app-specific password.
3. Give it a label such as "Voksha" so you can recognise it later.
4. Apple shows you a password in the format xxxx-xxxx-xxxx-xxxx. Copy it. Apple will not show it again.

Step 2: connect it in Voksha.

1. On the agent's Calendar tab, find the iCloud section.
2. Enter your Apple ID, which can be an email address or a phone number.
3. Paste the app-specific password.
4. Click Connect iCloud Calendar.

Voksha verifies the credentials immediately, so if something was mistyped you will see the failure right away rather than discovering it on a live call. The password is stored encrypted.

Each agent has exactly one active calendar. This keeps the behaviour predictable: when the agent offers a time, there is no ambiguity about which calendar it checked.

Connecting a second calendar switches off the first. If an agent is connected to Google and you then connect Outlook, the Google connection is deactivated and Outlook becomes the active one. Nothing is lost, but the agent will only ever read from and write to the newest connection.

If you run several calendars that all need phone booking, use a separate agent for each, with its own number and its own calendar. That way each agent's availability reflects exactly one calendar.

It is reasonable to want to know what a service does with calendar access before granting it. For Voksha, the answer is narrow.

Voksha reads: your busy and free times within the booking window. It needs to know when you are occupied so it never offers a slot you cannot make. It reads availability, not the contents of your meetings, and it does not need to know who you are meeting or why in order to find a free hour.

Voksha writes: the appointments it books. When a caller confirms a time, Voksha creates a calendar event at that time. The event is titled with the caller's name where they gave one, and the description carries the reason for the appointment and the caller's phone number, so you have the context in front of you when the appointment arrives.

Voksha does not delete your events. Booking is additive. If a booking fails partway through, the record is marked as failed rather than removed, so nothing quietly disappears from your calendar or your history.

Credentials are encrypted at rest. Whether it is an access token from Google or Microsoft or an app-specific password from Apple, it is encrypted in storage. Every booking request that reaches Voksha from an agent is also verified with a shared secret, so an outsider cannot post appointments onto your calendar by guessing your agent's address.

You can disconnect at any time from the agent's Calendar tab. Disconnecting stops the agent from checking availability or creating events, and the booking tools come off the agent automatically. Appointments already on your calendar stay exactly where they are, because they are ordinary calendar events at that point.

To move an agent from one calendar to another, simply connect the new one. The previous connection is switched off in the same action, so there is no window where both are live.

If you connected iCloud and want to fully revoke access, disconnect in Voksha and also revoke the app-specific password at appleid.apple.com. For Google and Microsoft, you can additionally remove Voksha from the connected-apps list in your account security settings.