דלג לתוכן הראשי

על אינטגרציות

אינטגרציות מחברות את Base44 לשאר המערכת שלכם כך שתוכלו לבצע אוטומציה של זרימות עבודה, למשוך נתונים ולקרוא לשירותים חיצוניים מבלי לחבר כל קריאת API בעצמכם. ניתן לבצע אינטגרציה ב-3 רמות:
  • רמת אפליקציה: אינטגרציות בתוך אפליקציה בודדת:
    • אינטגרציות מובנות כגון Invoke LLM ו-SendEmail.
    • מחברים לחיבורים מבוססי OAuth לכלים כמו Notion, Slack או Google Workspace.
    • קריאות API חיצוניות עם פונקציות צד-שרת שמשתמשות ב-Secrets ופונקציות ספציפיים לאפליקציה.
  • רמת אזור עבודה: APIs משותפים מנוהלים פעם אחת לכל אזור העבודה:
    • אינטגרציות OpenAPI מותאמות אישית המבוססות על מפרטי OpenAPI שכל אפליקציה באזור העבודה יכולה לקרוא להן בצורה מאובטחת.
  • רמת חשבון: חיבורים שחיים בחשבון Base44 שלכם:
    • חיבורי MCP שאתם מגדירים פעם אחת כדי שצ’אט הבינה המלאכותית של Base44 יוכל להשתמש בכלים חיצוניים בזמן שאתם בונים, מבלי לשנות את הקוד שנפרס של האפליקציה שלכם.

אינטגרציות ברמת אפליקציה

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

אינטגרציות מובנות

חלק מהאינטגרציות מותקנות מראש ב-Base44 וזמינות לשימוש מיידי. הן לא דורשות תוכנית בתשלום, הגדרה נוספת או מפתחות API נפרדים. עם אינטגרציות הליבה הללו, ניתן להוסיף בינה מלאכותית, מסרים, טיפול בקבצים ולוגיקה מתקדמת לכל אפליקציה ללא הגדרה נוספת. אינטגרציות מובנות של Base44 כוללות:
  • Invoke LLM: צרו תגובות בינה מלאכותית ממודל השפה המובנה באמצעות הודעות מפורטות. תומך בפלטי סכמת JSON, צירופי קבצים להקשר נוסף, ניתוח תמונה וחיפוש באינטרנט למידע מעודכן.
  • SendEmail: שלחו מיילים לאנשים באפליקציית Base44 שלכם עם שמות שולחים הניתנים להתאמה אישית ותוכן HTML עשיר.
    SendEmail לא תומך בשליחה לרשימות תפוצה חיצוניות או בהוספת צירופי קבצים.
  • UploadFile: אפשרו לאנשים להעלות קבצים לאפליקציה שלכם. השתמשו בכתובת ה-URL של הקובץ שמוחזר באינטגרציות או זרימות עבודה אחרות.
  • GenerateImage: צרו תמונות מהודעות טקסט מפורטות. מחזיר URL לתמונה שנוצרה.
  • ExtractDataFromUploadedFile: משכו נתונים מובנים מקבצים שהועלו (CSV, PNG, JPG, JPEG, PDF) באמצעות סכמות JSON. שימושי לייבוא נתונים בכמויות גדולות.
למדו עוד על אינטגרציות מובנות.

מחברים

מחברים הם אינטגרציות מבוססות OAuth שמאפשרות לאפליקציה ספציפית להתחבר לכלים נתמכים. אתם מבקשים מצ’אט הבינה המלאכותית לחבר שירות, מתחברים ומאשרים את ההרשאות המבוקשות. האפליקציה שלכם יכולה אז לקרוא או לכתוב נתונים בכלי הזה בהתאם למה שאתם מאפשרים.
אתם צריכים תוכנית Builder או גבוהה יותר כדי להשתמש במחברים באפליקציה שלכם.
דוגמאות למה שניתן לבנות עם מחברים:
  • סנכרון מסד נתונים של Notion כדי להפעיל תצוגת ידע באפליקציה שלכם.
  • פרסום עדכונים לערוץ Slack.
  • סנכרון רשומות Salesforce או HubSpot ללוח בקרה פנימי.
  • שמירת קבצים מהאפליקציה שלכם ל-Google Drive.
  • חסימת זמן ב-Google Calendar כשהזמנה חדשה מתבצעת.
  • פרסום פוסט ב-LinkedIn כשפוסט בלוג חדש מתפרסם.
  • הצגת סטטיסטיקות פרופיל TikTok וספירות עוקבים בלוח בקרה.

