การเชื่อมต่อปฏิทิน

เชื่อมต่อครั้งเดียว จัดการได้ทุกที่ เมื่อคุณเชื่อมต่อ Google Calendar หรือ Microsoft Outlook (Teams) แล้ว บทเรียน Voilà ของคุณจะปรากฏในปฏิทินของคุณเหมือนการประชุมอื่นๆ — และสิ่งใดก็ตามที่คุณทำกับกิจกรรมจากปฏิทินของคุณจะส่งผลกลับไปยัง Voilà โดยอัตโนมัติ เปลี่ยนเวลา ยกเลิก ยอมรับ ปฏิเสธ — ทั้งสองฝั่งจะซิงค์กันภายในไม่กี่วินาที

หน้านี้เขียนสำหรับติวเตอร์ ส่วน "สิ่งที่นักเรียนของคุณจะพบ" จะอธิบายสิ่งที่นักเรียนของคุณเห็นในฝั่งของพวกเขาอย่างชัดเจน เพื่อให้คุณสามารถจัดการตารางเวลาทั้งหมดจากปฏิทินของคุณได้อย่างมั่นใจ

ผู้ให้บริการที่รองรับ

ผู้ให้บริการ	ลิงก์วิดีโอแนบอัตโนมัติ	สิ่งที่ถูกสร้างขึ้น
Google Calendar	Google Meet	หนึ่งกิจกรรมต่อบทเรียน กิจกรรมหลักต่อซีรีส์ที่เกิดซ้ำ
Microsoft Outlook / Teams	Microsoft Teams	หนึ่งกิจกรรมต่อบทเรียน หนึ่งกิจกรรมต่อการเกิดซ้ำ

คุณสามารถเชื่อมต่อผู้ให้บริการปฏิทินได้ครั้งละหนึ่งราย หากต้องการเปลี่ยน ให้ตัดการเชื่อมต่อรายปัจจุบันก่อนใน Settings → Integrations

การเชื่อมต่อ Google Calendar

1. ไปที่ Settings → Integrations หรือ Scheduling → Connect Google Calendar
2. คลิก Connect Google Calendar
3. เข้าสู่ระบบด้วยบัญชี Google ของคุณและอนุญาตให้ Voilà อ่านและเขียนกิจกรรม
4. ปฏิทินของคุณจะเริ่มซิงค์ทันที

สิ่งที่เกิดขึ้นในขณะที่คุณเชื่อมต่อ: บทเรียน Voilà ในอนาคตที่ยืนยันแล้วทุกบทจะถูกส่งไปยัง Google Calendar ของคุณ — แต่ละบทมาพร้อมลิงก์ Google Meet ผู้เข้าร่วมที่เติมไว้ล่วงหน้า และเนื้อหา "Booked via Voilà" ไม่มีอะไรอื่นที่ต้องทำ

การเชื่อมต่อ Microsoft Outlook / Teams

1. ไปที่ Settings → Integrations หรือ Scheduling → Connect Outlook Calendar
2. คลิก Connect Outlook Calendar
3. เข้าสู่ระบบด้วยบัญชี Microsoft ของคุณและอนุญาตให้ Voilà อ่านและเขียนกิจกรรม
4. ปฏิทินของคุณจะเริ่มซิงค์ทันที

บทเรียนแต่ละบทจะปรากฏในปฏิทิน Outlook ของคุณเป็นการประชุม Teams (ลิงก์เข้าร่วมจะแนบมาโดยอัตโนมัติ) โดยมีนักเรียนอยู่ในรายชื่อผู้เข้าร่วม พฤติกรรมการเติมข้อมูลย้อนหลังเหมือนกัน: บทเรียน 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à ทำ
ยอมรับคำเชิญ	ไม่มีอะไรเพิ่มเติม — พวกเขาอยู่ในบทเรียนแล้ว การตอบรับของพวกเขาจะถูกบันทึกเพื่อการมองเห็น
ปฏิเสธข้อเสนอที่รอดำเนินการจากปฏิทินของพวกเขา	ข้อเสนอจะถูกปฏิเสธใน Voilà คุณจะได้รับการแจ้งเตือนทางอีเมลและแชท
ปฏิเสธบทเรียน 1:1 ที่ยืนยันแล้วจากปฏิทินของพวกเขา	Voilà รันสาขาการยกเลิกโดยนักเรียนของนโยบายการยกเลิก ก่อนเวลาตัดขาด = เงินคืนเต็มจำนวนหรือเครดิตคืน; หลังเวลาตัดขาด = ริบ (คุณเก็บเงิน)
ปฏิเสธจากบทเรียนกลุ่มที่ยืนยันแล้ว	เฉพาะที่นั่งของนักเรียนคนนั้นจะได้รับเงินคืน; บทเรียนดำเนินต่อไปสำหรับคนอื่นๆ (ขึ้นอยู่กับกฎที่นั่งขั้นต่ำของคุณ)
ปฏิเสธการเกิดขึ้นที่เกิดซ้ำ	เฉพาะการเกิดขึ้นครั้งเดียวนั้นจะถูกข้าม (เงินคืนหรือริบตามนโยบายการยกเลิก) ส่วนที่เหลือของซีรีส์จะไม่ถูกแตะต้อง
ส่งต่อคำเชิญไปยังกล่องจดหมายอื่น	ไม่มีผลต่อบทเรียน — Voilà เป็นแหล่งความจริง และการส่งต่อคำเชิญไม่ได้ย้ายบทเรียนหรือออกเงินคืนใหม่

