דילוג לתוכן

Calendar

לוח הזמנים שלכם, עמודי הזמנה ושירותים.

פתיחת Calendar
נבדק מול לוח הבקרה ב-19 בנובמבר 2026

ל-Calendar יש שיטות ציבוריות לשני הצדדים של פגישה. חלקן פועלות עבורכם, הבעלים, ומקבלות את מפתח ה-API שלכם: הן קוראות את ההגדרה והפגישות שלכם, מגדירות משאבים, שירותים ועמודים, מחזיקות ומאשרות זמן, מבטלות ומשנות את התוכנית. אחרות הן אלה שעמוד קביעת תורים מבצע עבור מבקר. הן לא צריכות מפתח, רק את המפתח של העמוד.

שיתוף יומנים עם אנשים אחרים, התצוגות, המשימות, אירועי היום והגדרות היומן נעשים בדשבורד. אין להם היום שיטה ציבורית.

שולחים בקשה לשיטה עם המפתח שלכם:

curl -s https://xuda.ai/cpi/get_calendar_setup \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","uid":"YOUR_ACCOUNT_UID"}'
const res = await fetch('https://xuda.ai/cpi/get_calendar_setup', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    uid: 'YOUR_ACCOUNT_UID',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_calendar_setup',
    json={
        'api_key': 'YOUR_API_KEY',
        'uid': 'YOUR_ACCOUNT_UID',
    },
)

לתשובה טובה יש code 1. שינוי שהתוכנית שלכם לא כוללת נדחה עם code -62 ומשפט ב-data, למשל שמפגשים קבוצתיים דורשים Growth או שהתוכנית שלכם מחזיקה מספר של עמודי קביעת תורים. כדי לפעול על היומן של חשבון ששיתף אותו איתכם ברמת עריכה, מעבירים את ה-share_id שלו לשיטות שמקבלות אחד.

קוראים את ההגדרה והפגישות שלכם

  • get_calendar_setup עונה בקריאה אחת על כל מה שמסכי Calendar מציירים: האנשים והחדרים שאפשר לקבוע, עם השעות שלהם, השירותים, ועמודי קביעת התורים שפורסמו עם הכתובות הציבוריות שלהם.
  • get_calendar_bookings מפרטת פגישות, הקרובות כברירת מחדל. מעבירים past שמוגדר ל-true לאלה שכבר קרו, החדשות ראשונות, ו-limit לכמה. כל שורה נושאת את הזמן באזור של המשאב, את פרטי האורח ואת כל מה שאמר כשקבע.
  • get_calendar_slots מפרטת את הזמנים שאפשר לקבוע של שירות אחד במשאב אחד בין from_ts ל-to_ts (אלפיות שנייה מאז epoch), בלי כל מה שכבר תפוס.

מגדירים מה אפשר לקבוע

  • save_calendar_resource יוצרת או מעדכנת משהו שאפשר לקבוע: אדם, חדר, כיסא או מכשיר. היא צריכה timezone, אזור IANA כמו Asia/Jerusalem, והשעות שלה נקראות באזור הזה. משמיטים את resource_id כדי ליצור חדש.
  • save_calendar_service יוצרת או מעדכנת מה שאנשים יכולים לקבוע: המשך שלו, מרווחים, התראה מראש, כמה רחוק קדימה אפשר לקבוע, מקומות, איפה נפגשים (meeting_kind), ועם price_cents, currency ו-checkout, כמה הוא עולה והאם משלמים בקביעה. יותר ממקום אחד דורש תוכנית שכוללת מפגשים קבוצתיים, וגביית תשלום דורשת תוכנית שכוללת תשלומים.
  • save_calendar_page יוצרת או מעדכנת עמוד קביעת תורים: ה-title שלו, intro, ה-service_ids שהוא מציע, האם הוא enabled, צבע ה-accent שלו, show_host, האם מבקרים יכולים לשנות את הפגישה שלהם (visitor_changes, change_hours, refund_percent) והחשבון הפיננסי שהתשלום מגיע אליו (finance_account_id). יצירת עמוד מעבר למגבלת העמודים של התוכנית שלכם נדחית.
  • delete_calendar_item מסירה משאב, שירות או עמוד לפי item_id. פגישות אף פעם לא נמחקות כך: הן מבוטלות.

קובעים זמן בעצמכם

קביעה מהקוד שלכם היא שני שלבים, כך שזמן אחד אף פעם לא נמכר פעמיים.

מחזיקים את הזמן

hold_calendar_slot שומרת זמן לכמה דקות. מעבירים resource_id, service_id ו-start_utc (אלפיות שנייה מאז epoch). לתשובה טובה יש data עם occ_id, hold_token ו-expires_at. שולחים idem_key כדי שחזרה על הקריאה תחזיר את אותה החזקה במקום לקחת מקום שני.

