> ## 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.

# חיבור Outlook לאפליקציה שלך

> שלח וקרא אימיילים ונהל אירועי יומן מהאפליקציה שלך, עם חשבון משותף או עם החשבון האישי של כל אדם.

חבר את האפליקציה שלך ל-Outlook כדי לשלוח ולקרוא אימיילים, לנהל אירועי יומן ולהפעיל Workflows כשאימייל או אירוע משתנים. השתמש בחשבון משותף אחד לכל האפליקציה, או אפשר לכל אדם לחבר את חשבון ה-Microsoft שלו.

> [!NOTE]
>
> כדי להשתמש במחברים באפליקציה, צריך [מסלול Builder](https://base44.com/pricing) ומעלה.

***

## מה אפשר לעשות

שלב את הדואר והיומן שלך ב-Outlook ב-Workflows של האפליקציה.

> [card] שליחת אימייל
>
> שלח אימייל מחשבון ה-Outlook שלך כשמשהו קורה באפליקציה, למשל כשמתקבלת הזמנה חדשה.

> [card] קריאה וארגון של אימיילים
>
> קרא הודעות אחרונות, סכם אותן, והעבר או עדכן אותן מהאפליקציה.

> [card] ניהול היומן שלך
>
> הצג את אירועי ה-Outlook שלך באפליקציה, וצור או עדכן אירועים כשמשהו נקבע.

> [card] [הפעלת Workflows](https://docs.base44.com/he/Building-your-app/Creating-workflows.md#connector)
>
> הפעל Workflow כשמגיע אימייל לתיבת הדואר או כשנוצר אירוע ביומן, או כשאחד מהם מתעדכן או נמחק.

**הנחיות לדוגמה**

תאר בצ'אט ה-AI את תיבת הדואר או היומן, מה מפעיל את הפעולה וכל שדה דינמי. לדוגמה:

```text wrap theme={null}
שלח אימיילים מהאפליקציה שלי בעזרת Outlook.
```

```text wrap theme={null}
הצג את אירועי היומן שלי ב-Outlook בלוח הבקרה.
```

```text wrap theme={null}
צור אירועי יומן ב-Outlook כשמשהו נקבע באפליקציה שלי.
```

```text wrap theme={null}
קרא אימיילים אחרונים מ-Outlook וסכם אותם.
```

> [!TIP]
>
> רוצה שה-Superagent שלך יצטרף לפגישות שלך ב-Outlook וירשום הערות? ראה [חיבור היומן שלך](https://docs.base44.com/he/superagents/meeting-notes.md#connecting-your-calendar).

***

## חיבור Outlook

בחר איך אנשים מתחברים: חשבון משותף אחד לכל האפליקציה, או החשבון האישי של כל אדם.

> [tab] מחבר משותף
>
> חבר חשבון אחד, וכל מי שמשתמש באפליקציה חולק אותו ואת הנתונים שלו.
>
> **כדי להוסיף מחבר Outlook משותף:**
>
> 1. לחץ על **Connectors** בסרגל הצד של סביבת העבודה.
>
> 2. לחץ על **Add connector**.
>
> 3. חפש את **Outlook** ולחץ עליו.
>
> 4. בחר **Shared connector** ולחץ על **Next**.
>
> 5. הזן **Connection name**.
>
> 6. ב-**Who can access**, בחר היכן אפשר להשתמש בחיבור: **Apps and Super agent** (ברירת המחדל), **Apps only** או **Super agent only**.
>
> 7. תחת **Permissions**, בחר **Read-only** (ברירת המחדל), **Read & write** או **Custom**. כדי לשלוח אימייל, בחר **Read & write**. למד עוד על [היקפי הרשאות](#scopes-and-permissions).
>
>    ![הגדרת מחבר Outlook משותף, עם Connection name, Who can access והרשאות Read-only מסומנות](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-shared-setup.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5638130e25a42638151162b63b297ef3)
>
>    הגדרת מחבר Outlook משותף
>
> 8. לחץ על **Add connector**.
>
> 9. התחבר עם חשבון ה-Microsoft שאתה רוצה לשתף.

> [tab] מחבר למשתמשי אפליקציה
>
> כל אדם מחבר את חשבון ה-Microsoft שלו, כך שהאפליקציה יכולה לעבוד עם הדואר והיומן שלו.
>
> > [!TIP]
> >
> > **לפני שמתחילים:** רק בעלים ומנהלים של סביבת העבודה יכולים להגדיר את זה. צריך רישום אפליקציה ב-Microsoft ואת ה-Client ID וה-Client Secret שלו. אלא אם תזין [Microsoft Tenant ID](#using-a-microsoft-tenant), הגדר את **Supported account types** שלו לחשבונות בכל ספריית ארגון ולחשבונות Microsoft אישיים. ראה [שימוש בלקוח OAuth משלך](https://docs.base44.com/he/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **כדי להוסיף מחבר Outlook למשתמשי אפליקציה:**
>
> 1. לחץ על **Connectors** בסרגל הצד של סביבת העבודה.
>
> 2. לחץ על **Add connector**.
>
> 3. חפש את **Outlook** ולחץ עליו.
>
> 4. בחר **App user connector** ולחץ על **Next**.
>
> 5. העתק את ה-**Callback URL**.
>
> 6. ברישום האפליקציה ב-Microsoft, הוסף את ה-Callback URL ל-redirect URIs המותרים.
>
> 7. בחזרה בטופס **Add Outlook Connection**, הזן **Connector name**,‏ **Client ID** ו-**Client Secret**.
>
>    ![הטופס Add Outlook Connection עם Callback URL,‏ Connector name,‏ Client ID ו-Client Secret](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-credentials.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5fb6f375d00995fabb114eb4e9dd463c)
>
>    הזנת פרטי הגישה של אפליקציית ה-Microsoft שלך
>
> 8. (אופציונלי) סקור את ה-scopes שנבחרו מראש תחת **Scopes** והסר את מה שהאפליקציה לא צריכה.
>
>    ![השדה Scopes של Outlook עם scopes נעולים ו-scopes ברירת מחדל, ומתחתיו Additional scopes](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-scopes.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=2d9c8f72c63f63496b4f8f45aae8daf4)
>
>    בחירת scopes למחבר למשתמשי אפליקציה
>
> 9. לחץ על **Add Connector**.
>
> לאחר מכן בקש מצ'אט ה-AI באפליקציה להוסיף דרך שבה אנשים יוכלו לחבר את חשבון ה-Outlook שלהם.

***

## היקפי הרשאות

ה-scopes קובעים מה האפליקציה יכולה לעשות ב-Outlook. אתה בוחר אותם כשאתה מגדיר מחבר.

> [card]
>
> **1. מה Base44 מוסיפה**
>
> ה-scopes האלה תמיד כלולים, ולכן הם מופיעים כנעולים תחת **Custom** במחבר משותף, או תחת **Scopes** במחבר למשתמשי אפליקציה.
>
> * `User.Read`: התחברות וקריאת הפרופיל של החשבון שמתחבר
> * `offline_access`: שמירה על החיבור פעיל בלי להתחבר מחדש
>
> **2. מה אתה מגדיר**
>
> בחר את ה-scopes שהאפליקציה צריכה תחת **Custom** במחבר משותף, או תחת **Scopes** במחבר למשתמשי אפליקציה.
>
> במחבר משותף, **Read-only** נותן לאפליקציה את `Mail.Read` ו-`Calendars.Read`. ‏**Read & write** נותן לה את `Mail.ReadWrite`,‏ `Calendars.ReadWrite` ו-`Mail.Send`.
>
> * `Mail.Read`: קריאת אימיילים
> * `Mail.ReadWrite`: קריאה, יצירה, עדכון ומחיקה של אימיילים, בלי לשלוח אותם
> * `Mail.Send`: שליחת אימייל בשם החשבון
> * `Calendars.Read`: קריאת אירועי יומן
> * `Calendars.ReadWrite`: קריאה, יצירה, עדכון ומחיקה של אירועי יומן
>
> **גישה:** האפליקציה עובדת עם תיבת הדואר והיומן של חשבון ה-Microsoft שמאשר את החיבור.

### שימוש ב-tenant של Microsoft

במחבר למשתמשי אפליקציה, אפשר להזין **Microsoft Tenant ID** בטופס ההגדרה, תחת Connection Configuration. השאר אותו ריק כדי להשתמש ב-`common`. אם אתה מזין ערך, ההגדרה של סוגי החשבונות הנתמכים ברישום האפליקציה ב-Microsoft לא חלה.

***

## שימוש בפונקציות backend

אחרי ש-Outlook מחובר, פונקציות ה-backend שלך יכולות לקבל אסימון גישה ולקרוא ישירות ל-Microsoft Graph API. ‏Base44 מטפלת בהתחברות ושומרת את האסימון מעודכן עבורך.

* בחיבור משותף, השתמש ב-`getConnection()` כדי לקבל את האסימון.
* בחיבור של משתמש אפליקציה, השתמש ב-`getCurrentAppUserConnection()` כדי שכל בקשה תשתמש באסימון של האדם המחובר.

קרא ל-Microsoft Graph API בכתובת `graph.microsoft.com` והעבר את האסימון בכותרת `Authorization`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("outlook");

const response = await fetch(
  "https://graph.microsoft.com/v1.0/me/messages?$top=10",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const { value: messages } = await response.json();
```

> [card] [מחברים משותפים](https://docs.base44.com/he/developers/backend/resources/connectors/shared-connectors.md)
>
> הגדר, פרוס וקרא לחיבור משותף מפונקציית backend.

> [card] [מחברים למשתמשי אפליקציה](https://docs.base44.com/he/developers/backend/resources/connectors/app-user-connectors.md)
>
> קבל אסימון לכל משתמש וקרא ל-API בשם האדם המחובר.

***

## פתרון בעיות

אם Outlook מפסיק לעבוד באפליקציה, בדוק את החיבור ואת ה-scopes שלו.

> [accordion] צריך לחבר מחדש את החיבור
>
> אם הגישה ל-Outlook אובדת או פגה, החיבור מציג **This connection needs to be reconnected**. במחבר משותף, [חבר אותו מחדש](https://docs.base44.com/he/Integrations/Connectors.md#managing-your-connectors) והתחבר עם אותו חשבון Microsoft. כל אפליקציה שמשתמשת בו תעבוד שוב. במחבר למשתמשי אפליקציה, כל אדם מחבר מחדש את החשבון שלו מתוך האפליקציה.

> [accordion] האפליקציה לא יכולה לשלוח אימייל
>
> כדי לשלוח אימייל, האפליקציה צריכה את ה-scope `Mail.Send`. ה-scope `Mail.ReadWrite` מאפשר לאפליקציה לקרוא ולשנות הודעות, אבל לא לשלוח אותן.
>
> * במחבר משותף, ההרשאות נקבעות כשאתה מוסיף את החיבור. לחץ על **Add another connector** בדף מחבר Outlook ובחר **Read & write** עבור החיבור החדש.
> * במחבר למשתמשי אפליקציה, פתח אותו בדף מחבר Outlook, הוסף את `Mail.Send` ל-scopes שלו ולחץ על **Save Changes**. אנשים שכבר התחברו שומרים את הגישה הקודמת שלהם עד שהם מתחברים שוב.

> [!NOTE]
>
> דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.