โดยสรุป: นักเรียนสามารถจัดการการเข้าร่วมของพวกเขาได้ทั้งหมดจากคำเชิญปฏิทิน และคุณจะเห็นทุกการกระทำสะท้อนในฝั่ง Voilà ภายในไม่กี่วินาที

บทเรียนกลุ่มผ่านปฏิทิน

บทเรียนกลุ่มเพิ่มความซับซ้อนอีกหนึ่งอย่าง — กฎที่นั่งขั้นต่ำ:

• สมาชิกหนึ่งคนปฏิเสธ → ที่นั่งนั้นได้รับเงินคืน ผู้เข้าร่วมถูกลบออกจากกิจกรรมปฏิทิน บทเรียนดำเนินต่อไป
• การปฏิเสธทำให้บทเรียนต่ำกว่า min_seats ก่อนเวลาตัดขาดการยกเลิก → บทเรียนทั้งหมดถูกยกเลิก ที่นั่งที่จ่ายแล้วทุกที่ได้รับเงินคืน กิจกรรมปฏิทินถูกลบ
• การปฏิเสธทำให้บทเรียนต่ำกว่า min_seats หลังเวลาตัดขาดการยกเลิก → บทเรียนยังคงดำเนินต่อไป (คนที่ยึดที่นั่งไว้จ่ายเงินสำหรับช่วงเวลาแล้ว) และคุณจะได้รับอีเมลแจ้งเตือนเพื่อให้คุณตัดสินใจว่าจะจัดการอย่างไร

บทเรียนที่เกิดซ้ำผ่านปฏิทิน

บทเรียนที่เกิดซ้ำจะถูกเก็บแตกต่างกันในแต่ละผู้ให้บริการ แต่ประสบการณ์เหมือนกัน:

• Google: ซีรีส์เป็นกิจกรรมหลักที่เกิดซ้ำเดียว การปฏิเสธหนึ่งครั้งจากปฏิทินจะข้ามเฉพาะการเกิดขึ้นนั้นใน Voilà; การปฏิเสธหลักจะยกเลิกการเกิดขึ้นในอนาคตทุกครั้ง
• Outlook: การเกิดขึ้นแต่ละครั้งจะเชื่อมโยงแยกกันเพื่อให้การอัปเดตแต่ละครั้งจาก Microsoft Graph ส่งผ่านได้อย่างราบรื่น การปฏิเสธหนึ่งการเกิดขึ้นจะข้ามใน Voilà; การปฏิเสธซีรีส์จะสิ้นสุดการเกิดขึ้นในอนาคต
• การข้ามการเกิดขึ้นจากใน Voilà จะยกเลิกอินสแตนซ์ปฏิทินที่ตรงกันโดยอัตโนมัติพร้อมการแจ้งเตือนการยกเลิกที่ชัดเจนให้ผู้เข้าร่วม
• การเปลี่ยนแปลงนโยบายการยกเลิกของติวเตอร์ไม่ถูกนำไปใช้ย้อนหลังกับการเกิดขึ้นที่มีอยู่แล้ว — การเกิดขึ้นแต่ละครั้งจะล็อกนโยบายที่ใช้งานอยู่ตอนที่ถูกสร้างขึ้น

วิธีการส่งมอบการซิงค์

Voilà ใช้การแจ้งเตือนแบบพุช (webhooks) เป็นตัวกระตุ้นหลัก:

• Google Calendar — Voilà สมัครสมาชิกปฏิทินของคุณผ่านช่อง events.watch ของ Google; การอัปเดตจะมาถึงภายในไม่กี่วินาทีหลังจากคุณบันทึกใน Google Calendar
• Microsoft Outlook / Teams — Voilà สมัครสมาชิกผ่าน Microsoft Graph webhooks; พฤติกรรมเหมือนกัน

ชุดเครือข่ายความปลอดภัยเล็กๆ ช่วยรักษาช่องทางให้แข็งแรง:

