Cal.com bilan bandlash
Tadbir turini ulang, boʻsh vaqtlarni taklif qiling va mijoz tasdigʻidan keyin bandlang.
Tadbir turini ulang, boʻsh vaqtlarni taklif qiling va mijoz tasdigʻidan keyin bandlang.
Kalendarni ulang#
Agent → Amallar → Cal.comni oching. cal_ bilan boshlanuvchi Cal.com API kaliti, musbat butun sonli tadbir turi ID si va Asia/Seoul kabi IANA vaqt zonasini kiriting. Ulanishni saqlashni tanlang. Har agentning alohida ulanishi bor. Kalit serverda shifrlanadi; panel faqat oxirgi toʻrtta belgisini koʻrsatadi. Mavjud ulanishni yangilaganda kalitni boʻsh qoldirsangiz, eskisi saqlanadi.
Ulanishni tekshirish kiritilgan sozlamalar bilan kelgusi 7 kun ichidagi koʻpi bilan 3 ta boʻsh vaqtni oʻqiydi. Bu ulanishni saqlamaydi va bandlov yaratmaydi. Boʻsh natija shu davrda boʻsh vaqt yoʻqligini anglatishi mumkin. Sinov xato bersa Cal.com kaliti, tadbir turi va jadvalini tekshiring. Ulanishni olib tashlash yangi bandlovlarni toʻxtatadi, mavjudlarini bekor qilmaydi.
Toʻlovlar doiradan tashqari. Google Calendar hali hamma uchun ochilmagan alohida variant.
Boʻsh vaqtdan bandlovgacha#
- Agent
find_slotsbilan haqiqiy kelgusi boʻsh vaqtlarni oladi. Sozlangan vaqt zonasida 8 tagacha vaqt koʻrsatiladi. Standart oraliq bugundan 7 kun keyingacha; eng katta sana oraligʻi 14 kun. Bitta vaqt boʻlsa, yolgʻiz oʻzi koʻrsatiladi. - Mijoz vaqtni tanlab, ism, email va ixtiyoriy izoh beradi. Agent bu vaqt shu suhbatga taklif qilinganini va hali boʻshligini qayta tekshiradi. Vaqt takliflari 15 daqiqada eskiradi.
- Tasdiqlash kartasida sana, vaqt, vaqt zonasi va ishtirokchi maʼlumotlari koʻrinadi. Mijoz Tasdiqlashni bosishi shart. Chat xabari yoki vaqt tanlashning oʻzi bandlamaydi. Taklif 15 daqiqada eskiradi va vaqtni ushlab turmaydi.
- Faqat tasdiqdan keyin Cal.com bandlovi soʻraladi.
acceptednatijasidoneboʻladi va bandlov UID si beriladi.pendingyokiawaiting_hostkutilmoqda boʻlib qoladi; rad etish yoki bekor qilish xato sifatida belgilanadi.
Xabar kanallarida bandlov takliflari faqat shaxsiy chatlar uchun. Repetitsiya Cal.comni chaqirmaydi va bandlov yaratmaydi. Cal.com ulanmagan boʻlsa, avvalgi bandlov soʻrovi ishlaydi, lekin bu kalendarda joy bandlanganini isbotlamaydi. Kalit, tadbir turi yoki vaqt zonasini oʻzgartirish eski taklifning bajarish manzilini yaroqsiz qiladi; sozlashdan soʻng qaytadan boshlang.
Vaqt band boʻlsa yoki natija noaniq boʻlsa#
Tasdiq tugaguncha boshqa mijoz vaqtni band qilishi mumkin. Vaqt endi boʻsh boʻlmasa, agent buni aytadi; Cal.com yaratish paytida rad etsa, natija xato boʻladi. Yangi vaqtlarni soʻrang va yangi taklifni tasdiqlang. Xato kartasiga yangi variantlar avtomatik qoʻshilmaydi.
Tarmoq vaqti tugashi muvaffaqiyat yoki xato isboti emas. Xizmat yana tekshirayotganda natija nomaʼlum koʻrsatiladi. Cal.com yaratish endpointida hujjatlashtirilgan idempotentlik kaliti shartnomasi yoʻq. Shuning uchun adapter run ID ni metadata.maf_runda saqlaydi va qayta yaratishdan oldin barcha holatlar va sahifalar boʻylab shu bandlovni qidiradi. Tugallanmagan qidiruv yangi yaratishga ruxsat bermaydi. Bu takror xavfini kamaytiradi, lekin provayderning aynan bir marta bajarish kafolati emas. Urinishlar tugagach yangi bandlovdan oldin Cal.comni tekshiring.
Cal.com mezbonining roziligi maxsus oʻzgartirish amali egasining roziligidan alohida. Integratsiya kutilayotgan Cal.com bandlovini avtomatik yangilamaydi; yakuniy holatni Cal.comda tekshiring. Veb-vidjet saqlangan run natijasini soʻraydi, qoʻllanadigan shaxsiy kanallar esa xizmat oynasi doirasida kechikkan natijani oladi. Natijalarni yetkazishga qarang.
API versiyalari va chiqarish tekshiruvlari#
Adapter Bearer autentifikatsiyasi va endpointga mos cal-api-versionni yuboradi. Quyidagilar 2026-10-13 kuni rasmiy hujjatlar bilan tekshirildi:
| Amal | Versiya | Manba |
|---|---|---|
| Boʻsh vaqtlarni oʻqish | 2024-09-04 | GET /v2/slots |
| Bandlov yaratish | 2026-02-25 | POST /v2/bookings |
| Bandlovni qayta tekshirish | 2026-05-01 | GET /v2/bookings |
Mijozlarga ochishdan oldin nazoratli bandlov yarating, UID ni Cal.comda tekshiring, band vaqtni sinang va har bir kerakli kanaldagi natijani tekshiring. Ulanish sinovi faqat vaqtlar oʻqilganini koʻrsatadi, real bandlov yoki production tayyorligini emas.