跳至主要内容

日曆整合

連接一次，隨處管理。 連接 Google 日曆或 Microsoft Outlook（Teams）後，您的 Voilà 課程就會像其他會議一樣出現在您的日曆上——您在日曆上對事件所做的任何操作都會自動流回 Voilà。重新排程、取消、接受、拒絕——雙方會在幾秒內保持同步。

本頁面是為家教編寫的。「您的學生體驗」部分說明了您的學生在他們那一端看到的內容，讓您可以放心地從日曆管理整個課程表。

支援的提供者​

提供者自動附加影片連結建立的內容
Google 日曆Google Meet每堂課一個事件，每個循環系列一個主事件
Microsoft Outlook / TeamsMicrosoft Teams每堂課一個事件，每個循環發生一個事件

您一次只能連接一個日曆提供者。若要切換，請先在設定 → 整合下斷開目前的連接。

連接 Google 日曆​

  1. 前往設定 → 整合或排程 → 連接 Google 日曆。
  2. 點擊連接 Google 日曆。
  3. 使用您的 Google 帳戶登入，並授權 Voilà 讀取和寫入事件。
  4. 您的日曆會立即開始同步。

連接時會發生什麼： 每個已確認的未來 Voilà 課程都會被推送到您的 Google 日曆——每個都附有 Google Meet 連結、預先填入的參與者，以及「透過 Voilà 預訂」的內容。您無需做任何其他事情。

連接 Microsoft Outlook / Teams​

  1. 前往設定 → 整合或排程 → 連接 Outlook 日曆。
  2. 點擊連接 Outlook 日曆。
  3. 使用您的 Microsoft 帳戶登入，並授權 Voilà 讀取和寫入事件。
  4. 您的日曆會立即開始同步。

每堂課都會作為 Teams 會議出現在您的 Outlook 日曆上（加入連結會自動附加），學生列為參與者。相同的回溯行為適用：未來的 Voilà 課程會立即出現在您的 Outlook 日曆上。

日曆上顯示的內容（Voilà → 日曆）​

Voilà 事件日曆上顯示的內容
1:1 預訂已確認課程時間的邀請，包含 Meet/Teams 連結、學生作為參與者，以及 Voilà 撰寫的內容。
小組課程已確認相同的事件，所有接受的成員都在參與者清單上。隨著更多成員接受，他們會被新增；如果成員退出，他們會被移除。
建立循環課程Google： 涵蓋整個系列的一個主循環事件。Outlook： 每個發生一個事件（因此每個實例的更新可以透過 Microsoft Graph 順利流動）。
在 Voilà 中接受重新排程邀請的開始/結束時間會就地更新，參與者會收到更新通知。適用於 Google 和 Outlook。
在 Voilà 中取消課程日曆事件會被移除，參與者會收到取消通知。適用於 Google 和 Outlook。
在 Voilà 中跳過循環發生只有該發生會被取消——系列的其餘部分保持完整。

同步回 Voilà 的內容（日曆 → Voilà）​

本部分讓您「住在日曆裡」。以下任何內容都會自動改變 Voilà 狀態。

您移動事件時間​

將 Voilà 事件拖到不同的時段，或編輯其開始/結束時間，會在 Voilà 內開啟重新排程提案。一旦學生確認（在應用程式內或透過回覆電子郵件），事件時間就會在兩個系統中鎖定。在此之前，事件會作為待處理提案——學生仍然可以從 Voilà 內看到並接受/拒絕它。

您刪除或取消事件​

Voilà 會將課程標記為已取消，並執行取消政策的家教取消分支：

  • 學生會獲得全額退款（如果是 Stripe）或返還其課程學分（如果是課程套件），無論取消是否發生在截止時間之前或之後。家教歸因的取消總是讓學生獲得全額補償。
  • 對於小組課程，每個已付費的座位都會被退款。
  • 學生會收到取消電子郵件和聊天卡更新。

您建立一個新事件，其中一個學生作為參與者​

如果您和該學生之間存在活躍的師生關係，Voilà 將：

  • 自動建立該課程的預訂提案。
  • 向學生發送電子郵件，以便他們可以確認時間。
  • 在提案待處理期間在您的可用性上保留該時段。

如果參與者不是您已知的學生，Voilà 會將事件記錄為您可用性上的常規忙碌時間——但不會建立預訂。

您將任何其他事件新增到日曆​

您新增的任何事件——工作會議、牙醫預約、與朋友共進午餐——都會被視為忙碌時間，並在該時間窗口內阻止新的學生預訂。您無需做任何事情；這是自動的。

您的學生體驗​

每當課程確認時，您的學生會收到相同事件的日曆邀請——內含 Meet 或 Teams 加入連結。因此他們也可以從自己的日曆管理課程。以下是 Voilà 對學生可以從其收件箱或日曆應用程式執行的每項操作的確切反應：

學生操作Voilà 的做法
接受邀請沒有額外操作——他們已經在課程上。他們的 RSVP 會被記錄以供查看。
從日曆拒絕待處理提案提案在 Voilà 中被拒絕。您會收到電子郵件和聊天通知。
從日曆拒絕已確認的 1:1 課程Voilà 執行取消政策的學生取消分支。截止時間前 = 全額退款或返還學分；截止時間後 = 沒收（您保留付款）。
從已確認的小組課程拒絕只有該學生的座位被退款；課程對其他人繼續進行（受您的最少座位規則限制）。
拒絕循環發生該單一發生會被跳過（根據取消政策退款或沒收）。系列的其餘部分保持不變。
將邀請轉發到另一個收件箱對課程沒有影響——Voilà 是真實來源，轉發邀請不會移動課程或重新發放退款。

