דלג לתוכן הראשי
הוסיפו מחברי משתמשי אפליקציה כדי לאפשר לכל אדם שמשתמש באפליקציה שלכם לחבר חשבון משלו לשירות צד שלישי, כגון Google, Slack או Notion. מחברי משתמשי אפליקציה מוספים ברמת אזור העבודה וניתן להשתמש בהם במספר אפליקציות באותו אזור עבודה. ניתן להוסיף אותם מהגדרות אזור העבודה או ישירות מצ’אט הבינה המלאכותית באפליקציה ספציפית.
Available connectors for app users

אפליקציית תזמון

אפשרו לכל אדם לחבר Google Calendar משלו כדי לצפות בזמינות או ליצור אירועים.

אפליקציית מכירות

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

אפליקציית תכנון תוכן

אפשרו לכל חבר צוות לחבר חשבון Notion משלו כדי לסנכרן דפים או משימות.

לפני שמתחילים

צרו אפליקציית OAuth בפלטפורמת המפתחים של השירות שאתם רוצים לחבר לפני הוספת המחבר ב-Base44. ראו הכנת פרטי מחבר.
אתם צריכים תוכנית Builder או גבוהה יותר כדי להוסיף מחברי משתמשי אפליקציה.

הכנת פרטי מחבר

לפני הוספת המחבר ב-Base44, הכינו את הפרטים הנדרשים על ידי השירות שאתם רוצים לחבר. בדרך כלל זה אומר ליצור אפליקציית OAuth או פרויקט בפלטפורמת המפתחים של אותו שירות, להוסיף את כתובת ה-redirect URI של Base44, ולהעתיק את הפרטים שאתם צריכים ל-Base44. ההגדרה המדויקת תלויה בשירות. לדוגמה, Google משתמשת ב-Google Cloud, Slack משתמשת ב-Slack API Applications, ו-LinkedIn משתמשת ב-פורטל המפתחים של LinkedIn.

סקירת הגדרה

  1. הכינו את ה-redirect URI של Base44: השתמשו ב-URL ה-callback עבור האפליקציה החיה, הדומיין המותאם אישית או התצוגה המקדימה שלכם. ראו את הפורמטים למטה.
  2. צרו אפליקציית OAuth: עשו זאת בפלטפורמת המפתחים של שירות הצד השלישי.
  3. הוסיפו את ה-redirect URI: הדביקו את ה-redirect URI של Base44 בהגדרות אפליקציית OAuth.
  4. הכינו את פרטי המחבר: העתיקו את ה-Client ID וה-Client Secret, ואז בחרו את ה-scopes שהאפליקציה שלכם צריכה.
  5. הוסיפו את המחבר ב-Base44: הדביקו את הפרטים בטופס הגדרת המחבר.

פורמטי redirect URI

  • URL אפליקציה חיה: https://your-live-app-domain.base44.app/api/external-auth/callback
  • דומיין מותאם אישית: https://your-custom-domain.com/api/external-auth/callback
  • URL תצוגה מקדימה: https://preview--your-live-app-domain.base44.app/api/external-auth/callback
  • חלק מהשירותים קוראים ל-redirect URI callback URL או authorized redirect URI.
  • הזינו את ה-redirect URI בדיוק כפי שמוצג.
  • הוסיפו את ה-redirect URI של התצוגה המקדימה אם אתם רוצים לבדוק את המחבר בתצוגה מקדימה.
  • חלק מהשירותים מציגים את ה-Client Secret רק פעם אחת. העתיקו אותו לפני סגירת הדף.
התייחסו ל-Client Secrets כמו לסיסמאות. אל תשתפו אותם עם אחרים. העתיקו אותם רק לצ’אט הבינה המלאכותית כשהוא מבקש אותם במפורש כחלק מזרימת הגדרת המחבר המאובטחת.

הוספת מחבר ב-Base44

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

הוספת המחבר מאזור העבודה שלכם

