Gmail
Gmail verbinden, um E-Mails von deiner eigenen Adresse zu senden und deinen Posteingang in deiner condoo.Vibe-App in Leads, Tickets, Zusammenfassungen und Antworten zu verwandeln.
Mit dem Gmail-Connector können Anwendungen, die du mit condoo.Vibe erstellst, E-Mails von deiner eigenen Gmail-Adresse senden und, wenn du es erlaubst, mit den E-Mails arbeiten, die du erhältst.
Du kannst Gmail für Folgendes verwenden:
- Benachrichtigungen und Bestätigungen, die von deiner eigenen Adresse gesendet werden
- Eingehende E-Mails in Leads, Tickets oder Bestellungen verwandeln
- Rechnungen, Belege und andere Anhänge speichern
- Ungelesene E-Mails zusammenfassen und mit Labels versehen
- SMS-Benachrichtigungen, wenn eine wichtige E-Mail eintrifft
- Mit KI entworfene Antworten, die du vor dem Senden freigibst
- Eine private Posteingangsseite in deiner App
- Persönliche Kontaktaufnahme in kleinem Rahmen, mit Nachfass-E-Mails
Gmail verbinden. Festlegen, wie viel Zugriff deine App erhält. condoo.Vibe erstellt den E-Mail-Ablauf.
Gmail und Resend
Gmail und Resend senden beide E-Mails, erfüllen aber unterschiedliche Aufgaben.
| Du möchtest | Verwende |
|---|---|
| Begrüßungs-E-Mails, Belege und E-Mails zum Zurücksetzen des Passworts von deiner eigenen Domain senden | Resend |
| Newsletter oder große E-Mail-Mengen senden | Resend |
| Benachrichtigungen von deiner eigenen Gmail-Adresse senden | Gmail |
| Die E-Mails, die du erhältst, lesen, durchsuchen oder sortieren | Gmail |
| Kunden im selben E-Mail-Thread antworten | Gmail |
Du kannst beide verbinden.
Sind beide verbunden, laufen die eigenen E-Mails deiner App (Begrüßungs-E-Mails, Belege, Formularbenachrichtigungen) über Resend. Gmail wird für deinen Posteingang verwendet und für alle E-Mails, die du ausdrücklich von deiner Gmail-Adresse senden lassen möchtest.
Festlegen, wie viel Zugriff deine App erhält
Beim Verbinden von Gmail wählst du eine von drei Zugriffsstufen:
| Zugriff | Was deine App tun kann |
|---|---|
| Send only | E-Mails von deiner Adresse senden. Deinen Posteingang kann sie nicht lesen. |
| Read and send | Zusätzlich deine E-Mails lesen und durchsuchen, Anhänge herunterladen und im selben Thread antworten. |
| Manage inbox | Zusätzlich Labels vergeben, archivieren, als gelesen markieren, in den Papierkorb verschieben und Entwürfe erstellen. E-Mails werden nie endgültig gelöscht. |
Beginne mit der niedrigsten Stufe, die deine Funktionen benötigen.
Wenn du später eine Funktion anforderst, die mehr Zugriff benötigt, fragt condoo.Vibe, ob sie trotzdem erstellt werden soll. Statt einfach fehlzuschlagen, zeigt dir die App dann einen Hinweis, dich mit mehr Zugriff erneut zu verbinden.
Vor dem Start
Du benötigst:
- Das Gmail- oder Google-Workspace-Konto, das deine App verwenden soll
- Etwa zehn Minuten, um einmalig einen Google-Cloud-OAuth-Client einzurichten
Der Gmail-Zugriff läuft über deinen eigenen Google-Cloud-OAuth-Client. So bleibt die Verbindung zwischen dir und Google: Dein Postfach ist ausschließlich mit deiner App verbunden, und du musst nicht warten, bis Google eine App geprüft hat.
Deinen Google-Client einrichten
Öffne dein condoo.Vibe-Projekt, wechsle zu Connectors und wähle Gmail aus. Lass diese Seite geöffnet: Sie zeigt zwei Werte, die du in Google Cloud einfügst, die Authorized redirect URI und die Authorized domain, jeweils mit einer Copy-Schaltfläche.
Dann in einem zweiten Tab:
Ein Google-Cloud-Projekt auswählen
Öffne console.cloud.google.com und wähle ein bestehendes Projekt aus oder erstelle ein neues für diese App.
Die Gmail API aktivieren
Wechsle zu APIs & Services und dann zu Library. Suche nach "Gmail API" und klicke auf Enable.
Das Branding ausfüllen
Öffne Google Auth Platform und dann Branding. Gib einen beliebigen App-Namen ein, verwende deine eigene E-Mail-Adresse als Support- und Entwicklerkontakt und füge die Authorized domain hinzu, die auf der Gmail-Connector-Seite angezeigt wird.
Die App veröffentlichen
Öffne Audience, wähle External und klicke auf "Publish app", sodass der Status "In production" lautet. Wenn bei Google Workspace nur Personen aus deiner Organisation eine Verbindung herstellen, kannst du stattdessen Internal wählen.
Einen Web-Client erstellen
Öffne Clients, klicke auf "Create client" und wähle "Web application". Füge unter Authorized redirect URIs exakt die Authorized redirect URI hinzu, die auf der Gmail-Connector-Seite angezeigt wird. Ein JavaScript-Ursprung ist nicht nötig.
Client ID und Client secret kopieren
Google zeigt eine Client ID und ein Client secret an. Lass diesen Tab für den nächsten Schritt geöffnet.
Gmail mit condoo.Vibe verbinden
Zurück auf der Gmail-Connector-Seite:
- Füge Client ID und Client secret ein und klicke dann auf Save client.
- Wähle eine Zugriffsstufe: Send only, Read and send oder Manage inbox.
- Klicke auf Connect with Google und melde dich mit dem Konto an, das deine App verwenden soll.
- Google meldet, dass es diese App nicht verifiziert hat. Das ist zu erwarten, weil es deine eigene App ist. Klicke auf Advanced und dann auf den Link zu deiner App.
- Setze auf dem Berechtigungsbildschirm bei jeder Gmail-Option ein Häkchen und fahre dann fort.
Das Google-Fenster schließt sich, und die Seite zeigt an, welche Adresse mit welcher Zugriffsstufe verbunden ist.
Bis du die Anmeldung bei Google abgeschlossen hast, zeigt die Connector-Liste Gmail als Finish connecting an.
Nach dem Verbinden kannst du mit Re-check die Verbindung bestätigen und mit Send a test email to myself eine echte E-Mail von deiner Adresse an dieselbe Adresse senden.
Dein erster Gmail-Ablauf
Angenommen, deine Website hat ein Kontaktformular und du möchtest jede Anfrage in deinem eigenen Posteingang erhalten.
Teile condoo.Vibe mit:
Mir eine E-Mail von meinem Gmail-Konto senden, wenn jemand das Kontaktformular absendet. Name, E-Mail-Adresse und Nachricht der Person angeben und ihre Adresse als Antwortadresse festlegen, damit ich direkt antworten kann.
Der Ablauf könnte so aussehen:
Besucher sendet Formular ab
↓
Anfrage speichern
↓
Über Gmail senden
↓
E-Mail landet in deinem Posteingang
↓
Antwort geht an den Besucher
Dafür reicht der Zugriff Send only.
Standardmäßig gehen Benachrichtigungen an die verbundene Gmail-Adresse. Um sie an eine andere Adresse zu senden, lege auf der Gmail-Connector-Seite die Notify address fest.
Eingehende E-Mails in Datensätze verwandeln
Mit dem Zugriff Read and send kann deine App neue E-Mails ansehen und die passenden Nachrichten in Datensätze verwandeln.
Zum Beispiel:
Neue E-Mails in meinem Posteingang, in denen jemand ein Angebot anfragt, in Leads verwandeln. Name, E-Mail-Adresse und Nachricht des Absenders speichern.
Vereinfacht dargestellt:
Neue E-Mail trifft ein
↓
App sucht nach neuen E-Mails
↓
Passt zu deiner Regel
↓
Lead gespeichert
↓
In deinem CRM angezeigt
Jede E-Mail wird genau einmal verarbeitet, auch wenn die App erneut prüft.
In der Vorschau bietet dir deine App die Schaltfläche Sync now. Nach der Veröffentlichung sucht sie selbstständig alle paar Minuten nach neuen E-Mails.
Anhänge speichern
Rechnungen, Belege und Dokumente kommen oft als Anhänge.
Zum Beispiel:
PDF-Rechnungen aus den Anhängen von E-Mails in meinem Posteingang speichern und auf einer Invoices-Seite mit Absender und Datum auflisten.
Anhänge stehen nur dir als Postfachinhaber zur Verfügung, nachdem du dich in der App angemeldet hast. Sie werden als Dateien heruntergeladen, statt im Browser geöffnet zu werden.
KI-Zusammenfassungen, Labels und Antwortentwürfe
Gmail arbeitet gut mit einem KI-Connector wie OpenAI, Anthropic, Google Gemini oder xAI zusammen.
Zum Beispiel:
Jeden Morgen meine ungelesenen E-Mails zusammenfassen, mit Labels versehen und mir eine kurze Übersicht senden.
Oder:
Antworten auf Support-E-Mails entwerfen, die ich prüfe. Ich bearbeite und sende jede Antwort selbst.
condoo.Vibe erstellt diese Funktionen mit festen Grenzen:
- Die KI liest die E-Mail und gibt eine Kategorie, eine Zusammenfassung oder einen Entwurf zurück. Sie kann nichts senden, weiterleiten oder löschen.
- Kategorien stammen aus einer festen Liste, sodass eine E-Mail kein eigenes Label erfinden kann.
- Labels in Gmail selbst erfordern den Zugriff Manage inbox.
- Nichts, was die KI schreibt, wird automatisch gesendet. Du siehst den Entwurf, bearbeitest ihn und klickst auf Send.
- Die App weist dich darauf hin, dass für diese Funktionen E-Mail-Text an deinen KI-Anbieter gesendet wird.
Benachrichtigungen per SMS
Manche E-Mails können nicht warten.
Wenn zusätzlich Twilio verbunden ist, könntest du Folgendes anfragen:
Wenn eine E-Mail von einem unserer Kunden mit „dringend“ im Betreff eintrifft, mir eine SMS mit Absender und Betreff senden.
Die Benachrichtigung enthält nur Absender und Betreff, niemals den Text der E-Mail.
Eine private Posteingangsseite
Du kannst dir auch einen Posteingang innerhalb deiner App einrichten.
Zum Beispiel:
Eine Inbox-Seite hinzufügen, die nur ich sehen kann. Meine neuesten E-Mails mit Suchfunktion anzeigen und mich im selben Thread antworten lassen.
Postfachinhalte werden ausschließlich dir angezeigt. Deine App prüft, ob du als Postfachinhaber angemeldet bist, bevor sie eine E-Mail anzeigt. Eine App ohne Anmeldung zeigt überhaupt keine E-Mails an, sondern verarbeitet sie nur auf dem Server.
E-Mails werden mit blockierten externen Bildern angezeigt, sodass das Öffnen einer Nachricht dem Absender nicht verrät, dass du sie gelesen hast.
Kontaktaufnahme und Nachfass-E-Mails
Gmail kann persönliche Kontaktaufnahmen in kleinem Rahmen von deiner eigenen Adresse senden, mit strengen Grenzen:
- Nur an Personen, die zugestimmt haben, von dir zu hören
- Ein Empfänger pro E-Mail, niemals eine lange An- oder Bcc-Liste
- Standardmäßig höchstens 50 E-Mails pro Tag, mit mindestens 10 Sekunden Abstand
- Eine Abmeldezeile in jeder E-Mail und eine Opt-out-Liste, die vor jedem Versand geprüft wird
- Höchstens zwei Nachfass-E-Mails, mit mindestens drei Tagen Abstand und nur, wenn keine Antwort eingegangen ist
Um Antworten zu erkennen, ist der Zugriff Read and send erforderlich.
Du prüfst und startest jede Kampagne selbst. Nichts, was eine KI geschrieben hat, wird ohne diese Prüfung gesendet.
Datenschutz und Sicherheit
Der Gmail-Connector ist so konzipiert, dass dein Postfach dir gehört:
- Dein Client secret und die Gmail-Verbindung bleiben auf dem Server deiner App und erreichen nie den Browser eines Besuchers.
- Deine App schreibt niemals E-Mail-Texte, Betreffzeilen oder Adressen in ihre Logs.
- E-Mails werden nur dir als Postfachinhaber angezeigt.
- Beim Trennen der Verbindung wird auch der Zugriff deiner App bei Google entfernt.
Du kannst den Zugriff außerdem jederzeit auf der Seite für Drittanbieterverbindungen in deinem Google-Konto prüfen und entfernen.
Zugriff ändern, neu verbinden oder trennen
Auf der Gmail-Connector-Seite:
- Change access lässt dich eine höhere Zugriffsstufe wählen und dich erneut bei Google anmelden.
- Update client ersetzt die Client ID oder das Client secret. Eine neue Client ID erfordert erneut Connect with Google; ein neues Secret für denselben Client behält die Verbindung bei.
- Disconnect entfernt die Verbindung und den Zugriff deiner App bei Google.
Um die Zugriffsstufe zu senken, klicke zuerst auf Disconnect und verbinde dich dann erneut mit der niedrigeren Stufe. Google behält jede erteilte Berechtigung, bis die Verbindung entfernt wird.
Häufige Probleme
Google zeigt "redirect_uri_mismatch" an
Die Weiterleitungs-URI in deinem Google-Client stimmt nicht überein. Kopiere die Authorized redirect URI erneut von der Gmail-Connector-Seite und füge sie in deinem Client exakt wie angezeigt unter Authorized redirect URIs ein. Stell sicher, dass der Client-Typ Web application ist.
Google meldet, dass der OAuth-Client nicht gefunden wurde
Die Client ID ist falsch oder gehört zu einem gelöschten Client. Kopiere sie erneut aus Google Cloud und verwende dann Update client.
Google zeigt "Access blocked" an
Die Audience deiner App ist nicht für dein Konto eingerichtet. Veröffentliche die App, sodass der Status "In production" lautet, oder füge dein Konto unter Audience als Testnutzer hinzu.
Gmail trennt die Verbindung nach ein paar Tagen
Die App befindet sich höchstwahrscheinlich noch im Status Testing, in dem Google Verbindungen nach 7 Tagen beendet. Veröffentliche sie und verbinde dich dann erneut.
Eine Verbindung endet auch, wenn du dein Google-Passwort änderst, wenn du den Zugriff der App in deinem Google-Konto entfernst oder nach sechs Monaten ohne Nutzung.
Die App fordert dich auf, dich mit mehr Zugriff erneut zu verbinden
Die Funktion benötigt eine höhere Zugriffsstufe als die gewählte, oder auf dem Berechtigungsbildschirm von Google wurde ein Häkchen nicht gesetzt. Verwende Change access, wähle die Stufe, die die Funktion benötigt, und setze bei jeder Gmail-Option ein Häkchen.
Neue E-Mails werden nicht erfasst
Prüfe, ob die Zugriffsstufe Read and send oder Manage inbox ist. Klicke in der Vorschau auf Sync now. Die automatische Suche nach neuen E-Mails läuft nur in der veröffentlichten App.
Für heute werden keine E-Mails mehr gesendet
Deine App hat möglicherweise ihr tägliches Versandlimit erreicht. Am nächsten Tag sendet sie wieder. Verwende für größere Mengen Resend.
Gmail-Fehler untersuchen
Eine gute Anfrage im Debug-Modus könnte so aussehen:
Erwartet: Wenn jemand das Kontaktformular absendet, soll ich eine E-Mail von meinem Gmail-Konto erhalten.
Tatsächlich: Die Anfrage wird in der App gespeichert, aber es kommt keine E-Mail an.
Gmail wird mit dem Zugriff Send only als verbunden angezeigt.
Fehler: [FEHLER EINFÜGEN, FALLS VORHANDEN]
Den Gmail-Teil des Ablaufs untersuchen, ohne zu ändern, wie Anfragen gespeichert werden.
Füge dein Client secret niemals in einen Prompt ein.
Den Gmail-Ablauf testen
Teste vor der Veröffentlichung:
- Die Test-E-Mail von der Gmail-Connector-Seite
- Ob Benachrichtigungen die richtige Adresse erreichen
- Ob Antworten an die richtige Person gehen
- Ob neue E-Mails genau einmal erfasst werden
- Ob Anhänge korrekt heruntergeladen werden
- Ob nur du Postfachinhalte sehen kannst
- Ob KI-Entwürfe auf deine Freigabe warten
- Tageslimits und Abmeldungen bei der Kontaktaufnahme
- Den Hinweis zum erneuten Verbinden bei zu geringem Zugriff
Ein guter Gmail-Prompt
Eine gute Anfrage legt fest:
- Auslöser: Was soll den Ablauf starten?
- Zugriff: Sendet er nur, oder liest er deinen Posteingang?
- E-Mails: Welche E-Mails sind relevant, nach Absender, Betreff oder Inhalt?
- Datensätze: Was soll in deiner App gespeichert werden?
- Sichtbarkeit: Wer kann das Ergebnis sehen?
- Freigabe: Welche E-Mails benötigen vor dem Senden deine Prüfung?
Zum Beispiel:
Neue E-Mails in meinem Posteingang, in denen jemand ein Angebot anfragt, in Leads verwandeln. Name, E-Mail-Adresse, Unternehmen und Nachricht des Absenders speichern. Die Leads auf einer Seite anzeigen, die nur ich sehen kann, und mich auf jeden Lead von meinem Gmail-Konto aus im selben Thread antworten lassen. Mit KI einen Antwortentwurf für mich erstellen, ihn aber niemals senden, bevor ich ihn bearbeitet und auf Send geklickt habe.
Das ist deutlich aussagekräftiger als:
Gmail hinzufügen.
Als Nächstes: Twilio
E-Mail ist nicht immer der beste Weg, Menschen zu erreichen.
Als Nächstes sehen wir uns Twilio an. Damit können Anwendungen, die du mit condoo.Vibe erstellst, SMS-Nachrichten senden.