קריאות API חיצוניות עם פונקציות צד-שרת

אינטגרציות חיצוניות באמצעות פונקציות צד-שרת מאפשרות לאפליקציה ספציפית לדבר ישירות עם שירותים של צד שלישי כמו Stripe, Twilio או Google APIs עם פרטי כניסה ספציפיים לאפליקציה. הקריאות הללו מחוברות דרך פונקציות צד-שרת ו-Secrets משלכם.
חיבור אינטגרציה לאפליקציה שלכם באמצעות צ'אט הבינה המלאכותית
השתמשו בפונקציות צד-שרת כאשר:
  • אתם רוצים אינטגרציה חד-פעמית עבור אפליקציה בודדת.
  • אתם צריכים לוגיקה מותאמת אישית שמשולבת באופן הדוק עם האפליקציה הזו.
  • השירות עדיין לא מוגדר כאינטגרציית OpenAPI מותאמת אישית באזור העבודה שלכם.
דוגמאות לאינטגרציות חיצוניות עם פונקציות צד-שרת:
  • שליחת מיילי ברוכים הבאים לאנשים חדשים שמשתמשים באפליקציה שלכם דרך ספק המייל שלכם.
  • סנכרון ה-CRM הקיים שלכם עם מסד הנתונים של האפליקציה.
  • התראה לצוות שלכם ב-Slack כשמישהו שולח טופס.
  • יצירת תוכן עם כלי בינה מלאכותית באמצעות מפתחות הספק שלכם.
  • קריאה ל-APIs ספציפיים של ספקים שאין להם עדיין מחבר או אינטגרציית OpenAPI מותאמת אישית.
חשוב: אתם צריכים תוכנית Builder או גבוהה יותר כדי להשתמש בפונקציות צד-שרת.
כשאתם מבקשים אינטגרציה בצ’אט הבינה המלאכותית, Base44 מנחה אתכם שלב אחר שלב ומבקשת פרטי כניסה או הרשאה כשצריך. היא לאחר מכן מחברת את לוגיקת צד-השרת וצד-הלקוח אוטומטית כך שתוכלו להתחיל לפעול במהירות. אתם מאחסנים פרטי כניסה כ-Secrets בלוח הבקרה של האפליקציה ומשתמשים בהם בפונקציות TypeScript תחת Dashboard → Code → Functions.
לכל פונקציית צד-שרת יש קובץ קוד שניתן לערוך, לצפות בו ולבדוק. ניתן גם לבדוק לוגים לכל פונקציה מ-Dashboard → Code → Functions.

אינטגרציות ברמת אזור עבודה

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

אינטגרציות OpenAPI מותאמות אישית

אינטגרציות OpenAPI מותאמות אישית מאפשרות לכם לרשום APIs חיצוניים משותפים ברמת אזור העבודה ממפרט OpenAPI. אתם מייבאים מפרט פעם אחת, בוחרים את הפעולות שאתם רוצים לחשוף, וכל אפליקציה באזור העבודה הזה יכולה לקרוא לפעולות הללו דרך ה-SDK. ה-AI builder וקוד צד-הלקוח שלכם יכולים לקרוא לאינטגרציות OpenAPI מותאמות אישית ישירות דרך base44.integrations.custom מבלי לחשוף פרטי כניסה. הקריאות מועברות דרך הצד-שרת של Base44, כך שסודות לעולם לא מגיעים לדפדפן. זה אידיאלי ל-APIs פנימיים ו-APIs של שותפים שהצוות שלכם משתמש בהם בהרבה אפליקציות.
חשוב:
  • רק בעלי אזור עבודה ומנהלים בתוכנית Builder ומעלה יכולים ליצור או לערוך אינטגרציות OpenAPI מותאמות אישית.
  • כל אחד באזור העבודה יכול להשתמש באינטגרציית OpenAPI מותאמת אישית קיימת באפליקציות שלהם, אפילו בתוכנית חינמית.