הוסיפו את המחבר מהגדרות אזור העבודה שלכם והזינו את הפרטים הנדרשים. כדי להוסיף מחבר מאזור העבודה שלכם:
  1. לחצו על אייקון הפרופיל שלכם.
  2. לחצו על Account settings.
  3. לחצו על Connectors.
  4. תחת Connectors For App Users, לחצו על Add Connector.
  5. לחצו על המחבר שאתם רוצים להוסיף.
  6. הזינו את הבאים:
    • Connector name: הזינו שם קצר לזיהוי המחבר הזה, לדוגמה Google Calendar scheduling.
    • Client ID: הזינו את ה-Client ID מאפליקציית ה-OAuth שיצרתם בשירות המחובר.
    • Client Secret: הזינו את ה-Client Secret מאותה אפליקציית OAuth.
    • Scopes: הזינו את ההיקפים שהאפליקציה שלכם צריכה, כאשר כל היקף בשורה נפרדת.
  7. לחצו על Add Connector.
Add LinkedIn Connection window showing fields for connector name, Client ID, Client Secret, and scopes.

הוספת המחבר באמצעות צ’אט הבינה המלאכותית

ניתן גם להתחיל מצ’אט הבינה המלאכותית באפליקציה שבה אתם רוצים להשתמש במחבר. כדי להוסיף מחבר מצ’אט הבינה המלאכותית:
  1. פתחו את האפליקציה שבה אתם רוצים להשתמש במחבר.
  2. בקשו מצ’אט הבינה המלאכותית להוסיף תכונה שבה כל אדם מחבר חשבון משלו.
  3. אם המחבר כבר מוגדר באזור העבודה שלכם, צ’אט הבינה המלאכותית יכול להשתמש בו ישירות באפליקציה.
  4. אם המחבר עדיין לא מוגדר, הזינו את פרטי המחבר, כולל Connector name, Client ID, Client Secret ו-Scopes.
  5. לחצו על Connect.
AI chat prompting for connector details, including connector name, Client ID, Client Secret, and scopes.

שימוש במחבר באפליקציה שלכם

לאחר שהמחבר מוגדר, בקשו מצ’אט הבינה המלאכותית באפליקציה שאתם רוצים להשתמש בה לבנות תכונה עם המחבר הזה.
Settings page in an app showing a LinkedIn Connection section with a Connect LinkedIn button.

ניהול מחברים למשתמשי אפליקציה

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

עריכת מחבר משתמש אפליקציה

ערכו מחבר משתמש אפליקציה כדי לעדכן את שמו, Client ID, Client Secret או היקפים.
אם אתם משנים את ההיקפים, אנשים שכבר חיברו את חשבונם צריכים להתחבר שוב מתוך האפליקציה שלכם ולאשר את ההרשאות המעודכנות.
כדי לערוך מחבר משתמש אפליקציה:
  1. לחצו על אייקון הפרופיל שלכם.
  2. לחצו על Account settings.
  3. לחצו על Connectors.
  4. תחת Connectors For App Users, רחפו מעל המחבר ולחצו על View.
  5. רחפו מעל שם החיבור ולחצו על Edit.
  6. עדכנו את השדות.
  7. לחצו על Save Changes.

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

בצעו רוטציה לפרטי כניסה אם השירות המחובר מבקש מכם לעדכן את פרטי הכניסה של אפליקציית OAuth, או אם אתם צריכים להחליף את ה-Client Secret שמשמש את מחבר משתמש האפליקציה.
  • חיבורים קיימים ממשיכים לעבוד עד ש-token הגישה שלהם פג. אם אתם מבטלים את ה-Client Secret הקודם בשירות המחובר, אנשים עשויים להתבקש לחבר את חשבונם שוב מתוך האפליקציה שלכם כשהחיבור שלהם צריך להתרענן.
  • שלבי רוטציית פרטי הכניסה המדויקים תלויים בשירות המחובר. חלק מהשירותים קוראים לזה רוטציה, יצירה מחדש או ביטול של Client Secret.
כדי לבצע רוטציה לפרטי כניסה עבור מחבר משתמש אפליקציה:
  1. עברו לחשבון המפתחים של השירות הרלוונטי, כגון Google, Slack, Notion או שירות מחובר אחר.
  2. מצאו את אפליקציית ה-OAuth שיצרתם עבור מחבר Base44.
  3. פתחו את הגדרות ה-OAuth או האפליקציה.
  4. בטלו, בצעו רוטציה או צרו Client Secret חדש עבור אפליקציית ה-OAuth.
  5. ב-Base44, לחצו על אייקון הפרופיל שלכם.
  6. לחצו על Account settings.
  7. לחצו על Connectors.
  8. תחת Connectors For App Users, רחפו מעל המחבר ולחצו על View.
  9. רחפו מעל שם החיבור ולחצו על Edit.
  10. עדכנו את שדה Client Secret.
  11. לחצו על Save Changes.
