מפתחים · API ו-MCP

ה-API וה-MCP של Unisoft, פתוחים לקוד שלכם ולסוכני ה-AI שלכם.

API REST מתועד, Webhooks חתומים ושרת MCP ש-ChatGPT, Claude, Gemini או Grok מתחברים אליו. המתנדב הטכני שלכם, הסוכנות שלכם או הסוכנים שבניתם עובדים עם נתוני הקהילה, רק בגבולות ההרשאות שאתם מעניקים.

  • יותר מ-700 פעולות מתועדות
  • התחברות OAuth 2.1 לכלי AI
  • Webhooks חתומים, עם ניסיונות חוזרים

עיקרי הדברים

אפשר לחבר את הכלים או את ה-AI שלי ל-Unisoft?

כן. Unisoft מציעה API REST מתועד, Webhooks חתומים ושרת MCP ל-ChatGPT, Claude, Gemini, Grok או לסוכנים משלכם, תמיד בגבולות ההרשאות שאתם מעניקים.

  • REST API V2 עם יותר מ-700 פעולות מתועדות; V1 נשמרת לחיבורים קיימים.
  • שרת MCP בכתובת api.unisoft.world/integrations/mcp, התחברות OAuth 2.1.
  • Webhooks חתומים ב-HMAC SHA-256, עד שישה ניסיונות במשך כתשע שעות.
  • תיעוד ציבורי, עם ייצוא Markdown, ‏llms.txt ו-OpenAPI.

שלוש דרכי כניסה

בחרו את הדרך שמתאימה לפרויקט שלכם.

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

REST API

מפתח אחד, ארגון אחד, ההרשאות שאתם בוחרים.

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

  • גרסה 2 לכל פרויקט חדש; גרסה 1 נשארת זמינה לחיבורים שכבר פועלים.
  • קריאה, כתיבה ושליחה הן הרשאות נפרדות, שאפשר לשנות בהמשך בלי להחליף מפתח.
  • אפשר להגביל מפתח לקמפיינים נבחרים לגיוס כספים.
  • המפתח מוצג פעם אחת בלבד ביצירתו, ואפשר לבטל אותו בכל עת.
curl "$UNISOFT_API_URL/me" \
  -H "Authorization: Bearer $UNISOFT_API_KEY"

{ "success": true,
  "data": {
    "apiKey": {
      "name": "סנכרון האתר",
      "scopes": ["contacts:read",
                 "paiements:read"] },
    "organisation": {
      "name": "הקהילה שלכם",
      "enabledLanguages":
        ["en", "fr", "he"] } } }
הקריאה הראשונה: בדיקת הארגון וההרשאות שהמפתח פותח.

למה אפשר לגשת

  • אנשי קשר ומשפחות
  • תשלומים
  • התחייבויות
  • קבלות לצורכי מס
  • תרומות חוזרות
  • הרשאות SEPA
  • קמפיינים לגיוס כספים
  • טפסים והרשמות
  • אירועים וכרטיסים
  • לוח השנה הקהילתי
  • מכירות עליות
  • דוא״ל, SMS ו-WhatsApp
  • דפי האתר
  • סטטיסטיקות
  • תקציבים ובנק
  • תיירות

כל פעולה מציינת בתיעוד את ההרשאה שהיא דורשת.

שרת MCP

עוזר ה-AI שלכם מחובר ל-Unisoft תוך דקות.

MCP הוא התקן הפתוח שבעזרתו עוזרי AI משתמשים בתוכנות אחרות. שרת ה-MCP של Unisoft נותן להם את הכלים שלו ואת שיטות העבודה הנכונות, כך שהם מטפלים בבקשות שלכם כמו הצוות שלכם.

  1. הפעלה

    מנהל מפעיל את שרת ה-MCP באזור המפתחים.

  2. הוספת הכתובת

    הדביקו את כתובת השרת ב-ChatGPT, Claude, Gemini או Grok כמחבר מותאם אישית.

  3. אישור הגישה

    התחברו ל-Unisoft ובדקו את ההרשאות שהעוזר מבקש.

  4. פשוט לבקש

    "אילו התחייבויות עדיין פתוחות?", "צור את טופס ההרשמה לסדר."

כתובת שרת ה-MCP

https://api.unisoft.world/integrations/mcp

עובד עם

  • ChatGPT
  • Claude
  • Gemini
  • Grok

התחברות

OAuth 2.1 עם PKCE · סוכנים משלכם יכולים להשתמש במפתח API

שיטות עבודה מוכנות לשימוש

העוזר לא מנחש איך Unisoft עובדת: חמישה מדריכים מובנים מסבירים לו כל תחום, את הכללים שלו ואת המלכודות.

  • אנשי קשר

    חיפוש, השלמה, תיקון או ייבוא של רשומות, עם קשרי משפחה, אינטראקציות ומסמכים.

  • כספים

    תרומות, קישורי תשלום, התחייבויות, תרומות חוזרות, קבלות, סטטיסטיקות ודוחות.

  • הרשמות והודעות

    בניית טפסים, מעקב אחר הרשמות ואירועים, הכנת קמפיינים בדוא״ל, ב-SMS וב-WhatsApp.

  • תוכן האתר

    דפים, בלוקים לשימוש חוזר, תפריטים, אלבומי תמונות ותרגומים של האתר.

  • תיירות

    מקומות, מדורים ומפגשי שבת של אתר בית חב״ד לתיירים.