מאשרים אותו

confirm_calendar_booking הופכת את ההחזקה לפגישה. מעבירים את ה-occ_id ואת ה-hold_token מההחזקה, ואת ה-name, ה-email, ה-phone וה-note של האורח. החזקה שכבר לא קיימת איבדה את הזמן ונדחית.

curl -s https://xuda.ai/cpi/hold_calendar_slot \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","uid":"YOUR_ACCOUNT_UID","resource_id":"RESOURCE_ID","service_id":"SERVICE_ID","start_utc":1793000000000}'
const res = await fetch('https://xuda.ai/cpi/hold_calendar_slot', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    uid: 'YOUR_ACCOUNT_UID',
    resource_id: 'RESOURCE_ID',
    service_id: 'SERVICE_ID',
    start_utc: 1793000000000,
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/hold_calendar_slot',
    json={
        'api_key': 'YOUR_API_KEY',
        'uid': 'YOUR_ACCOUNT_UID',
        'resource_id': 'RESOURCE_ID',
        'service_id': 'SERVICE_ID',
        'start_utc': 1793000000000,
    },
)

משנים פגישה

  • cancel_calendar_booking מבטלת לפי booking_id ומחזירה את הזמן לרשת הציבורית. בטוח לקרוא לה פעמיים. היא רק משחררת את הזמן: היא לא שולחת אימייל לאורח ולא מחזירה תשלום, מה שביטול הפגישה בדשבורד עושה לאורח שקבע דרך העמוד שלכם.
  • notify_calendar_guests שולחת אימייל לכל המוזמנים לפגישה אחת, הודעה אחת לכל אחד, עם הזמנת היומן מצורפת ו-message אופציונלי של עד 2000 תווים. kind הוא invite לפגישה חדשה ו-update לשינוי, שהוא ברירת המחדל. האימייל יוצא מתיבת הדואר שלכם בתוכנית שכוללת אותה, ומכתובת הקביעה של Xuda אחרת, עם הכתובת שלכם כ-reply-to.
  • create_booking_room יוצרת את חדר Xuda Meet של פגישת וידאו מאושרת שאין לה אחד, ושולחת לכל אורח את הקישור.

מה עמוד קביעת תורים קורא

עמוד קביעת תורים עובד עם מפתח העמוד שלו, <uid>.<page_id>, ובלי חשבון.

  • get_booking_bootstrap עונה על מה שעמוד צריך כדי לצייר את עצמו: הכותרת שלו, השירותים שלו וטוקן אנטי-בוט טרי.
  • get_public_booking_slots מפרטת את הזמנים שמבקר יכול לבחור, כל אחד עם התחלה, סיום וספירת מקומות. היא אף פעם לא אומרת מי מחזיק את המקומות האחרים.
  • public_book_slot מקבלת פגישה ממבקר. מעבירים את ה-page_key, service_id, start_utc, ה-token, ואת ה-name וה-email של המבקר. מוסיפים idem_key כדי שלחיצה כפולה לא תקבע פעמיים. company_website הוא מלכודת לבוטים: משאירים אותו ריק.
  • לשירות שמשלמים עליו בקביעה, public_start_paid_booking מחזיקה את הזמן ומתחילה את התשלום, start_booking_payment שולחת זמן מוחזק ל-Stripe, ו-public_confirm_paid_booking ו-confirm_paid_booking קובעות אותו ברגע שהתשלום עבר. התשלום נקרא בחזרה מ-Stripe לפני שנקבע משהו.
  • מבקר מנהל פגישה מהקישור הפרטי באימייל שלו. get_public_booking, public_cancel_booking ו-public_reschedule_booking מקבלות את מפתח העמוד ואת הערך manage של הקישור הזה. הן עוקבות אחרי הכללים של העמוד: האם מבקרים רשאים לשנות פגישה, ועד כמה שעות לפני שהיא מתחילה. פגישה ששולמה מוחזרת קודם, לפי אחוז ההחזר של העמוד.

התוכנית

get_calendar_plans עונה על ארבע הדרגות עם המחירים שלהן ומה כל אחת נושאת, באיזו תוכנית אתם והאם Calendar מופעל. calendar_set_plan מפעילה אותו, משנה את הדרגה או מכבה אותו: מעבירים plan_id כ-calendar_free, calendar_starter, calendar_growth או calendar_business, או מגדירים deactivate ל-true. ראו תוכניות וחיוב.

כל השיטות

איך המדריך הזה?

עודכן לאחרונה ב-16 בנובמבר 2026