Erstelle Aufgaben aus E-Mails und hänge E-Mail-Antworten mithilfe des ClickUp-Add-Ins an Aufgaben an.
Was du benötigst
- Du kannst dieses ClickUp-Add-In mit jedem ClickUp-Plan verwenden.
- Gäste und eingeschränkte Mitglieder können dieses ClickUp-Add-In nicht verwenden.
- Das Add-In für Outlook ist nicht für Mobilgeräte verfügbar.
Diese Integration funktioniert nicht mit freigegebenen oder delegierten Postfächern.
Kompatibilität
Das Add-In verwendet Microsofts Nested App Authentication (NAA), um auf Nachrichtenanhänge zuzugreifen. Du benötigst einen Outlook-Client und ein Postfach, die NAA unterstützen.
Die Mindest-Outlook-Versionen findest du in Microsofts Nested App Authentication-Anforderungen. NAA wird nicht unterstützt, wenn das Add-In in einem Outlook.com- oder Gmail-Postfach geöffnet wird.
Nutze die Microsoft-Anleitungen, um deine Outlook-Version zu ermitteln oder die Exchange Server-Version zu identifizieren, mit der dein Konto verbunden ist.
Das ClickUp-Add-In installieren
Installiere das Add-In hier. Wenn deine Outlook-Version eine URL erfordert, gib Folgendes ein: https://modern-outlook.clickup.com/manifest.xml.
Du kannst das Add-In auch manuell installieren:
- Öffne eine E-Mail in der Outlook-App.
- Wähle in der oberen Leiste Store oder Add-Ins abrufen aus. Webnutzer finden Add-Ins abrufen im Menü Ellipsis ... neben den Schaltflächen Antworten und Weiterleiten. Die Bezeichnungen können je nach Outlook-Version variieren.
- Suche im Add-In-Store nach ClickUp for Outlook.
- Klicke auf Hinzufügen. Mit dem Klick auf Hinzufügen stimmst du den Lizenzbedingungen und der Datenschutzrichtlinie des Add-Ins zu.
Administratorgenehmigung
Das Outlook-Add-In fordert die delegierte Microsoft Graph-Berechtigung Mail.Read an, keine Anwendungsberechtigungen. Es arbeitet mit dem Postfach des angemeldeten Benutzers. Freigegebene Postfächer und Stellvertreter-Postfächer werden nicht unterstützt. Ob ein Benutzer selbst zustimmen kann, hängt von den Einstellungen des Microsoft Entra-Mandanten ab. Wenn die Benutzerzustimmung eingeschränkt ist, muss ein Microsoft-Administrator die Zustimmung erteilen.
Bitte einen Microsoft-Administrator, diese Schritte auszuführen:
- Öffne Microsoft Entra ID.
- Navigiere zu Unternehmensanwendungen.
- Suche nach der App mit der Anwendungs-ID aaedd6ae-575a-4582-ba2b-7c114a26e870.
- Wähle die ClickUp-App aus.
- Öffne Berechtigungen unter Sicherheit und überprüfe die angeforderte Graph-Berechtigung.
- Erteile die erforderliche Administratorzustimmung.
| Bereich | Zweck |
Mail.Read |
Ermöglicht der App, das Postfach des Benutzers zu lesen. Das Add-In verwendet diese Berechtigung in Outlook, um die Anhänge der geöffneten Nachricht über Microsoft Graph abzurufen. Den E-Mail-Text liest es über Office.js. |
Das Mail.Read-Token erlaubt das Lesen des gesamten Postfachs, das Add-In nutzt es jedoch nur für die geöffnete Nachricht und deren Anhänge.
Das Office-Add-In-Manifest fordert außerdem die Berechtigungsstufe ReadWriteMailbox an, die über das hinausgeht, was das Add-In zum Lesen der ausgewählten E-Mail benötigt. Dabei handelt es sich um eine Office-Add-In-Berechtigungsstufe, nicht um eine Microsoft Graph-Berechtigung.
Das Add-In liest den E-Mail-Text über Office.js und Anhänge über Microsoft Graph. Der Graph-Zugriff erfolgt über das angemeldete Konto – keine Anwendungsberechtigungen oder Bereiche für freigegebene Postfächer. Es verwendet weder EWS, IMAP, POP noch SMTP AUTH.
Die Zustimmungsrichtlinie des Microsoft Entra-Mandanten legt fest, ob du selbst zustimmen kannst. Wenn die Benutzerzustimmung eingeschränkt ist, muss ein Microsoft-Administrator die erforderliche Graph-Zustimmung erteilen.
Administratoren sollten die Graph-Berechtigungen in Microsoft Entra sowie die Office-Berechtigungsstufe im Add-In-Manifest und in der Bereitstellungskonfiguration prüfen. Das sind zwei separate Überprüfungen.
Weitere Informationen findest du in Microsofts Anleitung zur Verwaltung von Anwendungsberechtigungen.
Die Entra-Anwendungs-ID des Add-Ins lautet aaedd6ae-575a-4582-ba2b-7c114a26e870. Die Office-Manifest-ID c1f0f062-29a7-4adf-bae8-a04aef9498ca ist ein anderer Bezeichner. Verwende beim Überprüfen des Add-Ins nicht die Registrierung einer Outlook-Mail-, Kalender- oder E-Mail-ClickApp.
Das ClickUp-Add-in öffnen
Nach der Installation des Add-ins kannst du die Einrichtung abschließen, indem du dich bei deinem ClickUp-Konto anmeldest:
- Öffne eine E-Mail in der Outlook-App.
- Klicke oben rechts auf das Symbol Apps.
- Wähle ClickUp aus.
- Melde dich bei deinem ClickUp-Konto an.
- Wähle die Workspaces aus, die Zugriff haben sollen, und klicke auf Connect Workspaces.
Bei der Microsoft-Autorisierung listet der Einwilligungsbildschirm die angeforderten Berechtigungen auf. Die Einwilligungseinstellungen deiner Organisation legen fest, ob du oder ein Microsoft-Administrator diese genehmigen kann.
Workspaces wechseln oder hinzufügen
Um deine verbundenen Workspaces anzuzeigen, klicke auf deinen Avatar oben links im Add-in.
Um einen neuen Workspace zum Add-in hinzuzufügen, klicke auf das Plus-Symbol neben Workspaces.
Neue Aufgaben erstellen
So erstellst du eine neue Aufgabe über das ClickUp-Add-in:
- Öffne das Add-in aus einer E-Mail in Outlook.
- Wähle in der oberen rechten Ecke den Tab Neue Aufgabe aus.
- Benenne deine Aufgabe, wähle eine Liste dafür aus und füge weitere Details hinzu.
- Klicke in der unteren rechten Ecke auf Neue Aufgabe erstellen.
Die Aufgabe wird erstellt, bevor die zugehörigen E-Mail-Dateien vollständig hochgeladen sind. Ein fehlgeschlagener Upload kann dazu führen, dass ein Teil oder der gesamte ausgewählte E-Mail-Inhalt in der Aufgabe fehlt.
E-Mails an Aufgaben anhängen
So hängst du eine E-Mail an eine vorhandene Aufgabe an oder erstellst daraus eine neue Aufgabe:
- Öffne das Add-in über eine E-Mail in Outlook.
- Um die E-Mail an eine vorhandene Aufgabe anzuhängen, wähle An Aufgabe anhängen. Um eine neue Aufgabe zu erstellen und die E-Mail daran anzuhängen, klicke auf + Neue Aufgabe.
Die E-Mail-Kopie und ihre Anhänge werden in separaten Upload-Anfragen hochgeladen. Schlägt ein Upload fehl, wird möglicherweise nur ein Teil des E-Mail-Inhalts an die vorhandene Aufgabe angehängt.
Was das Add-in an ClickUp sendet
Wenn du den Bereich öffnest, verwendet das Add-in die Nachrichten-ID, um verknüpfte ClickUp-Aufgaben zu suchen. Dabei werden weder der E-Mail-Text noch die Anhangsdateien hochgeladen. Der Bereich sendet außerdem separate Anfragen für ClickUp-Konto-, Workspace- und Aufgabeninformationen.
Das Add-in liest den Text der ausgewählten E-Mail und die Anhangsdaten in Outlook. Wenn du eine Aufgabe aus der E-Mail erstellst oder die E-Mail an eine Aufgabe anhängst, lädt es Folgendes hoch:
- Eine HTML-Kopie des E-Mail-Texts.
- Ein Vorschaubild.
- E-Mail-Metadaten, einschließlich Nachrichten-ID, Betreff, Absender und Outlook-Link.
- Unterstützte Nachrichtenanhänge als separate Dateien.
Diese Uploads werden zu Aufgabenanhängen. Manche Anhangtypen aus Outlook werden möglicherweise nicht übertragen. Überprüfe die Aufgabe nach dem Hochladen, um sicherzustellen, dass alle benötigten Dateien angehängt sind.
Datenzwischenspeicherung
Das Add-in hält den Text der ausgewählten E-Mail, Metadaten und Anhangsdaten während der Ausführung im Arbeitsspeicher. Diese temporäre E-Mail-Kopie wird weder im lokalen Browserspeicher noch in den Office-Roamingeinstellungen gespeichert.
ClickUp-Anmeldedaten und einige Einstellungen werden im Browserspeicher und in den Office-Roamingeinstellungen gespeichert. Die Anmeldebibliothek von Microsoft verwaltet einen separaten Token-Cache im Browserspeicher. Das Microsoft Graph-Token verbleibt im Outlook-Client und wird nicht an ClickUp übermittelt.
Beim Abmelden werden ClickUp-Anmeldedaten und Roamingeinstellungen entfernt. Der Token-Cache von Microsoft sowie alle im Arbeitsspeicher gehaltenen E-Mail-Daten werden dabei nicht gelöscht. Das Schließen des Bereichs ist keine Möglichkeit, Daten zu löschen.
Sicherheit
E-Mail-Inhalte, die in eine Aufgabe hochgeladen werden, werden als ClickUp-Inhalte gespeichert. Das Entfernen des Add-ins oder das Abmelden löscht diese Kopien nicht.
Wenn du unterstützte ClickUp Brain-Funktionen verwendest, können gespeicherte E-Mail-Inhalte gemäß deinen Workspace-Einstellungen und Inhaltsberechtigungen einbezogen werden. Das Add-in importiert dein Postfach nicht kontinuierlich.
Informationen zu Hosting- und Verarbeitungsbedingungen findest du im Artikel zum Daten-Hosting, in der Unterauftragsverarbeiterliste von ClickUp und im Datenschutznachtrag. Die Verarbeitung von Integrationen kann außerhalb der für deinen Workspace ausgewählten Hosting-Region stattfinden.
Das Entfernen des Add-ins widerruft nicht die Microsoft-Einwilligung. Ein Microsoft-Administrator kann die Berechtigungen der Anwendung in Microsoft Entra ID überprüfen oder entfernen. Je nach Mandantenrichtlinie kannst du deine eigene Einwilligung auch über „Meine Apps" entfernen.
Weitere Informationen findest du in der ClickUp-Sicherheitsrichtlinie und unter Datenschutz und Sicherheit.
Unerwartetes Verhalten
Häufige Lösungen bei unerwartetem Verhalten.
ClickUp-Konto kann nicht verbunden werden
Versuche, dich über das Add-in erneut bei ClickUp anzumelden. Die Microsoft-Autorisierung ist unabhängig von der ClickUp-Anmeldung: Für den Zugriff auf Anhänge benötigst du außerdem einen kompatiblen Outlook-Client sowie die erforderliche Microsoft-Zustimmung.
Allgemeine Verbindungsprobleme oder leerer Bildschirm
Wenn du Verbindungsprobleme hast oder einen leeren Bildschirm siehst, probiere für die ClickUp-Anmeldung die Option Token verwenden:
- Wähle im Add-in Token verwenden aus. Wenn du diese Option nicht siehst, entferne das Add-in und installiere es neu.
- Klicke in ClickUp oben links auf deinen Workspace-Avatar.
- Wähle Einstellungen aus.
- Klicke in der Seitenleiste „Alle Einstellungen" auf Apps.
- Klicke unter API-Token auf Generieren.
- Klicke auf Kopieren.
- Gehe zurück zum Add-in und füge deinen Token ein, um die beiden Konten zu verbinden.
Diese Option meldet dich bei ClickUp an. Sie ersetzt nicht die Microsoft-Autorisierung für den Lesezugriff auf Nachrichtenanhänge.
Add-ins können nicht installiert werden
Wenn du überhaupt keine Add-ins installieren kannst, wende dich an dein IT-Team.
Team-Freigabe
Das Add-in für Outlook zeigt derzeit nur Personen an, denen direkter Zugriff gewährt wurde oder die einzeln eingeladen wurden. Wenn jemand nur über eine Team-Freigabe Zugriff hat, erscheint diese Person im Add-in nicht als zuweisbare Option. Lade diese Person direkt zur Liste, zum Unterordner oder zum Ordner ein, in dem du arbeitest, um sie sichtbar zu machen.
Erforderliche Berechtigungen für das Outlook-Add-in
Die Einstellungen deines Microsoft Entra-Mandanten legen fest, ob du der delegierten Berechtigung Mail.Read zustimmen kannst. Wenn die Benutzerzustimmung eingeschränkt ist, muss ein Microsoft-Administrator die Zustimmung erteilen.
Das Entfernen des Add-ins hebt die Microsoft-Zustimmung nicht auf. Ein Microsoft-Administrator entfernt sie in Microsoft Entra ID unter Unternehmensanwendungen.
Die Office-Manifestberechtigung ReadWriteMailbox ist unabhängig von der Graph-Berechtigung Mail.Read. Überprüfe die Graph-Zustimmung in Entra sowie die Office-Berechtigungen im Manifest und in den Bereitstellungseinstellungen des Add-ins.
Einschränken, wer das Add-in verwenden kann
Microsoft-Administratoren können steuern, wer das Add-in verwenden darf:
- Setze in Microsoft Entra ID die Option Zuweisung erforderlich auf Ja für die ClickUp-Unternehmensanwendung. Nur zugewiesene Benutzer und Gruppen können sich anmelden. Alle anderen erhalten den Fehler
AADSTS50105. Für die Gruppenzuweisung ist Entra ID P1 oder P2 erforderlich. - Verwende im Microsoft 365 Admin Center die zentralisierte Bereitstellung, um das Add-in für bestimmte Benutzer oder Gruppen bereitzustellen.