למדו כיצד להגדיר את ה-APIs האלה בפירוט ב-ניהול אינטגרציות API מותאמות אישית.

חיבורים ברמת חשבון

חיבורים ברמת חשבון מוגדרים פעם אחת לחשבון Base44 שלכם וזמינים בכל מקום שאתם משתמשים בצ’אט הבינה המלאכותית של Base44.

חיבורי MCP

חיבורי MCP מאפשרים לכם לחבר שרתי MCP מותאמים אישית לחשבון Base44 שלכם כך שצ’אט הבינה המלאכותית יוכל להשתמש בכלים ונתונים חיצוניים כהקשר בזמן שאתם בונים. זה נותן לכם צ’אט builder מודע להקשר מבלי לשנות את ה-runtime שנפרס של האפליקציה שלכם.
חשוב:
  • חיבורי MCP זמינים בתוכנית Builder ומעלה.
  • שרתי MCP מוגדרים פעם אחת לחשבון תחת Account Settings → MCP Connections.
  • צ’אט הבינה המלאכותית קורא לשרת MCP רק כאשר ההודעה שלכם דורשת זאת (לדוגמה, כשאתם מזכירים את השרת הזה או מבקשים נתונים שהוא מספק). הוא לא יוצר קשר עם כל שרת MCP לכל הודעה.
דוגמאות למה שניתן לעשות עם חיבורי MCP:
  • בקשו מצ’אט הבינה המלאכותית לחפש ב-MCP של מסמכים פנימי ולסכם את הדפים הרלוונטיים ביותר עבור תכונה.
  • חברו שרת MCP של GitHub ובקשו סיכום של issues פתוחים ב-repo מסוים.
  • חברו MCP של אנליטיקה, כגון Amplitude או שירות מטריקות מותאם אישית, ובקשו מהצ’אט למשוך מטריקות מוצר עדכניות לשיחה בזמן שאתם מתכננים שינויים.
למדו כיצד להוסיף ולנהל שרתי MCP ב-הגדרת MCP מותאם אישית.

קבלת מפתחות ה-API שלכם

חלק מהאינטגרציות דורשות מפתח API, שמתפקד כסיסמה פרטית בין Base44 לשירות החיצוני. מפתח ה-API שלכם מוכיח בעלות ושומר על החיבור שלכם מאובטח. Base44 מאחסנת את המפתח שלכם בבטחה כך שהאפליקציה שלכם תוכל להשתמש בו מבלי לחשוף אותו.
לעולם אל תשתפו את מפתח ה-API שלכם בפומבי. התייחסו אליו כמו לסיסמה.
כדי לקבל את מפתח ה-API שלכם:
  1. התחברו לשירות החיצוני (לדוגמה, OpenAI, Resend, Notion).
  2. מצאו את האזור Developer, API, או Integrations.
  3. לחצו על Create API Key או Generate Token והעתיקו אותו.
  4. הדביקו את מפתח ה-API שלכם ב-Base44:
    • באמצעות צ’אט הבינה המלאכותית: הזינו את מפתח ה-API שלכם בצ’אט הבינה המלאכותית כשתתבקשו.
      הוספת מפתח ה-API שלכם בצ'אט הבינה המלאכותית ב-Base44
    • הגדרה ידנית: שמרו את מפתח ה-API שלכם ב-Secrets.
      a. לחצו על Dashboard בעורך האפליקציה שלכם.
      b. לחצו על Secrets.
      c. לחצו על Add Secret.
    הוספת סודות בלוח הבקרה של האפליקציה ב-Base44