השליטה נשארת אצלכם

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

מחפשים את ה-AI שכבר מובנה ב-Unisoft? הכירו את יוסי

כמה מהאירועים הזמינים
  • paiement.successתשלום התקבל
  • paiement.refundedתשלום הוחזר
  • form.submittedהתקבלה תשובה לטופס
  • contact.createdנוסף אדם חדש
  • fundraising.donation.completedתרומה לקמפיין אושרה
  • fundraising.pledge.updatedהתחייבות עודכנה
  • fundraising.publishedקמפיין פורסם
signed_payload =
  X-Unisoft-Timestamp + "." + raw_body
expected = "sha256=" +
  HMAC_SHA256_HEX(secret, signed_payload)
בדקו את החתימה לפני קריאת ה-JSON

Webhooks

דעו ברגע שזה קורה.

בחרו את האירועים, הזינו כתובת HTTPS, ו-Unisoft שולחת הודעת JSON חתומה לשרת שלכם או לכלי האוטומציה שלכם. אירוע בדיקה מאמת את החיבור לפני ההפעלה.

  • חתימת HMAC SHA-256 על חותמת הזמן ועל הגוף הגולמי.
  • עד שישה ניסיונות במשך כתשע שעות אם השרת שלכם לא עונה.
  • מזהה אירוע כדי להתעלם ממשלוח שכבר טופל.
  • סוד שמוצג פעם אחת בלבד, ואפשר ליצור אותו מחדש.

Make, n8n ו-Zapier

אין אפליקציה ייעודית של Unisoft להתקנה בכלים האלה: משתמשים במודולי ה-HTTP וה-Webhook הרגילים שלהם, שנותנים גישה לכל הפעולות והאירועים המתועדים.

  • MakeHTTP module + custom webhook
  • n8nHTTP Request + Webhook trigger
  • ZapierWebhooks by Zapier

נבנה עבור נתונים של קהילה

פתוח לחיבורים, סגור לכל השאר.

נתוני התורמים והחברים דורשים זהירות. הגישה למפתחים פועלת לפי אותם כללים כמו שאר Unisoft.

ארגון אחד לכל מפתח

מפתח או חיבור AI מגיעים תמיד רק לארגון שיצר אותם.

רק מה שצריך

רק מנהלים פותחים את אזור המפתחים, וכל מפתח או AI מקבלים רק את ההרשאות הנחוצות.

הסכמה אישית

מה ששייך למשתמש נשאר שלו: AI ניגש לכך רק לאחר הסכמה מפורשת שלו.

להמשך הקריאה

שאלות של מפתחים

לא. מנהל מפעיל את שרת ה-MCP באזור המפתחים, ואז מוסיפים את הכתובת שלו כמחבר ב-ChatGPT, Claude, Gemini או Grok ומתחברים ל-Unisoft. שיטות העבודה כבר כלולות. קוד נדרש רק ל-REST API או לסוכנים משלכם.

בגרסה 2 לכל חיבור חדש. גרסה 1 נשארת זמינה כדי שחיבורים קיימים ימשיכו לעבוד. שרת ה-MCP משתמש תמיד בגרסה הנוכחית, באותה כתובת.

רק את מה שמי שחיבר אותו מורשה לעשות, בגבולות ההרשאות שאושרו בהתחברות. פריטים אישיים, כמו ההצעות של משתמש מסוים, דורשים את הסכמתו המפורשת, ומנהל יכול לכבות את שרת ה-MCP בכל עת.

לא אפליקציה ייעודית. הכלים האלה מתחברים דרך המודולים הרגילים שלהם: בקשות HTTP עם מפתח API כדי לפנות ל-Unisoft, וטריגרים של Webhook (custom webhook, Webhooks by Zapier) כדי לקבל את האירועים שלה.

כל משלוח כולל חותמת זמן וחתימת HMAC SHA-256 שמחושבת עם הסוד שלכם. אמתו אותה על הגוף הגולמי לפני קריאת ה-JSON, והשתמשו במזהה האירוע כדי להתעלם מכפילויות: משלוח יכול לחזור או להגיע בסדר אחר.

בכתובת api.unisoft.world/integrations/latest/docs, ציבורי וזמין לקריאה בלי חשבון. הוא קיים גם כקובץ Markdown, כאינדקס llms.txt וכקובץ OpenAPI JSON.

בונים משהו בשביל הקהילה שלכם?

ספרו לנו מה אתם רוצים לחבר. הצוות שלנו יבחן איתכם את הדרך הנכונה: API, Webhooks או MCP.