Verbinde dein Gmail-Konto mit Goodweek, um E-Mails direkt aus deinem KI-Arbeitsbereich zu lesen, zu senden und zu verwalten.
ℹ️ Hinweis zur Governance
Goodweek überschreitet niemals die dem Nutzer in Gmail gewährten Zugriffsrechte und gewährleistet damit die Einhaltung der Governance-Richtlinien deiner Organisation. Die Ergebnisse und verfügbaren Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Nutzers variieren.
📋 Voraussetzungen
Bevor ein Nutzer die Gmail-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek-Admin-Panel unter dem Tab Integrationen aktivieren.
Administrator-Einrichtung
Persönliche Google-Konten (@gmail.com)
Keine Administrator-Einrichtung erforderlich. Verbinde dich direkt, indem du die unten stehenden Schritte zur Nutzerverbindung befolgst.
Google Workspace-Konten (Arbeit oder Schule)
Je nach API-Zugriffsrichtlinie deiner Organisation kann einer der folgenden Fälle zutreffen.
Szenario 1 — Standard (uneingeschränkter Zugriff durch Drittanbieter)
Jeder Nutzer kann sich direkt verbinden, ohne dass ein Administrator eingreifen muss.
Szenario 2 — Der Zugriff durch Drittanbieter ist eingeschränkt (Fehler admin_policy_enforced)
Ein Google Workspace-Super-Admin muss Composio als vertrauenswürdige App kennzeichnen:
Melde dich als Super-Admin bei admin.google.com an.
Gehe zu Sicherheit → Zugriffs- und Datensteuerung → API-Steuerung → Zugriff von Drittanbieter-Apps verwalten.
Klicke auf Neue App konfigurieren, suche nach Composio, wähle es aus, setze den Zugriff auf Vertrauenswürdig und klicke auf Speichern.
Szenario 3 — Jeglicher API-Zugriff durch Drittanbieter ist blockiert
Gehe zu admin.google.com → Sicherheit → API-Steuerung und überprüfe die Einstellung „Zugriff von Drittanbieter-Apps auf Google APIs". Falls dieser blockiert ist, muss der Administrator eine Ausnahme für Composio erstellen, bevor er Szenario 2 befolgt.
Nutzerverbindung
Gehe in Goodweek zu Integrationen.
Suche Gmail und klicke auf Verbinden.
Du wirst zu Google weitergeleitet, wo du aufgefordert wirst, dich anzumelden.
Überprüfe die angeforderten Berechtigungen und klicke auf Zulassen, um zu Goodweek zurückzukehren.
Wichtige Hinweise
Jeder Nutzer muss sein eigenes Konto individuell verbinden.
Goodweek kann nur auf die E-Mails und Daten zugreifen, für die dein individuelles Nutzerkonto eine Berechtigung hat.
Wenn du mehrere Google-Konten hast, achte darauf, beim Verbindungsschritt das richtige auszuwählen. Google wählt möglicherweise automatisch das zuletzt verwendete Konto vor.
Gmail-OAuth-Tokens können ungültig werden, wenn dein Google Workspace-Administrator die Sitzungsdauer oder die API-Zugriffsrichtlinien ändert. Wenn die Integration unerwartet nicht mehr funktioniert, versuche, die Verbindung zu trennen und neu herzustellen.
Du kannst den Zugriff von Goodweek jederzeit unter myaccount.google.com → Sicherheit → Drittanbieter-Apps mit Kontozugriff widerrufen.
Verfügbare Tools
Tool | Beschreibung | Typ |
Send Email | Sendet sofort eine E-Mail über die Gmail-API unter Verwendung des Anzeigenamens des authentifizierten Nutzers. | Schreiben |
Reply to Email Thread | Sendet eine Antwort innerhalb eines bestimmten Gmail-Threads unter Beibehaltung des ursprünglichen Betreffs und Thread-Kontexts. | Schreiben |
Forward Email Message | Leitet eine vorhandene Gmail-Nachricht an angegebene Empfänger weiter und behält dabei den ursprünglichen Text und die Anhänge bei. | Schreiben |
Create Email Draft | Erstellt einen Gmail-Entwurf, ohne ihn zu senden, zur Überprüfung vor dem Versand. | Schreiben |
Update Draft | Ersetzt den Inhalt eines vorhandenen Gmail-Entwurfs anhand der Entwurfs-ID direkt vor Ort. | Schreiben |
Send Draft | Sendet einen vorhandenen Entwurf unverändert an die festgelegten Empfänger. | Schreiben |
Get Draft | Ruft einen einzelnen Gmail-Entwurf anhand seiner ID ab. | Lesen |
List Drafts | Ruft eine paginierte Liste von E-Mail-Entwürfen aus dem Gmail-Konto des Nutzers ab. | Lesen |
Fetch Emails | Ruft eine Liste von E-Mail-Nachrichten aus einem Gmail-Konto mit Filterung, Paginierung und optionalem Abruf des vollständigen Inhalts ab. | Lesen |
Fetch Message by Message ID | Ruft eine bestimmte E-Mail-Nachricht anhand ihrer ID ab. | Lesen |
Fetch Message by Thread ID | Ruft alle Nachrichten eines Gmail-Threads anhand seiner Thread-ID ab. | Lesen |
List Threads | Ruft eine Liste von E-Mail-Threads aus einem Gmail-Konto mit Filterung und Paginierung ab. | Lesen |
Get Gmail Attachment | Ruft einen bestimmten Anhang aus einer Gmail-Nachricht anhand seiner Anhang-ID ab. | Lesen |
Get Profile | Ruft Gmail-Profilinformationen einschließlich E-Mail-Adresse und Postfachstatistiken ab. | Lesen |
Get Contacts | Ruft Kontakte für das authentifizierte Google-Konto mit optionaler Feldauswahl und Paginierung ab. | Lesen |
Search People | Durchsucht Kontakte, indem eine Abfrage mit Namen, E-Mail-Adressen, Telefonnummern und Organisationen abgeglichen wird. | Lesen |
Modify Email Labels | Fügt Gmail-Labels zu einer bestimmten Nachricht hinzu oder entfernt sie. | Schreiben |
Batch Modify Gmail Messages | Ändert Labels für bis zu 1.000 Gmail-Nachrichten in einem einzigen API-Aufruf. | Schreiben |
Create Label | Erstellt ein neues Gmail-Label mit einem eindeutigen Namen im Konto des Nutzers. | Schreiben |
List Gmail Labels | Ruft alle System- und benutzerdefinierten Labels für ein Gmail-Konto ab. | Lesen |
Create Gmail Filter | Erstellt einen neuen Gmail-Filter mit festgelegten Kriterien und Aktionen zur Organisation eingehender E-Mails. | Schreiben |
List Gmail Filters | Listet alle Gmail-Filter (Regeln) im Postfach auf. | Lesen |
Get Vacation Settings | Ruft die Einstellungen des Abwesenheitsassistenten ab, um zu prüfen, ob automatische Abwesenheitsantworten aktiv sind. | Lesen |
Update Vacation Settings | Konfiguriert die Einstellungen für automatische Abwesenheitsantworten für einen Gmail-Nutzer. | Schreiben |
Move to Trash | Verschiebt eine E-Mail-Nachricht in den Papierkorb (wiederherstellbar). | ⚠️ Destruktiv |
Trash Thread | Verschiebt einen gesamten E-Mail-Thread und alle seine Nachrichten in den Papierkorb. | ⚠️ Destruktiv |
Batch Delete Gmail Messages | Löscht mehrere Gmail-Nachrichten dauerhaft im Bulk-Verfahren, umgeht dabei den Papierkorb, keine Wiederherstellung möglich. | ⚠️ Destruktiv |
Delete Thread | Löscht einen Thread und alle seine Nachrichten dauerhaft und sofort. Diese Aktion kann nicht rückgängig gemacht werden. | ⚠️ Destruktiv |
Anwendungsfälle
Sende und beantworte E-Mails aus Goodweek. Verfasse, sende und beantworte Gmail-Nachrichten direkt innerhalb einer Goodweek-Unterhaltung und behalte die E-Mail-Kommunikation im Kontext der Arbeit, die du bereits erledigst.
Lies relevante E-Mails auf Abruf und stelle sie bereit. Durchsuche dein Postfach nach Absender, Betreff oder Stichwörtern, um bestimmte E-Mails abzurufen und in eine Goodweek-Unterhaltung zur Überprüfung oder als Referenz einzubringen.
Entwirf E-Mails zur Überprüfung vor dem Versand. Erstelle E-Mail-Entwürfe in Gmail über Goodweek und überprüfe und sende sie dann zum richtigen Zeitpunkt – nützlich, wenn du Kommunikation im Voraus vorbereiten musst.
Verwalte die Organisation deines Postfachs. Wende Labels auf E-Mails an, erstelle Gmail-Filter für eingehende E-Mails oder verschiebe Nachrichten aus Goodweek in den Papierkorb, um dein Postfach übersichtlich zu halten, ohne zur Gmail-Oberfläche zu wechseln.
Fehlerbehebung
„Error 400: admin_policy_enforced" beim Verbinden
Dies ist das häufigste Problem für Google Workspace-Nutzer. Nur ein Google Workspace-Super-Admin kann dies beheben, indem er das oben beschriebene Szenario 2 befolgt.
Administrator hat Composio als vertrauenswürdig markiert, aber der Fehler tritt weiterhin auf
Es kann zu einer Verzögerung bei der Übernahme kommen. Warte ein paar Minuten und versuche es erneut. Wenn der Fehler weiterhin auftritt, überprüfe, ob die richtige Composio-App ausgewählt wurde und ob die Zugriffsstufe als Vertrauenswürdig und nicht als Eingeschränkt gespeichert wurde.
Falsches Google-Konto verbunden
Trenne die Integration von Goodweek und stelle sie erneut her. Klicke beim Google-Authentifizierungsschritt auf „Anderes Konto verwenden" oder öffne ein Inkognito-Browserfenster, um die automatische Kontoauswahl zu vermeiden.
Integration funktioniert nach erfolgreicher Verbindung nicht mehr
Möglicherweise hat dein Google Workspace-Administrator die API-Zugriffsrichtlinien geändert. Versuche, die Verbindung zu trennen und neu herzustellen. Wenn das Problem weiterhin besteht, bitte deinen Administrator zu überprüfen, ob Composio noch als Vertrauenswürdig markiert ist.
Integration in Goodweek nicht sichtbar
Stelle sicher, dass der Administrator deiner Organisation die Gmail-Integration im Goodweek-Admin-Panel unter dem Tab Integrationen aktiviert hat.