אינטגרציות OpenAPI מותאמות אישית גם משתמשות בסודות, אך אלה מוגדרים פעם אחת על ידי מנהל אזור עבודה בעת יצירה או עריכה של האינטגרציה ומאוחסנים כסודות אזור עבודה מוצפנים, לא כ-Secrets ספציפיים לאפליקציה.

שאלות נפוצות

לחצו על שאלה למטה כדי ללמוד עוד על שימוש באינטגרציות.
אינטגרציות OpenAPI מותאמות אישית מוגדרות פעם אחת באזור עבודה ממפרט OpenAPI וזמינות לכל אפליקציה באזור העבודה דרך base44.integrations.custom.call(). פרטי הכניסה מאוחסנים כסודות אזור עבודה מוצפנים ולעולם לא נחשפים לקוד האפליקציה, ואין צורך בפונקציות צד-שרת כדי להשתמש בהן.APIs חיצוניים ברמת אפליקציה משתמשים בפונקציות צד-שרת ו-Secrets באפליקציה ספציפית. הם אידיאליים ללוגיקה ספציפית לאפליקציה או כאשר אינכם רוצים לשתף API בכל האפליקציות באזור עבודה.
לפני פרסום האפליקציה שלכם, בדקו את האינטגרציה כדי שתוכלו לזהות בעיות מוקדם:
  1. השתמשו במצב sandbox או test (לדוגמה, מפתחות בדיקה של Stripe), אם הספק מציע זאת.
  2. נסו זרימות אמיתיות ומקרי קצה, לא רק נתיב אחד מוצלח.
  3. בדקו שהקלטים והפלטים תואמים את הציפיות שלכם בממשק ובלוח הבקרה של הספק.
  4. עקבו אחר השימוש בקרדיט אינטגרציה גם ב-Base44 וגם בשירות החיצוני.
  5. הציגו תצוגה מקדימה של האפליקציה כדי לזהות טעינה איטית, קריאות API שנכשלו או נתונים חסרים לפני העלייה לאוויר.
אם נתקלתם בבעיות, בדקו את הבאים:
  • אזור העבודה שלכם בתוכנית Builder ומעלה (עבור APIs חיצוניים ברמת אפליקציה שמשתמשים בפונקציות צד-שרת).
  • מפתח ה-API שלכם נכון ושמור ב-Secrets או באינטגרציית OpenAPI מותאמת אישית, אם רלוונטי.
  • יש לכם מספיק קרדיטים פעילים בשירות החיצוני.
  • אתם משתמשים בפרטי כניסה חיים, לא בבדיקה, בעת בדיקת זרימות פרודקשן.
  • בקשת ה-API שלכם כוללת את ה-endpoint, ה-payload והפרמטרים הנכונים.
  • לא חרגתם ממגבלות הקצב של השירות.
פונקציות צד-שרת ו-APIs חיצוניים ברמת אפליקציה דורשים תוכנית Builder או גבוהה יותר באזור העבודה שבו האפליקציה נוצרה. אם אזור העבודה בתוכנית חינמית או Starter, פונקציות צד-שרת ואינטגרציות שתלויות בהן אינן זמינות.בעלי אזור עבודה ומנהלים יכולים ליצור פונקציות צד-שרת באפליקציות שבבעלותם. שותפים עם תפקיד Editor יכולים גם לערוך וליצור פונקציות צד-שרת באפליקציה כל עוד באזור העבודה יש תוכנית Builder ומעלה.
אם אתם רואים שגיאת 403 בעת שימוש בפונקציות צד-שרת, זה עשוי להיות שפונקציות צד-שרת אינן זמינות לאפליקציה או לאזור העבודה שלכם, או שבבקשה חסרות הרשאות.סיבות נפוצות ופתרונות:
  • דרישת תוכנית: פונקציות צד-שרת זמינות רק בתוכנית Builder ומעלה. אם אזור העבודה בתוכנית חינמית או Starter, קריאות צד-שרת ואינטגרציות ברמת אפליקציה שמסתמכות עליהן יכולות להיכשל עם 403.
  • הרשאות בפונקציה שלכם: פונקציית צד-השרת שלכם עשויה לדחות את הבקשה כי האדם לא מחובר או אין לו תפקיד מתאים. בדקו בדיקות תפקיד או גישה כלשהן שהוספתם בקוד הפונקציה.
  • הרשאות שירות חיצוני: 403 יכול להגיע גם מה-API החיצוני שאתם קוראים אליו. ודאו שלמפתח ה-API יש את ההיקפים הנכונים ושהבקשה משתמשת ב-endpoint ובמתודה הנכונים.
  • עדיין מתקשים: ראו את מאמר פתרון בעיות או צרו קשר עם תמיכת Base44.
