Google Calendar

Umumiy ma'lumot

Bronjoy xodimlar qabullarini sinxron holda saqlash uchun Google Calendar bilan integratsiyalashadi. Ikkita sinxronizatsiya rejimi mavjud:

Google Calendar sinxronizatsiyasi

Ulanish

1. Avtorizatsiya URL'ini oling:

   GET /api/org/calendar/auth-url?provider=google
   Authorization: Bearer your-token
   

   
   Google OAuth rozilik URL'ini qaytaradi. Xodim uni brauzerida ochadi.
2. Ruxsat berilgandan so'ng Google Bronjoy'ga qaytadan yo'naltiradi. Ulanish avtomatik yaratiladi.
3. Ulanishni tekshiring:

   GET /api/org/calendar/connections
   Authorization: Bearer your-token
   

Sinxronizatsiya xatti-harakati

Ulangandan so'ng Bronjoy ikkala yo'nalishda sinxronlaydi:

Yuborish (Bronjoy → Google):

• Yangi qabullar Google Calendar hodisalari sifatida yaratiladi
• Qayta belgilangan qabullar hodisani yangilaydi
• Bekor qilingan qabullar hodisani o'chiradi
• Hodisa tavsifi xizmat nomi, mijoz ma'lumotlari va izohlarni o'z ichiga oladi

Olish (Google → Bronjoy):

• Xodim kalendaridagi tashqi hodisalar bo'sh vaqt oralig'larini bandlaydi
• Olingan hodisalar keshlanadi va vaqti-vaqti bilan yangilanadi
• Kun bo'yi davom etadigan hodisalar to'g'ri qayta ishlanadi (butun kunni bandlaydi)

Sinxronizatsiya imkoniyatlarini yoqish/o'chirish

Har bir ulanish uchun nima sinxronlanishini boshqaring:

PATCH /api/org/calendar/connections/{connection}/toggle
Authorization: Bearer your-token
Content-Type: application/json

{
  "push_enabled": true,
  "pull_enabled": true
}

Qo'lda sinxronlash

Darhol sinxronizatsiyani ishga tushiring (Google Calendar'da o'zgartirish kiritgandan keyin foydali):

POST /api/org/calendar/connections/{connection}/sync
Authorization: Bearer your-token

Ulanishni uzish

DELETE /api/org/calendar/connections/{connection}
Authorization: Bearer your-token

Bu OAuth tokenini bekor qiladi, keshlangan hodisalarni o'chiradi va barcha sinxronizatsiyani to'xtatadi. Bronjoy tomonidan yaratilgan mavjud Google Calendar hodisalari o'chirilmaydi.

iCal tasmasi

iCal tasmasi — bu istalgan kalendar ilovasi obuna bo'lishi mumkin bo'lgan, faqat o'qish uchun mo'ljallangan URL. U xodimning kelgusi qabullarini ko'rsatadi.

Tasma URL'ini olish

GET /api/org/calendar/feed-url
Authorization: Bearer your-token

Quyidagi kabi URL qaytaradi:

https://api.bronjoy.com/api/calendar/feed/abc123token.ics

Kalendar ilovangizda obuna bo'lish

Google Calendar:

1. Google Calendar'ni oching → Boshqa kalendarlar → URL orqali
2. Tasma URL'ini joylashtiring
3. Google uni avtomatik yangilaydi (odatda har necha soatda)

Apple Calendar:

1. Fayl → Yangi kalendar obunasi
2. Tasma URL'ini joylashtiring

Outlook:

1. Kalendar qo'shish → Internetdan
2. Tasma URL'ini joylashtiring

Tasma tafsilotlari

• Keyingi 6 oy uchun kelgusi qabullarni o'z ichiga oladi
• Bekor qilingan qabullarni o'z ichiga olmaydi
• Har bir hodisada quyidagilar bor: xizmat nomi, mijoz ismi, izohlar, manzil
• Har 60 daqiqada yangilanadi (kalendar ilovasiga qarab farq qilishi mumkin)
• Token orqali autentifikatsiya qilinadi — tizimga kirish talab etilmaydi

Bitta qabulni yuklab olish

Mijozlar bitta qabulni .ics fayli sifatida yuklab olishlari mumkin:

GET /api/client/appointments/{appointment}/ics
Authorization: Bearer client-token

Yoki muayyan kalendar ilovalariga qo'shish uchun havolalarni oling:

GET /api/client/appointments/{appointment}/calendar-links

Google Calendar va Outlook uchun to'g'ridan-to'g'ri havolalarni qaytaradi.

Eng yaxshi amaliyotlar

• Agar xodimlar o'z jadvalini Google Calendar'da faol boshqarsa, Google Calendar sinxronizatsiyasidan foydalaning — u tashqi hodisalarni olib, ikki marta yozilishning oldini oladi
• Agar xodimlar Bronjoy qabullarini o'zlari afzal ko'rgan kalendar ilovasida faqat ko'rishni istasa, iCal tasmasidan foydalaning
• Google Calendar'da yozilish vaqtlarini bandlashi kerak bo'lgan shaxsiy hodisalari bor xodimlar uchun olish sinxronizatsiyasini yoqing
• Bir xodim uchun Google Calendar sinxronizatsiyasi va iCal tasmasini birga ishlatmang — bu takroriy hodisalarni keltirib chiqaradi