簡而言之：學生可以完全從他們的日曆邀請管理他們的參與，您會在幾秒內看到 Voilà 端反映的每項操作。

透過日曆的小組課程​

小組課程增加了一個額外的複雜性——最少座位規則：

  • 一個成員拒絕 → 該座位被退款，參與者從日曆事件中移除，課程繼續進行。
  • 拒絕在取消截止時間之前將課程降至 min_seats 以下 → 整個課程被取消，每個已付費的座位都被退款，日曆事件被移除。
  • 拒絕在取消截止時間之後將課程降至 min_seats 以下 → 課程保持進行（保留座位的人已經為該時段付費），您會收到一封提醒電子郵件，以便您可以決定如何處理。

透過日曆的循環課程​

循環課程在每個提供者上的儲存方式不同，但體驗是相同的：

  • Google： 系列是單個主循環事件。從日曆拒絕一個實例只會在 Voilà 中跳過該發生；拒絕主事件會取消每個未來發生。
  • Outlook： 每個發生都單獨連結，因此來自 Microsoft Graph 的每個實例更新可以順利流動。拒絕一個發生會在 Voilà 中跳過它；拒絕系列會結束未來發生。
  • 從 Voilà 內跳過發生會自動取消匹配的日曆實例，並向參與者發送清晰的取消通知。
  • 家教的取消政策變更不會追溯應用於已存在的發生——每個發生都會鎖定建立時活躍的政策。

同步如何傳遞​

Voilà 使用推送通知（webhooks）作為主要觸發器：

  • Google 日曆 — Voilà 透過 Google 的 events.watch 頻道訂閱您的日曆；更新會在您在 Google 日曆中儲存後的幾秒內到達。
  • Microsoft Outlook / Teams — Voilà 透過 Microsoft Graph webhooks 訂閱；相同行為。

一小組安全網保持頻道健康：

  • 每小時維護工作在訂閱過期前更新它們，並啟動任何遺漏的監視。
  • 連接時回溯將現有的未來 Voilà 課程推送到您的新日曆（並回溯匯入您現有的日曆忙碌時間）。
  • 手動重新整理可從排程頁面取得——在您測試或 webhook 暫時未能傳遞時很有用。

本頁面的早期版本提到了「5 分鐘輪詢週期」。這不再準確——同步是基於推送的，通常在 30 秒內到達。

透過日曆的取消政策和退款​

日曆端的取消遵循您為 Stripe 付費預訂配置的完全相同的取消政策（請參閱 Stripe Connect 付款）：

  • 您取消（從日曆刪除/取消）：學生獲得全額退款，無論時間如何。
  • 學生在截止時間前從日曆拒絕：全額退款或返還學分給學生。
  • 學生在截止時間後從日曆拒絕：付款被沒收（您保留）或課程學分被消耗。
  • 小組課程：個別拒絕的每座位退款；如果家教取消或截止前下降至 min_seats 以下取消課程，則每個已付費座位的全額退款。

隱私和範圍​

  • Voilà 只讀取和寫入您連接的日曆上的事件——永遠不會讀取您帳戶上的任何其他日曆。
  • Voilà 讀取的事件僅用於排程和可用性計算。
  • 您可以隨時在設定 → 整合下撤銷存取權限（或直接從您的 Google / Microsoft 帳戶設定）。

疑難排解​

權杖已過期​

如果同步停止，OAuth 權杖可能已過期。開啟設定 → 整合並點擊重新連接。

同步延遲​

Webhooks 通常在約 30 秒內傳遞。每小時維護工作是一個安全網，可更新訂閱並重新同步任何暫時未能傳遞的內容。您也可以從排程頁面觸發手動重新整理。

與非 Voilà 事件的衝突​

如果您嘗試在日曆上被非 Voilà 事件覆蓋的時段確認 Voilà 預訂，Voilà 會警告您並讓您覆蓋衝突——當日曆事件是您樂意釋放的「軟」保留時很有用。

切換提供者​

一次只能連接一個日曆。在設定 → 整合下斷開 Google 後再連接 Outlook（或反之）。

雙向同步，端對端​

sequenceDiagram
    participant Student
    participant StudentCal as "學生日曆"
    participant Voila
    participant TutorCal as "家教日曆（Google 或 Outlook）"
    participant Tutor

    Note over Voila,TutorCal: 課程在 Voilà 中確認
    Voila->>TutorCal: 建立含 Meet 或 Teams 連結的事件
    TutorCal-->>Student: 邀請已傳遞
    TutorCal-->>StudentCal: 邀請已傳遞

    Note over Student,StudentCal: 學生從收件箱拒絕
    StudentCal->>TutorCal: RSVP 已拒絕
    TutorCal->>Voila: Webhook 觸發
    Voila->>Voila: 執行取消政策
    Voila-->>Tutor: 應用程式內和電子郵件通知
    Voila-->>Student: 退款或沒收確認

    Note over Tutor,TutorCal: 家教取消事件
    TutorCal->>Voila: Webhook 觸發
    Voila->>Voila: 取消並退款
    Voila->>StudentCal: 日曆事件已移除

相關​