יש 2 סוגי מפתחות API שאתם עשויים להזדקק ליצור מחדש או לעדכן:
  • מפתחות שירות צד שלישי: צרו מחדש את המפתח שלכם בפורטל המפתחים של אותו שירות, לדוגמה OpenAI, Resend, Notion, ואז עדכנו אותו ב-Dashboard → Secrets או בהגדרות אינטגרציית OpenAPI מותאמת אישית שלכם.
  • מפתח API של חשבון Base44 שלכם:
    1. לחצו על אייקון הפרופיל שלכם בפינה הימנית העליונה של החשבון שלכם.
    2. לחצו על Account settings.
    3. לחצו על Regenerate ליד API Key.
לאחר היצירה מחדש, מפתח ה-API של Base44 שלכם מתעדכן בכל אפליקציות Base44 שלכם אוטומטית. אם הוספתם את מפתח Base44 שלכם בשירות אחר, עדכנו אותו שם גם.
  • אינטגרציות מובנות נשארות זמינות.
  • מחברים, אינטגרציות OpenAPI מותאמות אישית, חיבורי MCP, ו-APIs חיצוניים ברמת אפליקציה שמסתמכים על פונקציות צד-שרת עשויים להפסיק לעבוד עד שתשדרגו לתוכנית Builder או גבוהה יותר.
כן. ניתן לערבב אינטגרציות מובנות, מחברים, אינטגרציות OpenAPI מותאמות אישית, ו-APIs חיצוניים ברמת אפליקציה באותה אפליקציה, כל עוד התוכנית וההגדרות שלכם תומכות בהם.
מטעמי אבטחה, שירותים חיצוניים כמו Stripe, OpenAI או Notion לא מאפשרים לצדדים שלישיים, כולל Base44, לגשת לפרטי הכניסה שלכם אוטומטית. במקום זאת, אתם צריכים:
  1. להתחבר לשירות.
  2. לעבור לאזור ה-API או המפתחים.
  3. ליצור את המפתח שלכם.
  4. להדביק אותו ב-Base44 כ-Secret או כותרת אזור עבודה.
לאחר ההוספה, האפליקציה או אינטגרציית OpenAPI המותאמת אישית שלכם יכולה להשתמש במפתח הזה מאחורי הקלעים בבטחה וללא קוד.
למה זה חשוב: מפתחות API פועלים כמו סיסמאות לשירותים. שמירתם פרטיים ותחת השליטה שלכם שומרת על הנתונים שלכם בטוחים ומבטיחה שרק אתם מאשרים גישה.
לא. חיבורי MCP הם רק עבור צ’אט הבינה המלאכותית של Base44 בזמן שאתם בונים. הם מוגדרים ברמת החשבון תחת Settings → MCP Connections ומשמשים רק כאשר ההודעה שלכם דורשת את שרת ה-MCP הזה. האפליקציה הפרוסה שלכם לא קוראת לשרתי MCP דרך דף ההגדרות הזה.
עדיין צריכים עזרה? הצטרפו לDiscord שלנו וקבלו תמיכה בזמן אמת מצוות Base44 והקהילה.
דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.