• งานบำรุงรักษารายชั่วโมงต่ออายุการสมัครสมาชิกก่อนหมดอายุและบูตสแตรปการเฝ้าดูที่ขาดหายไป
• การเติมข้อมูลย้อนหลังเมื่อเชื่อมต่อส่งบทเรียน Voilà ในอนาคตที่มีอยู่ไปยังปฏิทินใหม่ของคุณ (และนำเข้าเวลาไม่ว่างปฏิทินที่มีอยู่ของคุณกลับมา)
• การรีเฟรชด้วยตนเองมีให้ใช้จากหน้า Scheduling — มีประโยชน์หากคุณกำลังทดสอบหรือหาก webhook พลาดการส่งมอบชั่วคราว

เวอร์ชันก่อนหน้าของหน้านี้กล่าวถึง "รอบการโพลล์ 5 นาที" นั่นไม่ถูกต้องอีกต่อไป — การซิงค์เป็นแบบพุชและมักจะมาถึงในเวลาไม่ถึง 30 วินาที

นโยบายการยกเลิกและการคืนเงินผ่านปฏิทิน

การยกเลิกฝั่งปฏิทินจะปฏิบัติตามนโยบายการยกเลิกเดียวกันที่คุณกำหนดไว้สำหรับการจองที่จ่าย Stripe (ดู Stripe Connect Payments):

• คุณยกเลิก (ลบ/ยกเลิกจากปฏิทินของคุณ): นักเรียนได้รับเงินคืนเต็มจำนวน ไม่ว่าจะเป็นเวลาไหน
• นักเรียนปฏิเสธจากปฏิทินของพวกเขาก่อนเวลาตัดขาด: เงินคืนเต็มจำนวนหรือเครดิตคืนให้นักเรียน
• นักเรียนปฏิเสธจากปฏิทินของพวกเขาหลังเวลาตัดขาด: การชำระเงินถูกริบ (คุณเก็บไว้) หรือเครดิตเซสชันถูกใช้
• บทเรียนกลุ่ม: การคืนเงินต่อที่นั่งสำหรับการปฏิเสธแต่ละราย; การคืนเงินเต็มจำนวนของที่นั่งที่จ่ายแล้วทุกที่หากการยกเลิกโดยติวเตอร์หรือการลดลงต่ำกว่า min_seats ก่อนเวลาตัดขาดยกเลิกบทเรียน

ความเป็นส่วนตัวและขอบเขต

• Voilà อ่านและเขียนกิจกรรมเฉพาะในปฏิทินที่คุณเชื่อมต่อเท่านั้น — ไม่เคยใช้ปฏิทินอื่นๆ ในบัญชีของคุณ
• กิจกรรมที่ Voilà อ่านจะใช้เฉพาะสำหรับการจัดตารางเวลาและการคำนวณความพร้อมเท่านั้น
• คุณสามารถเพิกถอนการเข้าถึงได้ตลอดเวลาใน Settings → Integrations (หรือโดยตรงจากการตั้งค่าบัญชี Google / Microsoft ของคุณ)

การแก้ไขปัญหา

โทเค็นหมดอายุ

หากการซิงค์หยุด โทเค็น OAuth อาจหมดอายุแล้ว เปิด Settings → Integrations และคลิก Reconnect

ความล่าช้าในการซิงค์

Webhooks มักจะส่งมอบภายใน ~30 วินาที งานบำรุงรักษารายชั่วโมงเป็นเครือข่ายความปลอดภัยที่ต่ออายุการสมัครสมาชิกและซิงค์การส่งมอบที่ล้มเหลวชั่วคราวใหม่ คุณยังสามารถเรียกการรีเฟรชด้วยตนเองจากหน้า Scheduling

ความขัดแย้งกับกิจกรรมที่ไม่ใช่ Voilà

หากคุณพยายามยืนยันการจอง Voilà ในช่วงเวลาที่ถูกครอบคลุมโดยกิจกรรมที่ไม่ใช่ Voilà ในปฏิทินของคุณ Voilà จะเตือนคุณและให้คุณแทนที่ความขัดแย้ง — มีประโยชน์เมื่อกิจกรรมปฏิทินเป็นการจอง "อ่อน" ที่คุณยินดีปล่อย

การเปลี่ยนผู้ให้บริการ

สามารถเชื่อมต่อปฏิทินได้ครั้งละหนึ่งรายเท่านั้น ตัดการเชื่อมต่อ Google ก่อนเชื่อมต่อ Outlook (หรือในทางกลับกัน) ใน Settings → Integrations

การซิงค์แบบสองทิศทาง แบบครบวงจร

sequenceDiagram
    participant Student
    participant StudentCal as "Student Calendar"
    participant Voila
    participant TutorCal as "Tutor Calendar (Google or 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: กิจกรรมปฏิทินถูกลบ

ที่เกี่ยวข้อง

• การจัดตารางเวลา — ความพร้อมรายสัปดาห์ นโยบายการจอง โหมดวันหยุด
• บทเรียนกลุ่ม — ที่นั่งขั้นต่ำ การจัดการสมาชิก พฤติกรรมการยกเลิกกลุ่ม
• Stripe Connect Payments — นโยบายการยกเลิกและวิธีการใช้เงินคืน