לחבר את workonit
יש שתי דרכים: שרת MCP לסוכני AI, ו-API לשרתים.
שרת MCP
סוכני AI כמו Claude ו-ChatGPT מתחברים בכתובת https://www.workonit.ai/mcp. בלי כניסה, הם רואים מה יש ב-workonit: האתרים, האפליקציות וסוכני ה-AI.
כדי לעבוד בחשבון, מחברים את סוכן ה-AI בכתובת https://www.workonit.ai/mcp/account. הסוכן מבקש כניסה, ואתם מאשרים בעמוד של workonit.
מכאן הוא עובד בהרשאות שלכם: קורא, ומשנה רק דרך הפעולות של האפליקציות. כל פעולה נרשמת בהיסטוריה.
בכל סוכן AI שתומך ב-MCP, כמו Claude, ChatGPT, Grok ו-Gemini, מוסיפים חיבור חדש ומדביקים את הכתובת. מבטלים את החיבור בהגדרות, בלשונית "חיבורים".
API לשרתים
שרת חיצוני מדבר עם workonit במפתח של החשבון, וכל בקשה חתומה. סכומים באגורות, כולל מע"מ.
התיאור המלא ב-OpenAPI.
הנתיבים
-
GET /v1/connection
מי אני: המפתח, הארגון, בדיקות או ייצור, התחומים והגבולות
-
POST /v1/payments
קישור תשלום (תחום payments)
-
GET /v1/payments/{id}
מצב תשלום: המקור של המצב הסופי
-
POST /v1/subscriptions
מנוי: תשלום ראשון ושמירת כרטיס
-
POST /v1/subscriptions/{id}/charge
חיוב חודשי של תקופה. ייחודי לפי (מנוי, תקופה)
-
POST /v1/subscriptions/{id}/cancel
ביטול מנוי
-
GET /v1/issues
הדיווחים בתיבה של הארגון, עד 50 בעמוד, מהישן לחדש. מפתח בדיקות רואה רק דיווחי בדיקה
-
POST /v1/issues
דיווח על תקלה (תחום issues): לתיבה של הארגון או לצוות של WOI
-
POST /v1/issues/{ticket_id}/status
סימון דיווח בתיבה של הארגון: forwarded (עם forwarded_to) או handled
-
POST /v1/customers
לקוח בארגון (תחום customers). external_ref הוא המפתח: אותו ערך מחזיר את אותו לקוח. טלפון משותף לא מאחד לקוחות
-
PATCH /v1/customers/{customer_id}
עדכון לקוח (תחום customers). גוף חלקי: name, email, phone. null או "" במייל או בטלפון מוחקים את השדה
-
POST /v1/approvals
בקשת אישור מהבעלים והמנהלים של הארגון (תחום approvals). ההחלטה יוצאת כאירוע approval.decided, גם בדחייה
-
POST /v1/approvals/{approval_id}/result
התוצאה בצד של השרת אחרי ההחלטה (תחום approvals). רק לבקשה של המפתח. התוצאה הראשונה נשמרת, וקריאה חוזרת מחזירה אותה. לפני ההחלטה: 409 NOT_DECIDED
-
POST /v1/recruiting/jobs
עותק של משרה מהאתר שלכם בארגון של המפתח (תחום recruiting). כל שליחה היא המשרה המלאה, ושדה שלא נשלח נשמר ריק. עדכון לפי external_ref. בשלב הזה העותק לא מתפרסם מ-WOI ונערך רק אצלכם
-
GET /v1/state
מפתח אחד במצב העבודה של החשבון (תחום state). מפתח שלא קיים או שפג תוקפו: 404 NOT_FOUND
-
POST /v1/state
כתיבה במצב העבודה של החשבון (תחום state). take: נעילה, ומפתח תפוס מחזיר taken=false עם הערך. put: כתיבה. delete: מחיקה. עם version, הכתיבה והמחיקה רק אם הוא עדיין זהה
-
GET /v1/customers/{organization_id}/requests
מנהל לקוח: הפניות של לקוח אחד בתיבה של WOI, עד 50 בעמוד. רק למפתח של WOI
-
POST /v1/requests/{ticket_id}/reply
מנהל לקוח: תשובה ללקוח, בשיחה, בפעמון ובטלגרם. רק למפתח של WOI
-
GET /v1/companies/{company_id}/file
תיק לקוח: החברה, היומן (עד 100, מהחדש) והקבצים, עם קישור הורדה לעשר דקות. רק למפתח של WOI
-
POST /v1/companies/{company_id}/log
תיק לקוח: שורה ביומן. השורה הראשונה היא הכותרת. רק למפתח של WOI
-
POST /v1/companies/{company_id}/files/upload-url
תיק לקוח: כתובת העלאה חתומה וקצרת מועד. מעלים ב-PUT ל-upload_url, ואז רושמים ב-/files. רק למפתח של WOI
-
POST /v1/companies/{company_id}/files
תיק לקוח: רישום של קובץ שכבר הועלה. רק למפתח של WOI
מגבלות ושגיאות
עד 60 בקשות בדקה לשרת ה-MCP, מכל כתובת. כל שגיאה חוזרת כ-JSON, עם קוד והודעה.