> ## 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 mit deiner App verbinden

> Sende und lies E-Mails und verwalte Kalendertermine aus deiner App, über ein gemeinsames Konto oder das eigene Konto jeder Person.

Verbinde deine App mit Outlook, um E-Mails zu senden und zu lesen, Kalendertermine zu verwalten und Workflows auszuführen, wenn sich eine E-Mail oder ein Termin ändert. Nutze ein gemeinsames Konto für deine ganze App oder lass jede Person ihr eigenes Microsoft-Konto verbinden.

> [!NOTE]
>
> Du benötigst einen [Builder-Plan](https://base44.com/pricing) oder höher, um Connectors in deiner App zu nutzen.

***

## Was du tun kannst

Bring deine Outlook-E-Mails und deinen Kalender in die Workflows deiner App.

> [card] E-Mails senden
>
> Sende E-Mails von deinem Outlook-Konto, wenn in deiner App etwas passiert, etwa bei einer neuen Buchung.

> [card] E-Mails lesen und organisieren
>
> Lies neue Nachrichten, fasse sie zusammen und verschiebe oder aktualisiere sie aus deiner App.

> [card] Deinen Kalender verwalten
>
> Zeige deine Outlook-Termine in deiner App an und erstelle oder aktualisiere Termine, wenn etwas geplant wird.

> [card] [Workflows ausführen](https://docs.base44.com/de/Building-your-app/Creating-workflows.md#connector)
>
> Starte einen Workflow, wenn eine E-Mail in deinem Posteingang eintrifft oder ein Kalendertermin erstellt wird. Oder starte ihn, wenn eines davon aktualisiert oder gelöscht wird.

**Beispiel-Prompts**

Beschreibe im KI-Chat das Postfach oder den Kalender, was die Aktion auslöst, und alle dynamischen Felder. Zum Beispiel:

```text wrap theme={null}
Sende E-Mails aus meiner App über Outlook.
```

```text wrap theme={null}
Zeige meine Outlook-Kalendertermine im Dashboard an.
```

```text wrap theme={null}
Erstelle Kalendertermine in Outlook, wenn in meiner App etwas geplant wird.
```

```text wrap theme={null}
Lies neue E-Mails aus Outlook und fasse sie zusammen.
```

> [!TIP]
>
> Soll dein Superagent an deinen Outlook-Meetings teilnehmen und Notizen machen? Siehe [Deinen Kalender verbinden](https://docs.base44.com/de/superagents/meeting-notes.md#connecting-your-calendar).

***

## Outlook verbinden

Wähle, wie sich Personen verbinden: über ein gemeinsames Konto für deine ganze App oder über das eigene Konto jeder Person.

> [tab] Gemeinsamer Connector
>
> Verbinde ein Konto, und alle, die deine App nutzen, teilen es und seine Daten.
>
> **So fügst du einen gemeinsamen Outlook-Connector hinzu:**
>
> 1. Klicke in der Seitenleiste deines Workspaces auf **Konnektoren**.
>
> 2. Klicke auf **Connector hinzufügen**.
>
> 3. Suche nach **Outlook** und klicke darauf.
>
> 4. Wähle **Shared connector** aus und klicke dann auf **Weiter**.
>
> 5. Gib einen **Verbindungsname** ein.
>
> 6. Wähle in **Wer hat Zugriff** aus, wo die Verbindung genutzt werden kann: **Apps und Super-Agent** (Standard), **Apps only** oder **Super agent only**.
>
> 7. Wähle unter **Berechtigungen** **Nur Lesen** (Standard), **Lesen & schreiben** oder **Benutzerdefiniert**. Um E-Mails zu senden, wähle **Lesen & schreiben**. Mehr zu [Scopes und Berechtigungen](#scopes-and-permissions).
>
>    ![Einrichtung eines gemeinsamen Outlook-Connectors mit Connection name, Who can access und ausgewählten Read-only-Berechtigungen](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-shared-setup.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5638130e25a42638151162b63b297ef3)
>
>    Einen gemeinsamen Outlook-Connector einrichten
>
> 8. Klicke auf **Connector hinzufügen**.
>
> 9. Melde dich mit dem Microsoft-Konto an, das du teilen möchtest.

> [tab] App-Nutzer-Connector
>
> Jede Person verbindet ihr eigenes Microsoft-Konto. So kann deine App mit ihren E-Mails und ihrem Kalender arbeiten.
>
> > [!TIP]
> >
> > **Bevor du beginnst:** Nur Workspace-Owner und -Admins können das einrichten. Du brauchst eine Microsoft-App-Registrierung mit Client-ID und Client-Secret. Wenn du keine [Microsoft Tenant ID](#using-a-microsoft-tenant) eingibst, setze die **Supported account types** der Registrierung auf Konten in beliebigen Organisationsverzeichnissen und persönliche Microsoft-Konten. Siehe [Deinen eigenen OAuth-Client verwenden](https://docs.base44.com/de/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **So fügst du einen App-Nutzer-Connector für Outlook hinzu:**
>
> 1. Klicke in der Seitenleiste deines Workspaces auf **Konnektoren**.
>
> 2. Klicke auf **Connector hinzufügen**.
>
> 3. Suche nach **Outlook** und klicke darauf.
>
> 4. Wähle **App-Benutzer-Connector** aus und klicke dann auf **Weiter**.
>
> 5. Kopiere die **Callback URL**.
>
> 6. Füge die Callback URL in deiner Microsoft-App-Registrierung zu den erlaubten Redirect-URIs hinzu.
>
> 7. Gib im Formular **Add Outlook Connection** einen **Connector name**, die **Client-ID** und das **Client-Geheimnis** ein.
>
>    ![Formular Add Outlook Connection mit Callback URL, Connector name, Client ID und 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)
>
>    Die Anmeldedaten deiner Microsoft-App eingeben
>
> 8. (Optional) Prüfe die vorausgewählten Scopes unter **Scopes** und entferne alle, die deine App nicht braucht.
>
>    ![Outlook-Feld Scopes mit gesperrten und Standard-Scopes und darunter 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 für einen App-Nutzer-Connector wählen
>
> 9. Klicke auf **Konnektor hinzufügen**.
>
> Bitte dann den KI-Chat in deiner App, eine Möglichkeit hinzuzufügen, mit der Personen ihr eigenes Outlook-Konto verbinden können.

***

## Scopes und Berechtigungen

Scopes steuern, was deine App in Outlook tun kann. Du wählst sie, wenn du einen Connector einrichtest.

> [card]
>
> **1. Base44 fügt hinzu**
>
> Diese Scopes sind immer enthalten. Sie erscheinen daher als gesperrte Scopes: unter **Benutzerdefiniert** bei einem gemeinsamen Connector oder unter **Scopes** bei einem App-Nutzer-Connector.
>
> * `User.Read`: Anmelden und das Profil des verbindenden Kontos lesen
> * `offline_access`: Die Verbindung aktiv halten, ohne sich erneut anzumelden
>
> **2. Du konfigurierst**
>
> Wähle die Scopes, die deine App braucht: unter **Benutzerdefiniert** bei einem gemeinsamen Connector oder unter **Scopes** bei einem App-Nutzer-Connector.
>
> Bei einem gemeinsamen Connector gibt **Nur Lesen** deiner App `Mail.Read` und `Calendars.Read`. **Lesen & schreiben** gibt ihr `Mail.ReadWrite`, `Calendars.ReadWrite` und `Mail.Send`.
>
> * `Mail.Read`: E-Mails lesen
> * `Mail.ReadWrite`: E-Mails lesen, erstellen, aktualisieren und löschen, aber nicht senden
> * `Mail.Send`: E-Mails im Namen des Kontos senden
> * `Calendars.Read`: Kalendertermine lesen
> * `Calendars.ReadWrite`: Kalendertermine lesen, erstellen, aktualisieren und löschen
>
> **Zugriff:** Deine App arbeitet mit dem Postfach und dem Kalender des Microsoft-Kontos, das die Verbindung autorisiert.

### Einen Microsoft-Tenant verwenden

Bei einem App-Nutzer-Connector kannst du im Einrichtungsformular unter Connection Configuration eine **Microsoft Tenant ID** eingeben. Lass das Feld leer, um `common` zu verwenden. Wenn du eine ID eingibst, gilt die Einstellung für unterstützte Kontotypen in deiner Microsoft-App-Registrierung nicht.

***

## Backend-Funktionen nutzen

Sobald Outlook verbunden ist, können deine Backend-Funktionen ein Zugriffstoken abrufen und die Microsoft Graph API direkt aufrufen. Base44 übernimmt die Anmeldung und hält das Token für dich aktuell.

* Für eine gemeinsame Verbindung nutze `getConnection()`, um das Token abzurufen.
* Für eine App-Nutzer-Verbindung nutze `getCurrentAppUserConnection()`, damit jede Anfrage das Token der angemeldeten Person verwendet.

Rufe die Microsoft Graph API unter `graph.microsoft.com` auf und übergib das Token im Header `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] [Gemeinsame Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/shared-connectors.md)
>
> Konfiguriere, deploye und rufe eine gemeinsame Verbindung aus einer Backend-Funktion auf.

> [card] [App-Nutzer-Connectors](https://docs.base44.com/de/developers/backend/resources/connectors/app-user-connectors.md)
>
> Rufe ein Token pro Nutzer ab und rufe die API im Namen der angemeldeten Person auf.

***

## Fehlerbehebung

Prüfe die Verbindung und ihre Scopes, wenn Outlook in deiner App nicht mehr funktioniert.

> [accordion] Die Verbindung muss neu verbunden werden
>
> Wenn der Outlook-Zugriff verloren geht oder abläuft, zeigt die Verbindung **Diese Verbindung muss erneut hergestellt werden**. Bei einem gemeinsamen Connector [verbindest du sie neu](https://docs.base44.com/de/Integrations/Connectors.md#managing-your-connectors) und meldest dich mit demselben Microsoft-Konto an. Danach funktioniert jede App wieder, die sie nutzt. Bei einem App-Nutzer-Connector verbindet jede Person ihr eigenes Konto in deiner App neu.

> [accordion] Deine App kann keine E-Mails senden
>
> Deine App braucht den Scope `Mail.Send`, um E-Mails zu senden. Mit dem Scope `Mail.ReadWrite` kann deine App Nachrichten lesen und ändern, aber nicht senden.
>
> * Bei einem gemeinsamen Connector werden die Berechtigungen beim Hinzufügen der Verbindung festgelegt. Klicke auf der Outlook-Connector-Seite auf **Add another connector** und wähle **Lesen & schreiben** für die neue Verbindung.
> * Bei einem App-Nutzer-Connector öffnest du ihn auf der Outlook-Connector-Seite, fügst `Mail.Send` zu seinen Scopes hinzu und klickst auf **Save Changes**. Personen, die sich bereits verbunden haben, behalten ihren bisherigen Zugriff, bis sie sich erneut verbinden.

> [!NOTE]
>
> Diese Seite wurde mit KI übersetzt. Die genauesten und aktuellsten Informationen findest du in der [englischen Version](https://docs.base44.com/index.md).


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