Gmail-Integration einrichten
Gmail per OAuth verbinden, Labels nutzen und Workflows auf eingehende E-Mails reagieren lassen.
Zuletzt aktualisiert: 2026-05-17
Gmail-Integration einrichten
Mit Gmail als Integration kann ein Agent E-Mails lesen, sortieren, beantworten und versenden — alles unter deinem Google-Workspace-Konto.
Voraussetzungen
- Google-Workspace-Account oder Standard-Gmail
- Bei Workspace: ein Admin muss die Orconic-App freigeben
Schritt 1 — Verbindung herstellen
In Orconic: Integrationen → Gmail → Verbinden.
Google fragt nach Berechtigungen:
- E-Mails lesen
- E-Mails versenden
- Labels lesen und setzen
- Entwürfe erstellen
Schritt 2 — Scope wählen
Du kannst granular einschränken, was Orconic darf:
- Nur lesen (für reine Triage)
- Lesen und beantworten
- Vollzugriff (Versand, Labels, Entwürfe)
Wir empfehlen den minimalen Scope, der den Use Case abdeckt.
Schritt 3 — Trigger einrichten
Im Workflow-Canvas kannst du Gmail → Neue E-Mail in Label X als Trigger nutzen:
Trigger: Gmail
Label: support-inbox
Frequenz: alle 60 SekundenOrconic synchronisiert dann alle ungelesenen Mails in diesem Label.
Schritt 4 — Aktionen
Im Workflow kannst du:
- Antwort senden (Threading bleibt erhalten)
- Label setzen / entfernen
- Entwurf erzeugen (für menschliche Freigabe)
- Mail weiterleiten
gmail.reply(threadId: "{{trigger.threadId}}",
body: "{{steps.draft.text}}")Sicherheit und Compliance
- Tokens werden im EU-Vault verschlüsselt gespeichert.
- Inhalte werden nicht als Trainingsdaten verwendet.
- Du kannst die Verbindung jederzeit trennen — verbleibende OAuth-Token werden bei Google revoziert.
Häufige Probleme
Symptom | Ursache | Fix
---------------------- | ----------------------------- | -----------------------
401 invalid_grant | Refresh-Token abgelaufen | neu verbinden
Quota exceeded | > 250 Mails/min | Drosselung aktivieren
Filter trifft nicht | Label-Name falsch geschrieben | exakt prüfen (case-sens.)