כל מה שקראתם כאן, המערכת עושה בשבילכם בקליק
45 יום לנסות את ביג בוס בחינם. בלי כרטיס אשראי, בלי התקנה: מייל וסיסמה וזהו.
כל מערכת עם מפתח משלה
כשכמה מערכות מתחברות לביג בוס, למשל האתר ומערכת ההזמנות, כדאי שלכל אחת יהיה מפתח גישה משלה. כך אפשר לחסום מערכת אחת בלי לפגוע באחרות, ולרשום את ההכנסות מכל ערוץ לחשבון הכנסה נפרד. מספר המפתחות אינו מוגבל.
המדריך מסביר איך מקצים חשבון הכנסה למפתח, איך משביתים מפתח לזמן מה, איך מוחקים אותו ואיך מחליפים מפתח.
רשימת המזהים
ב"הגדרות מערכת" ← "ניהול ממשק Api" נפתח המסך "רש' מזהים". לכל מזהה מוצגים "שם מזהה", "חשבון הכנסה", "מפתח Api", "הרשאה", "שימוש אחרון" ו"סטטוס". עוזר שהתחבר לשרת ה-MCP דרך אישור החיבור בביג בוס מופיע כאן כמזהה בשם "<שם העוזר> (MCP)", למשל "ChatGPT (MCP)", "Claude (MCP)" או "Google (MCP)", שהוא החיבור של Gemini, עם ההרשאה שנבחרה במסך האישור. כיבוי או מחיקה של המזהה, או החלפת המפתח שלו, מנתקים את העוזר. איך מחברים: חיבור ChatGPT, Claude ו-Gemini לביג בוס. המפתח ברשימה מוסתר: מוצגים "****" ו-4 התווים האחרונים שלו, ובשורה אין כפתור העתקה. את המפתח המלא רואים ומעתיקים רק פעם אחת, בחלון "המפתח נשמר" שנפתח מיד אחרי השמירה. ב"הרשאה" מופיע "קריאה בלבד", "קריאה וכתיבה" או "קריאה, כתיבה ושליחה ללקוחות". ב"שימוש אחרון" מופיעים התאריך והשעה שבהם המפתח שימש לאחרונה. הערך הזה לא מתעדכן ברגע הבקשה, ולכן הוא טוב כדי לזהות מפתח שאף מערכת כבר לא משתמשת בו, ולא כדי לבדוק בקשה מהדקות האחרונות. בשורת החיפוש מחפשים לפי שם המזהה, ולחיצה על שורה פותחת את "פרטי המזהה".

עמודת "הרשאה" ברשימת המזהים, עם השם המלא של כל הרשאה. בצילום מזהי בדיקה.
כל מפתח פועל בשם המשתמש שיצר אותו. לכן גם דוחות העסק: מפתח קורא אותם רק כשלמשתמש שיצר אותו יש הרשאת צפייה בדוחות, כלומר מנהל המערכת, או עובד שמסומנת אצלו בכרטיס העובד התיבה "צפייה בדוחות ובמספרי מסך הבית". אם המשתמש הזה הושבת, הבקשות במפתח נדחות עם ההודעה "המשתמש אינו פעיל". הרשימה לא מציגה מי יצר כל מפתח, ולכן כדאי שאת המפתחות ייצור משתמש קבוע בעסק.
מה כל מפתח שלח בפועל, ומה ביג בוס ענתה לו, רואים לפי שם המזהה ב"יומן קריאות Api".
חשבון הכנסה לכל מפתח
אפשר לקבוע לכל מפתח חשבון הכנסה. מסמכים שנוצרים דרך ה-API במפתח הזה נרשמים לחשבון שבחרתם, וכך, למשל, ההכנסות מהאתר נפרדות מהכנסות אחרות.
1. פותחים את המזהה
לוחצים על השורה ב"רש' מזהים". נפתח המסך "פרטי המזהה".
2. מחפשים חשבון
ליד "חשבון הכנסה" לוחצים "חיפוש". בחלון "חיפוש חשבון הכנסה" מחפשים לפי "שם החשבון", ולכל חשבון מוצגת גם ה"קבוצה" שלו.
3. בוחרים
מסמנים את תיבת הסימון של החשבון ולוחצים "בחר חשבון". לחיצה על השורה לבד אינה בוחרת. בלי סימון מופיעה ההודעה "יש לבחור חשבון הכנסה תחילה". אחרי הבחירה מופיע ליד השדה גם הכפתור "ברירת מחדל", שמחזיר את המפתח לחשבון ההכנסה המוגדר כברירת מחדל בחברה.
4. שומרים
לוחצים "שמירת שינויים". מכאן והלאה, מסמכים שנוצרים במפתח נרשמים לחשבון שבחרתם.

"פרטי המזהה" אחרי בחירת חשבון: הכפתור "ברירת מחדל" מחזיר לחשבון של החברה.
כשלמפתח אין חשבון משלו, המסמך נרשם לחשבון ההכנסה של הלקוח, ואם גם לו אין, לחשבון ברירת המחדל של החברה. אם החשבון שבחרתם למפתח הושבת, המסמכים נרשמים לברירת המחדל, וליד שם החשבון מופיע "(לא פעיל – נרשם לברירת מחדל)".
השבתה זמנית
צריך לעצור מערכת לזמן מה, למשל בזמן תיקון באתר? משביתים את המפתח שלה:
1. מעבירים ל"לא פעיל"
ב"פרטי המזהה" מעבירים את המתג ל"לא פעיל" ולוחצים "שמירת שינויים".
2. הגישה נחסמת מיד
הבקשה הבאה במפתח נדחית עם ההודעה "קוד הזדהות אינו פעיל".
3. מחזירים כשרוצים
החזרה ל"פעיל" מחזירה לעבודה את אותו מפתח, ואין צורך לעדכן את המערכת המתחברת.

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

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

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

השאלה לפני החלפת מפתח של עוזר: ההחלפה מנתקת אותו.

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

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