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

เชื่อมต่อครั้งเดียว จัดการได้ทุกที่ เมื่อเชื่อมต่อ 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 Calendar ของคุณในรูปแบบการประชุม Teams (ลิงก์เข้าร่วมจะแนบมาโดยอัตโนมัติ) โดยมีนักเรียนอยู่ในรายชื่อผู้เข้าร่วม พฤติกรรมการเติมข้อมูลย้อนหลังเหมือนกัน: บทเรียน Voilà ในอนาคตจะปรากฏบน Outlook Calendar ของคุณทันที

สิ่งที่ปรากฏบนปฏิทินของคุณ (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à ใช้การแจ้งเตือนแบบ push (webhooks) เป็นตัวกระตุ้นหลัก:

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

ชุดมาตรการความปลอดภัยขนาดเล็กช่วยให้ช่องทางทำงานได้อย่างสมบูรณ์:

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

เวอร์ชันก่อนหน้าของหน้านี้กล่าวถึง "รอบการ polling ทุก 5 นาที" ซึ่งไม่ถูกต้องอีกต่อไป — การซิงก์ใช้ระบบ push และโดยทั่วไปจะมาถึงภายในไม่ถึง 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: Lesson confirmed in Voilà
    Voila->>TutorCal: Create event with Meet or Teams link
    TutorCal-->>Student: Invite delivered
    TutorCal-->>StudentCal: Invite delivered

    Note over Student,StudentCal: Student declines from inbox
    StudentCal->>TutorCal: RSVP declined
    TutorCal->>Voila: Webhook fires
    Voila->>Voila: Run cancellation policy
    Voila-->>Tutor: In-app and email notice
    Voila-->>Student: Refund or forfeit confirmation

    Note over Tutor,TutorCal: Tutor cancels the event
    TutorCal->>Voila: Webhook fires
    Voila->>Voila: Cancel and refund
    Voila->>StudentCal: Calendar event removed

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

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