כל המאמרים

אינטגרציות: מפתח API ושרת MCP לתוכנה של העסק

"חיבורים" הוא המסך שבו העסק מנפיק מפתח לתוכנה אחרת: האתר שלכם, בוט שמזמין, סקריפט, או עוזר בינה מלאכותית — שקוראים את היומן וקובעים בו בלי לפתוח את תורים. באותו מסך יש גם את הכרטיס של Morning (חשבונית ירוקה), להפקת קבלות — הפירוט במאמר על קבלות. מפתחות API, שרת ה-MCP וה-Webhooks הם חלק ממסלול Pro.

מפתח API

מנהל מנפיק מפתח במסך "חיבורים", נותן לו שם ותוקף, ובוחר מה הוא רשאי: לראות את העסק והזמנים הפנויים (תמיד), לראות את היומן, לקבוע ולהזיז תורים, לשנות שירותים ושעות. המפתח מוצג פעם אחת; אם אבד, מבטלים ומנפיקים חדש. מפתח שייך לעסק אחד ופועל בשם המנהל שהנפיק אותו — מי שהפסיק להיות מנהל, המפתחות שלו נכבים.

שני שערים, אותם כללים

הראשון הוא API רגיל, עם תיעוד בעמוד "ממשק API" באתר. השני הוא שרת MCP — הפרוטוקול שדרכו עוזרי בינה מלאכותית מתחברים לכלים — עם אותו מפתח ואותן הרשאות. שניהם עוברים דרך אותו קוד שהיומן עצמו משתמש בו: מניעת כפילויות, הודעות ללקוח, רשימת המתנה. תוכנה לא יכולה לקבוע תור שהאתר היה מסרב לו.

מה תוכנה לא יכולה

להנפיק מפתח נוסף — זה נעשה רק מהדפדפן, כדי שמפתח שדלף לא יוליד יורשים. ולקבוע תור מחוץ ללוח: היומן שלכם מרשה לכם להקליד שעה חריגה ביד, ותוכנה מקבלת רק את השעות שהלוח מציע.

Webhooks

באותו מסך אפשר לרשום כתובת שאליה תורים שולחת הודעה ברגע שתור נקבע, בוטל או הוזז — כך מערכת אחרת נשארת מעודכנת בלי לשאול. כל הודעה חתומה במפתח שמוצג פעם אחת, ו"שליחת בדיקה" מוודאת שהכתובת מקבלת. כתובת שנכשלת שוב ושוב נכבית מאליה, ומפתח חדש מפעיל אותה מחדש; מה שנשלח לכל כתובת נשמר ב"היסטוריית שליחות". איך מאמתים את החתימה כתוב בעמוד "ממשק API".

לעמוד הרלוונטי