feat: Calendar sync for Oncall - new docs (#62)

Author: ktkaushik

.gitbook.yaml

@@ -4,4 +4,5 @@ redirects:
   alert-modes/cooldown-mode: alerts/personal-alerts-management/deep-work-and-cooldown-modes.md
   alerts/vacation-mode: alerts/personal-alerts-management/out-of-office.md
   administration/enforce-login: administration/sign-in-rules.md
-  integrations-guideline/integrate-spike-with-sentry-webhook: integrations-guideline/integrate-spike-with-sentry.md
+  integrations-guideline/integrate-spike-with-sentry-webhook: integrations-guideline/integrate-spike-with-sentry.md
+  oncall-schedules/export-on-call-schedule: oncall-schedules/calendar-sync-for-oncall/README.md

.gitbook/assets/oncall/calendar-sync/Apple Calendar tile.png

@@ -71,9 +71,12 @@
   * [Slots in schedules](oncall-schedules/introduction-to-slots-in-schedules.md)
   * [Layers in on-call schedules](oncall-schedules/introduction-to-layers-in-on-call-schedules.md)
   * [Override an on-call](oncall-schedules/override-an-on-call.md)
-  * [Add on-call schedule to your calendar](oncall-schedules/export-on-call-schedule.md)
   * [Notifications for on-call shifts](oncall-schedules/notifications-for-on-call-shifts.md)
   * [Change on-call rotation day](oncall-schedules/change-on-call-rotation-day.md)
+  * [Sync with your calendar](oncall-schedules/calendar-sync-for-oncall/README.md)
+    * [Google Calendar](oncall-schedules/calendar-sync-for-oncall/google-calendar-sync.md)
+    * [Apple Calendar](oncall-schedules/calendar-sync-for-oncall/apple-calendar-sync.md)
+    * [Microsoft Outlook](oncall-schedules/calendar-sync-for-oncall/microsoft-outlook-sync.md)
 
 ## Live Call Routing <a href="#live-call-routing" id="live-call-routing"></a>
 

.gitbook/assets/oncall/calendar-sync/Google Calendar tile.png

@@ -0,0 +1,78 @@
+---
+description: >-
+  Add your on-call schedule to your personal calendars like Google Calendar, Apple, and more.
+---
+
+<figure><img src="../../.gitbook/assets/oncall/export-oncall-calendar--cover.png" alt="Export on-call schedule to your calendar"><figcaption></figcaption></figure>
+
+# Add On-call schedule to your calendar
+
+Keep track of your on-call shifts from your favorite calendar app. Spike provides a live subscription link that you can add to Google Calendar, Apple Calendar, Outlook, or any other calendar service that supports calendar subscriptions.
+
+Each link automatically updates whenever your schedule changes, so you always see the latest shifts without downloading any files.
+
+---
+
+## Calendar link options
+
+You can choose what you want to sync:
+
+- **All my shifts across all on-call schedules** – View every upcoming shift you are responsible for, regardless of schedule.
+
+- **My shifts for one on-call schedule**
+
+- **All team members’ shifts in one on-call schedule** – See who is on-call and who will be on-call at any time from your calendar.
+---
+
+## How calendar sync works
+
+The calendar link you copy is a Webcal (iCalendar) feed, which many calendar apps can read and update automatically. When your calendar app fetches the feed, Spike provides the latest on-call data for the next six months.
+
+If you make changes to the schedule in Spike, they’ll appear in your calendar the next time your app refreshes the feed. The update interval depends on your calendar app and can vary by provider.
+
+To export your on-call schedule:
+
+1. **Go to your on-call schedule settings** OR **[calendar view of on-calls](https://app.spike.sh/on-calls/calendar)**
+2. Click on **Calendar sync**
+3. Copy the subscription link or click it directly if your browser offers to open it in your calendar app.
+
+![Export on-call calendar](<../../.gitbook/assets/oncall/export-oncall-calendar.png>)
+
+
+---
+
+#### Works with Any Calendar
+
+<!-- <table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Linear</td><td>Connect with Linear to create issues about incidents</td><td></td><td><a href="../../.gitbook/assets/oncall/calendar-sync/Google Calendar tile.png">Google Calendar tile.png</a></td><td><a href="google-calendar-sync.md">google-calendar-sync.md</a></td></tr><tr><td>Google Calendar</td><td></td><td><a href="../../.gitbook/assets/oncall/calendar-sync/Apple Calendar tile.png">Apple Calendar tile.png</a></td><td><a href="apple-calendar-sync.md">apple-calendar-sync.md</a></td></tr><tr><td>Apple Calendar</td><td></td><td><a href="../../.gitbook/assets/oncall/calendar-sync/Outlook Calendar tile.png">Outlook Calendar tile.png</a></td><td><a href="microsoft-outlook-sync.md">microsoft-outlook-sync.md</a></td></tr></tbody></table> -->
+
+The Spike on-call calendar link follows the iCalendar (Webcal) standard.
+You can use it with any calendar app that supports subscriptions — including Notion, Proton Calendar, Zoho Calendar, or your preferred calendar tool.
+
+---
+
+## FAQs
+
+<details>
+<summary><strong>How often does my calendar update?</strong></summary>
+Your calendar app decides how often it refreshes the subscription. Spike always serves the latest data when requested.
+</details>
+
+<details>
+<summary><strong>Can I share my calendar link with others?</strong></summary>
+Yes but remember that sharing it will expose your schedule.
+</details>
+
+<details>
+<summary><strong>Does the calendar show past shifts?</strong></summary>
+No. The feed only includes upcoming shifts for the next six months.
+</details>
+
+<details>
+<summary><strong>What happens if my schedule changes?</strong></summary>
+Your subscribed calendar will update automatically the next time it refreshes the feed.
+</details>
+
+<details>
+<summary><strong>Can I unsubscribe later?</strong></summary>
+Yes. You can remove the subscribed calendar anytime from your calendar app’s settings.
+</details>

.gitbook/assets/oncall/calendar-sync/Outlook Calendar tile.png

@@ -0,0 +1,36 @@
+---
+description: >-
+  Sync your on-call schedule with your Apple Calendar
+---
+
+# Add On-call schedule to Apple Calendar
+
+View your Spike on-call shifts directly from the Calendar app on your Mac, iPhone, or iPad. By subscribing to your on-call calendar, updates will appear automatically whenever your calendar refreshes.
+
+### Subscribe to Your On-Call Calendar (Mac)
+
+1. Copy your **calendar subscription link** from Spike.
+    1. Go to the Settings page for your on-call schedule.
+    2. Click Sync Calendar and copy the provided link.
+2. Open the Calendar app on your Mac.
+3. In the menu bar, click File → New Calendar Subscription.
+4. Paste the link and click Subscribe.
+5. Name your calendar (for example, “Spike On-Call”) and click OK.
+
+Your on-call shifts will appear automatically in the Calendar app.
+
+---
+
+### Subscribe from iPhone or iPad
+
+1. Copy your Spike calendar link.
+2. Go to Settings → Calendar → Accounts → Add Account → Other.
+3. Tap Add Subscribed Calendar.
+4. Paste the link and tap Next.
+5. Tap Save.
+
+Your on-call schedule will now appear in the Calendar app and stay updated automatically.
+
+{% hint style="info" %}
+If you use iCloud Calendar, subscribing from your Mac will sync the on-call calendar across all your Apple devices automatically.
+{% endhint %}

SUMMARY.md

@@ -0,0 +1,23 @@
+---
+description: >-
+  Sync your on-call schedule with your Google Calendar
+---
+
+# Add On-call schedule to Google Calendar
+Keep your on-call shifts visible alongside your regular meetings in Google Calendar. By subscribing to your Spike on-call calendar, any updates to your schedule will appear automatically without needing to reimport anything.
+
+## Subscribe to your On-Call Calendar
+
+1. Copy your **calendar subscription link** from Spike.
+    1. Go to the Settings page for your on-call schedule.
+    1. Click Sync Calendar and copy the provided link.
+2. Go to [Google Calendar](https://calendar.google.com/)
+3. In the left sidebar, find “Other calendars” and click the “+” icon.
+4. Select `From URL`.
+5. Paste your Spike calendar link and click Add calendar.
+
+Your on-call shifts will now appear in Google Calendar. The calendar will refresh automatically based on Google’s update interval.
+
+{% hint style="info" %}
+If you are logged into your Google account, you can also click the calendar link directly from Spike. It will open Google Calendar and subscribe automatically.
+{% endhint %}

oncall-schedules/calendar-sync-for-oncall/README.md

@@ -0,0 +1,41 @@
+---
+description: >-
+  Sync your on-call schedule with your Microsoft Outlook
+---
+
+# Add On-Call Schedule to Outlook Calendar
+Stay updated on your Spike on-call shifts from Outlook on the browser or desktop. By subscribing to your on-call calendar, any changes made in Spike will appear automatically in Outlook.
+
+## Subscribe in Outlook on the browser
+
+1. Copy your **calendar subscription link** from Spike.
+    1. Go to the Settings page for your on-call schedule.
+    1. Click Sync Calendar and copy the provided link.
+2. Open [Outlook](https://outlook.com) on the browser and sign in.
+3. In the left sidebar, select Add calendar.
+4. Choose Subscribe frm browser.
+5. Paste your Spike calendar link.
+6. Enter a name for the calendar (for example, “Spike On-Call”) and select a color if you wish.
+7. Click Import.
+
+Your on-call schedule will now appear in your Outlook Calendar view.
+
+{% hint style="info" %}
+If you are logged into your Google account, you can also click the calendar link directly from Spike. It will open Google Calendar and subscribe automatically.
+{% endhint %}
+
+---
+
+## Subscribe in Outlook Desktop (Windows or macOS)
+
+1. Copy your calendar subscription link from Spike.
+2. In Outlook, go to File → Account Settings → Account Settings.
+3. Under the Internet Calendars tab, click New.
+4. Paste the Spike calendar link and click Add.
+5. Choose a name for the calendar and click OK.
+
+The calendar will appear under Other Calendars in Outlook and update automatically.
+
+{% hint style="info" %}
+Outlook checks for calendar updates automatically. You’ll always see the latest schedule provided by Spike whenever Outlook refreshes your subscription.
+{% endhint %}