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.
{
"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.
Client ID 103948573625184736251
OAuth scopes https://www.googleapis.com/auth/gmail.modifyHalte 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.
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: {}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.
{
"body": "Sorry about the lamp, Jana. A replacement ships today."
}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.
{
"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": []
}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.
{
"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" }
}{
"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.
{
"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": []
}{
"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.
{
"trigger": "cron",
"schedule": "0 8 * * 1",
"triggered_at": "2026-10-12T08:00:00.000Z",
"prompt": "Write the weekly support report"
}{
"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
Weitere Verbindungen
Apache Kafka
Agenten verarbeiten Kafka-Topics und veröffentlichen ihre Ergebnisse unter dem Key der Ausgangsnachricht wieder in Topics.
Inbound · Outbound
AWS S3
Neue Dateien in einem Bucket lösen Agenten aus, mit Include Content auch zusammen mit der Datei selbst.
Inbound
MQTT
Nachrichten von Geräten und Maschinen auf MQTT-5-Topics lösen Agenten aus. Die Ergebnisse gehen zurück auf ein Topic.
Inbound · Outbound
PostgreSQL
Mit LISTEN/NOTIFY lösen neue Zeilen einen Agenten aus. Polling oder eine CDC-Pipeline sind nicht erforderlich.
Inbound
Stripe
Stripe-Events wie invoice.payment_failed oder customer.subscription.updated lösen Agenten aus. connic prüft die Webhook-Signaturen.
Inbound
WhatsApp
Lass einen Agenten WhatsApp-Nachrichten an deine Geschäftsnummer beantworten, auch mit Dateien. Er antwortet innerhalb von 24 Stunden oder erreicht Kunden mit freigegebenen Vorlagen.
Inbound · Outbound