חזרו על תהליך זה עבור כל מחבר משתמש אפליקציה שצריך רוטציה.

מחיקת מחבר משתמש אפליקציה

מחקו מחבר משתמש אפליקציה אם אתם לא רוצים יותר שהוא יהיה זמין במספר אפליקציות באזור העבודה שלכם.
מחיקת מחבר מסירה אותו מהאפליקציות שלכם עבור כל מי שהשתמש בו. לא ניתן לבטל זאת.
כדי למחוק מחבר משתמש אפליקציה:
  1. לחצו על אייקון הפרופיל שלכם.
  2. לחצו על Account settings.
  3. לחצו על Connectors.
  4. תחת Connectors For App Users, רחפו מעל המחבר ולחצו על View.
  5. רחפו מעל שם החיבור ולחצו על Edit.
  6. לחצו על Delete Connector.
  7. לחצו על Delete Connector שוב כדי לאשר.
Edit connector window showing the connector name, Client ID, Client Secret, scopes, and options to save changes or delete the connector.

פתרון בעיות

לחצו על נושא למטה כדי לפתור בעיות הגדרת מחבר משתמש אפליקציה.
בדרך כלל זה אומר שה-redirect URI בשירות המחובר לא תואם בדיוק את ה-callback URL של Base44 שלכם.כדי לתקן אי התאמת redirect URI:
  1. פתחו את אפליקציית ה-OAuth בשירות המחובר.
  2. עברו להגדרות redirect URI, callback URL או authorized redirect URI.
  3. בדקו שה-URL תואם בדיוק את ה-callback URL של Base44 שלכם.
  4. בדקו האם האפליקציה שלכם משתמשת בדומיין מותאם אישית.
  5. בדקו האם אתם בודקים בתצוגה מקדימה.
  6. הוסיפו את ה-callback URL הנכון של אפליקציה חיה, תצוגה מקדימה או דומיין מותאם אישית.
  7. שמרו את הגדרות אפליקציית ה-OAuth.
  8. נסו להתחבר שוב מהאפליקציה שלכם.
בדרך כלל זה אומר שה-redirect URI של תצוגה מקדימה חסר בשירות המחובר.כדי לתקן בעיות חיבור תצוגה מקדימה:
  1. פתחו את אפליקציית ה-OAuth בשירות המחובר.
  2. עברו להגדרות redirect URI, callback URL או authorized redirect URI.
  3. הוסיפו את ה-redirect URI של תצוגה מקדימה עבור האפליקציה שלכם.
  4. שמרו את הגדרות אפליקציית ה-OAuth.
  5. פתחו את התצוגה המקדימה של האפליקציה שלכם.
  6. התחברו כמי שמשתמש באפליקציה.
  7. נסו להתחבר שוב.
בדרך כלל זה אומר שה-Client ID או Client Secret חסרים, שגויים או הועתקו מאפליקציית OAuth שגויה.כדי לתקן Client ID או Client Secret לא חוקיים:
  1. פתחו את אפליקציית ה-OAuth בשירות המחובר.
  2. העתיקו את ה-Client ID שוב.
  3. העתיקו את ה-Client Secret שוב.
  4. חזרו ל-Base44.
  5. ערכו את המחבר.
  6. הדביקו את הערכים המעודכנים.
  7. לחצו על Save Changes.
בדרך כלל זה אומר שהאפליקציה שלכם ביקשה הרשאה שחסרה, לא זמינה או כתובה בפורמט שגוי.כדי לתקן שגיאת היקף:
  1. בדקו את תיעוד ה-OAuth של השירות המחובר.
  2. אשרו אילו היקפים האפליקציה שלכם צריכה.
  3. העתיקו את ההיקפים בדיוק כפי שמוצגים בתיעוד השירות.
  4. הוסיפו כל היקף בשורה נפרדת ב-Base44.
  5. שמרו את המחבר.
  6. בקשו מאנשים שכבר התחברו להתחבר שוב מתוך האפליקציה ולאשר את ההרשאות המעודכנות.
