Zum Hauptinhalt springen
connic
Starte kostenlos

Gmail

Starte einen Agenten bei jeder neuen E-Mail in einem Postfach von Google Workspace, samt Anhängen, und antworte aus diesem Postfach direkt im selben Verlauf.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
Gmail Docs
Publisher
Von connic

Jede neue E-Mail startet einen Run

connic verfolgt ein Label des Postfachs und gibt jede neue Nachricht an alle verknüpften Agenten weiter, in denselben Feldern wie die E-Mail-Verbindung.

Geparste Felder
Absender, Betreff, Message-ID, Text- und HTML-Inhalt und Anhänge kommen als eigene Felder an, dazu die ID des Gmail-Threads. Ein Agent für die E-Mail-Verbindung liest sie unverändert.
Jedes Label
Beobachte INBOX, STARRED oder ein eigenes Label wie Support/Orders. Ein Gmail-Filter, der eingehende E-Mails mit einem Label versieht, legt fest, was der Agent zu sehen bekommt.
Gelesen-Markierung
connic markiert jede Nachricht als gelesen, sobald alle verknüpften Agenten sie erhalten haben. So zeigt Gmail, was der Agent übernommen hat. Schalte es ab, um die Markierungen nicht anzutasten.
gmail-payload.json
{
  "from": "Jana Weber <jana@example.com>",
  "from_address": "jana@example.com",
  "to": "Acme Support <support@example.com>",
  "subject": "Order ord_8812 arrived damaged",
  "date": "Tue, 13 Oct 2026 07:12:04 +0000",
  "message_id": "<CAH7xR2kTq9w@mail.gmail.com>",
  "body_text": "Hi, the lamp in my order arrived broken.",
  "body_html": "<div>Hi, the lamp in my order arrived broken.</div>",
  "has_attachments": true,
  "attachments": [
    {
      "filename": "lamp.jpg",
      "content_type": "image/jpeg",
      "size_bytes": 182044,
      "content": "/9j/4AAQSkZJRgABAQ...",
      "encoding": "base64"
    }
  ],
  "_gmail": {
    "connector_id": "550e8400-e29b-41d4-a716-446655440000",
    "mailbox": "support@example.com",
    "label": "INBOX",
    "message_id": "192a7c3e5b8d4f10",
    "thread_id": "192a7c3e5b8d4f10",
    "timestamp": "2026-10-13T07:12:31.204518"
  }
}

Dein eigenes Dienstkonto

connic meldet sich als Dienstkonto in deinem Google-Cloud-Projekt an. Dein Super Admin autorisiert es für einen Gmail-Bereich, und du kannst seinen Schlüssel jederzeit löschen.

Kein Postfachpasswort
Der JSON-Schlüssel deines Dienstkontos liegt verschlüsselt in einer Connection. Löschst du den Schlüssel in der Google Cloud Console, kann sich connic nicht mehr anmelden.
Ein Gmail-Bereich
gmail.modify liest neue E-Mails, markiert sie als gelesen und verschickt Antworten und Benachrichtigungen.
Gmail und Google Sheets
Dieselbe Google-Workspace-Connection bedient auch Google-Sheets-Verbindungen. Ein Dienstkonto reicht also für E-Mails und Tabellen.
Google Admin console · Domain-wide delegation
Client ID      103948573625184736251
OAuth scopes   https://www.googleapis.com/auth/gmail.modify

Halte das Postfach neben deinen Agenten

Deklariere die Verbindung in connectors/. Der Schlüssel des Dienstkontos liegt in einer Connection, die die Datei nur beim Namen nennt. So bleiben Geheimnisse aus deinem Code, und jedes Environment kann ein eigenes Postfach beobachten.

connectors/support-inbox.yaml
type: gmail
mode: inbound
name: Support inbox
connection: acme-google
config:
  mailbox: support@example.com
  label: Support/Orders
agents:
  - support-triage
environments:
  Staging:
    config:
      mailbox: support-test@example.com
  Production: {}
create: connectors/support-inbox.yaml (gmail)

Antworten bleiben im Verlauf

Eine ausgehende Gmail-Verbindung macht aus dem Output des Agenten eine E-Mail aus demselben Postfach. Hat eine eingehende E-Mail den Run gestartet, wird daraus eine Antwort im ursprünglichen Thread.

