> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# יצירת Connectors

> Connectors הם אינטגרציות OAuth שמאפשרות לאפליקציית Base44 שלך להתחבר לשירותים חיצוניים כמו Google Calendar, Slack, Notion ועוד. לאחר החיבור, ניתן להשתמש ב-access tokens בפונקציות backend...

<Warning>
  דף זה הוא חלק ממיומנות של סוכן קידוד AI ונכתב לסוכנים, לא לבני אדם. לתיעוד Base44 הקריא לבני אדם, ראה את [תיעוד המפתחים](/developers).
</Warning>

# Creating Connectors

Connectors הם אינטגרציות OAuth שמאפשרות לאפליקציית Base44 שלך להתחבר לשירותים חיצוניים כמו Google Calendar, Slack, Notion ועוד. לאחר החיבור, ניתן להשתמש ב-access tokens בפונקציות backend כדי לקרוא ל-APIs חיצוניים ישירות.

## מושגי מפתח

* **גישה ישירה ל-API**: Connectors מספקים raw OAuth access tokens - אתה קורא ל-APIs החיצוניים ישירות מפונקציות backend
* **חשבון של בונה האפליקציה**: מחבר את החשבון שלך (בונה האפליקציה), לא את חשבונות משתמשי הקצה שלך
* **פונקציות Backend בלבד**: Tokens נגישים רק בצד השרת לצורכי אבטחה

## מיקום קבצים

צור קבצי connector בתיקיית `base44/connectors/` (או בתיקייה שצוינה על ידי `connectorsDir` ב-config.jsonc שלך).

**מתן שם לקבצים:** `{type}.jsonc` או `{type}.json`

דוגמאות:

* `base44/connectors/googlecalendar.jsonc`
* `base44/connectors/slack.jsonc`
* `base44/connectors/notion.json`

## סכמה

כל קובץ connector חייב לציין `type` ואופציונלית רשימה של `scopes`:

```jsonc theme={null}
{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}
```

### שדות

| שדה      | סוג       | נדרש | תיאור                                                                      |
| -------- | --------- | ---- | -------------------------------------------------------------------------- |
| `type`   | string    | כן   | סוג האינטגרציה (הרץ `npx base44 connectors list-available` לראות אפשרויות) |
| `scopes` | string\[] | לא   | OAuth scopes לבקש (ברירת מחדל `[]`)                                        |

## גילוי סוגי Connector זמינים

הרץ את הפקודה הבאה כדי לקבל את הרשימה המעודכנת של סוגי connectors נתמכים. הערה: `stripe` הוא גם סוג תקף אך לא מוחזר על ידי פקודה זו — התייחס אליו כנתמך (ראה דוגמת Stripe למטה).

```bash theme={null}
npx base44 connectors list-available
```

זה מחזיר אובייקט JSON עם כל האינטגרציות הזמינות, שמות התצוגה שלהן, תיאורים ושדות תצורת חיבור נדרשים. פלט לדוגמה (מקוצר):

```json theme={null}
{
    "integrations": [
        {
            "integration_type": "googlecalendar",
            "display_name": "Google Calendar",
            "description": "Access and manage Google Calendar events",
            "connection_config_fields": []
        },
        {
            "integration_type": "slack",
            "display_name": "Slack User",
            "description": "Send messages and interact with Slack as yourself (user integration)",
            "connection_config_fields": []
        },
        {
            "integration_type": "share_point",
            "display_name": "SharePoint",
            "description": "Manage documents, lists, sites, and collaboration content in SharePoint",
            "connection_config_fields": [
                {
                    "name": "subdomain",
                    "display_name": "SharePoint Site",
                    "description": "The name of your SharePoint site (e.g., sites/mysite)",
                    "placeholder": "sites/mysite",
                    "required": true,
                    "validation_pattern": "^[a-zA-Z0-9/_-]+$",
                    "validation_error": "Please enter a valid SharePoint site path"
                }
            ]
        }
    ]
}
```

השתמש בערך `integration_type` מפלט זה כשדה `type` בקובץ ה-connector שלך. חלק מה-connectors דורשים `connection_config_fields` נוספים — בדוק את הפלט לפרטים.

### Stripe (Sandbox)

```jsonc theme={null}
// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}
```

הערה: Stripe אינו דורש זרימת OAuth בדפדפן. כאשר אתה דוחף connector זה, Base44 מקצה אוטומטית חשבון sandbox של Stripe בצד השרת. ייתכן שתקבל URL claim בפלט הדחיפה כדי לקשר את ה-sandbox לחשבון Stripe שלך.

## כללים ומגבלות

1. **connector אחד לכל סוג**: לא ניתן להחזיק מספר connectors מאותו סוג (למשל, שני `googlecalendar` connectors)

2. **סוג חייב להיות תקף**: שדה ה-`type` חייב להיות סוג אינטגרציה תקף (הרץ `npx base44 connectors list-available` לראות סוגים זמינים)

3. **Scopes ספציפיים לספק**: לכל שירות יש פורמט scope משלו - עיין בתיעוד של הספק

## שלבים הבאים

לאחר יצירת קבצי connector, דחוף אותם ל-Base44:

```bash theme={null}
npx base44 connectors push
```

זה יבקש ממך לאשר כל OAuth connector חדש בדפדפן שלך. Stripe הוא החריג — הוא מוקצה אוטומטית ללא זרימת דפדפן. ראה [connectors-push.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-push.md) לפרטים.

כדי למשוך connectors קיימים מ-Base44 לקבצים מקומיים:

```bash theme={null}
npx base44 connectors pull
```

ראה [connectors-pull.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-pull.md) לפרטים.

<Note>דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](/). </Note>