חלק מהשירותים שומרים אפליקציות OAuth חדשות במצב בדיקה עד שאתם מפרסמים או מאמתים אותן. ייתכן שאנשים לא יוכלו להתחבר אלא אם הם נוספו כמשתמשי בדיקה.כדי לתקן בעיות מצב בדיקה:
  1. פתחו את אפליקציית ה-OAuth בשירות המחובר.
  2. בדקו האם האפליקציה במצב בדיקה, פיתוח או לא פורסמה.
  3. הוסיפו משתמשי בדיקה אם השירות דורש זאת.
  4. פרסמו או אמתו את אפליקציית ה-OAuth במידת הצורך.
  5. נסו להתחבר שוב מהאפליקציה שלכם.

שאלות נפוצות

מחברי משתמש מאפשרים לכל אדם לחבר חשבון משלו. מחברים משותפים משתמשים בחשבון אחד עבור כולם באפליקציה.
השירות המחובר צריך לדעת איזו אפליקציה מבקשת גישה. אפליקציית OAuth נותנת לכם את ה-Client ID, Client Secret, היקפים והגדרות redirect URI שצריך לחיבור.
אתם מוצאים אותם באפליקציית ה-OAuth או אפליקציית המפתחים שאתם יוצרים בשירות המחובר. המיקום המדויק תלוי בשירות.
היקפים הם הרשאות. הם אומרים לשירות המחובר למה האפליקציה שלכם יכולה לגשת לאחר שמישהו מחבר את חשבונו.
השתמשו ב-redirect URI עבור הסביבה שאתם רוצים לחבר. עבור אפליקציות חיות, השתמשו ב-callback URL של אפליקציה חיה. לבדיקת תצוגה מקדימה, הוסיפו את ה-callback URL של תצוגה מקדימה. עבור דומיינים מותאמים אישית, הוסיפו את ה-callback URL של דומיין מותאם אישית.
כן, אם אתם רוצים לבדוק את המחבר בתצוגה מקדימה. תצוגה מקדימה ואפליקציות חיות משתמשות ב-redirect URIs שונים.
אם המחבר כבר מוגדר באזור העבודה שלכם, צ’אט הבינה המלאכותית יכול להשתמש בו ישירות באפליקציה מבלי לבקש מכם להזין את פרטי המחבר שוב.
חלק מהכלים ניתנים לחיבור ב-2 דרכים, לכן צ’אט הבינה המלאכותית עשוי לאשר את הסוג שאתם רוצים להוסיף.
  • משותף: בחרו זאת אם אתם רוצים שחשבון אחד יפעיל את התכונה עבור כולם באפליקציה.
  • לכל משתמש: בחרו זאת אם כל אדם צריך לחבר חשבון משלו.
כן. ניתן להוסיף מספר מחברים עם היקפים שונים עבור מקרי שימוש שונים.
אנשים שכבר חיברו את חשבונם צריכים להתחבר שוב מתוך האפליקציה שלכם ולאשר את ההרשאות המעודכנות.
עדכון ה-Client Secret ב-Base44 לא מנתק אוטומטית אנשים שכבר חיברו את חשבונם. אם אתם מבטלים את ה-Client Secret הקודם בשירות המחובר, אנשים עשויים להתבקש לחבר את חשבונם שוב מתוך האפליקציה שלכם כשהחיבור שלהם צריך להתרענן.
הם צריכים לחבר את חשבונם שוב מתוך האפליקציה שלכם. אפשרות החיבור מופיעה בכל מקום שהאפליקציה שלכם נבנתה לתמוך במחבר הזה, כגון דף הגדרות, זרימת onboarding, דף חשבון או התכונה שמשתמשת במחבר.
כן. אנשים יכולים להתנתק בכל עת מתוך האפליקציה.
כן. Base44 מצפינה פרטי כניסה רגישים וטוקני גישה ומטפלת ברענון אוטומטי של טוקנים.
דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.