Echte Antworten
Die Antwort geht im selben Gmail-Thread an den Absender und landet im Ordner Gesendet des Postfachs, wie eine Antwort deines Teams.
Text oder JSON
Reiner Text wird zum Body. Mit JSON setzt der Agent to, cc, bcc, subject, html_body und reply_to. Sende nach jedem Run, als Tool, das das Modell aufruft, oder aus Middleware.
Auch neue E-Mails
Setzt der Output to oder hat die Verbindung Standardempfänger, schickt der Agent stattdessen eine neue E-Mail, etwa eine Zusammenfassung an dein Team.
output.json
{
  "body": "Sorry about the lamp, Jana. A replacement ships today."
}
Sent
From: support@example.com
To: Jana Weber <jana@example.com>
Subject: Re: Order ord_8812 arrived damaged

Sorry about the lamp, Jana. A replacement ships today.

Wo Gmail passt

Wähle ein Szenario und sieh, was ankommt, welcher Agent läuft und was verschickt wird.

Kunden schreiben an deine Support-Adresse, und der Agent antwortet im selben Verlauf.

Support-Postfach
Inbound Gmail
support-triage
Antwort im Verlauf
gmail-payload.json
{
  "from_address": "sam@example.com",
  "subject": "Change delivery address for ord_9035",
  "body_text": "Please ship it to my office instead.",
  "has_attachments": false,
  "attachments": []
}
Sent
From: support@example.com
To: sam@example.com
Subject: Re: Change delivery address for ord_9035

Done. Order ord_9035 now ships to your office.

Ein Gmail-Filter versieht Lieferantenrechnungen mit einem Label, und die Kreditorenbuchhaltung bekommt die ausgelesenen Summen per Mail.

Label Invoices
Inbound Gmail
invoice-extractor
Zusammenfassung an die Buchhaltung
gmail-payload.json
{
  "from_address": "billing@supplier.example",
  "subject": "Invoice INV-2041",
  "has_attachments": true,
  "attachments": [
    {
      "filename": "INV-2041.pdf",
      "content_type": "application/pdf",
      "size_bytes": 48213,
      "content": "JVBERi0xLjcKJeLjz9MK...",
      "encoding": "base64"
    }
  ],
  "_gmail": { "label": "Invoices" }
}
output.json
{
  "to": "ap@example.com",
  "subject": "INV-2041: 3 items, EUR 1,284.50",
  "body": "Due Nov 12. Line items and VAT add up to the total."
}

Der Agent erledigt Routineanfragen und gibt den Rest über ein E-Mail-Tool an dein Team ab.

Support-Postfach
Inbound Gmail
support-agent
Übergabe an dein Team
gmail-payload.json
{
  "from_address": "lea@example.com",
  "subject": "Refund for a cancelled booking",
  "body_text": "I cancelled booking B-5521 within 24 hours.",
  "has_attachments": false,
  "attachments": []
}
tool-call.json
{
  "to": "support-leads@example.com",
  "subject": "Refund decision needed: booking B-5521",
  "body": "Lea cancelled within 24 hours and asks for a full refund."
}

Ein Zeitplan startet den Agenten jeden Montag, und der Bericht geht aus deinem Postfach in Google Workspace raus.

Montags um 08:00
Cron-Scheduler
weekly-report
Bericht per E-Mail
cron-payload.json
{
  "trigger": "cron",
  "schedule": "0 8 * * 1",
  "triggered_at": "2026-10-12T08:00:00.000Z",
  "prompt": "Write the weekly support report"
}
output.json
{
  "to": ["lead@example.com", "ops@example.com"],
  "subject": "Support report, week 41",
  "body": "412 tickets, median first reply 38 minutes.",
  "html_body": "<h2>Week 41</h2><p>412 tickets, median first..."
}

FAQ zu Gmail

Nein. connic meldet sich bei Google als dein eigenes Dienstkonto mit dessen Schlüssel an und handelt über die domainweite Delegierung im Namen des Postfachs. Ein Nutzerpasswort oder ein Zustimmungsbildschirm ist nicht im Spiel.

Mit der domainweiten Delegierung kann das Dienstkonto für den Gmail-Bereich im Namen jedes Nutzers deiner Domain handeln; Google kann das nicht auf einzelne Nutzer beschränken. connic handelt nur im Namen des Postfachs, das in der jeweiligen Verbindung steht. Die Docs zeigen die Einrichtung.

Nein. Sie beginnt mit den E-Mails, die nach ihrer ersten Prüfung ankommen. Verknüpfst du einen Agenten mit einem vollen Posteingang, startet also nicht für jede alte Nachricht ein Run.

Ja. Hat eine eingehende Gmail-Verbindung den Run gestartet, antwortet die ausgehende Verbindung auf demselben Postfach auf genau diese E-Mail, im selben Gmail-Thread, außer der Output setzt eigene Empfänger.

Nein. Die Verbindung arbeitet mit Postfächern in Google Workspace. Für ein privates Gmail-Konto nutzt du die E-Mail-Verbindung über IMAP und SMTP mit einem App-Passwort.