n8n ist ein Open-Source-Tool zur Workflow-Automatisierung, mit dem du Apps verbinden und Aufgaben über einen visuellen Editor automatisieren kannst. Durch die Kombination von n8n mit der öffentlichen Zeeg-API lassen sich automatisierte Abläufe aufbauen, die auf bestimmte Ereignisse reagieren – zum Beispiel kann ein KI-Anruf ausgelöst werden, sobald eine neue Kontaktanfrage in deinem Posteingang landet. Dieses Tutorial zeigt dir ein vollständiges Beispiel: Eine eingehende Kontaktanfrage per E-Mail führt dazu, dass ein Zeeg KI-Agent den Interessenten automatisch anruft, qualifiziert und einen Termin vereinbart.
Dieser Workflow erfordert ein kostenpflichtiges Zeeg-Abonnement (Professional oder höher) sowie ein n8n-Abonnement. Der Zeeg KI-Agent wird separat abgerechnet – basierend auf der Anzahl der konfigurierten Telefonnummern, der geführten Anrufe und der verbrauchten Gesprächsminuten.
Kontaktiere unser Support-Team, um deinen KI-Agenten einzurichten und mehr Informationen zu erhalten.
Bevor du anfängst
Stelle sicher, dass folgendes vorhanden ist, bevor du den Workflow erstellst:
Ein Zeeg-Konto mit einem kostenpflichtigen Abonnement
Mindestens ein aktivierter KI-Agent in deinem Zeeg-Konto
Ein n8n-Konto (Cloud oder selbst gehostet)
Ein Gmail-Konto, das mit n8n verbunden ist
Die Benutzeroberfläche von n8n ist derzeit ausschließlich auf Englisch verfügbar. Alle Schaltflächen und Menübezeichnungen in diesem Artikel, die sich auf n8n beziehen, sind daher auf Englisch angegeben. Die Screenshots in diesem Tutorial sind entsprechend ebenfalls auf Englisch.
Schritt 1: KI-Agenten in Zeeg einrichten
Bevor du n8n konfigurierst, musst du einen KI-Agenten in Zeeg erstellen und veröffentlichen. Dieser Agent übernimmt die ausgehenden Anrufe, sobald der Workflow ausgelöst wird.
1. Gehe im Zeeg-Dashboard zum Bereich AI Agents. Falls du noch keinen Kontakt zu unserem Support-Team hattest, buche über die Schaltfläche Termin vereinbaren einen Termin.
2. Sobald alles eingerichtet ist, klicke auf + Neu erstellen (“+ Create new”).
3. Vergib einen Titel und klicke auf Erstellen (“Create”).
4. Weise dem Agenten eine Telefonnummer zu oder bestelle eine neue.
5. Wähle deine bevorzugte Sprache und Stimme und richte bei Bedarf eine E-Mail-Benachrichtigung ein.
6. Schreibe einen Begrüßungstext für ausgehende Anrufe – das ist das, was der KI-Agent sagt, wenn der Interessent abnimmt.
7. Wähle einen Standard-Prompt. Für diesen Anwendungsfall eignet sich Scheduling assistant.
8. Klicke auf Weiter und verbinde den Agenten mit einer bestehenden Terminseite. Alle Fragen, die dieser Terminseite zugeordnet sind, werden vom Agenten während des Gesprächs gestellt.
9. Klicke auf Veröffentlichen, um den Agenten zu aktivieren.
Hinweis: Notiere dir die Agent-ID aus der URL in deinem Browser. Du wirst sie in einem späteren Schritt benötigen.
Schritt 2: n8n mit Gmail verbinden
1. Melde dich in deinem n8n-Konto an.
2. Klicke im Dashboard auf das Gmail-Symbol, um dein Gmail-Konto zu verbinden.
3. Melde dich mit Google an und autorisiere n8n, in deinem Namen handeln zu dürfen.
4. Nach erfolgreicher Autorisierung wirst du zurück zum n8n-Dashboard weitergeleitet.
Schritt 3: Neuen Workflow erstellen
1. Klicke im n8n-Dashboard auf Start from scratch.
2. Klicke im Workflow-Editor auf Add first step und suche nach dem Gmail-Trigger, der auf eingehende Nachrichten wartet.
3. Lege die Polling-Frequenz fest (zum Beispiel alle 5 Minuten).
4. Füge einen Filter hinzu, um die richtigen Nachrichten zu erfassen – ähnlich wie Gmail-Suchfilter.
5. Klicke auf Fetch Test Event, bis die erwartete Nachricht im rechten Bereich erscheint.
Schritt 4: Daten verarbeiten
1. Processor-Node hinzufügen: Gehe zurück zum Workflow-Editor und füge nach dem Gmail-Trigger einen Processor hinzu. Du kannst zwischen Edit Fields für eine einfache Feldzuordnung oder dem Information Extractor wählen, wenn deine Daten komplexer sind und von einer KI-gestützten Analyse profitieren.
Ziel ist es, die Ausgabe als JSON-Payload zu formatieren, die der Zeeg API entspricht.
2. Felder per reguläre Ausdrücke zuordnen: Eine einfache Feldzuordnung ist in den meisten Fällen ausreichend. In diesem Beispiel verwenden wir regular expressions, um Name, E-Mail-Adresse und Telefonnummer aus der eingehenden E-Mail zu extrahieren.
Nachfolgend ein Beispiel der verwendeten regulären Ausdrücke und des erwarteten API-Payloads:
Regular expressions
// Vorname
{{ $json.From.split('<')[0].trim().split(/\s+/).slice(0, -1).join(' ') }}
// Nachname
{{ $json.From.split('<')[0].trim().split(/\s+/).slice(-1)[0] }}
// E-Mail-Adresse
{{ $json.From.match(/<([^>]+)>/)[1] }}
// Telefonnummer (aus E-Mail-Text)
{{ $json.snippet.match(/(?:\+|00|0)\d{6,}/)[0] }}
Erwarteter Payload
{
"phoneNumber": "+4915XXXX896",
"fullName": "Fabian Reese",
"email": "fabian.reese@mail.com",
"additionalData": "Rückruf für interessierten Kunden",
"scheduledTime": "2026-03-09 19:30:00"
}
Schritt 5: API-Token in Zeeg erstellen
Damit n8n mit der Zeeg API kommunizieren kann, musst du in deinem Zeeg-Konto ein Access Token generieren.
1. Gehe in deinem Zeeg-Dashboard auf Organisationseinstellungen und wähle im Menü unter Verbindungen den Punkt API-Tokens.
2. Klicke auf + API-Token erstellen.
3. Vergib einen aussagekräftigen Namen und weise dem Token die Berechtigung Ausgehende Anrufe schreiben zu.
4. Bestätige die Erstellung und kopiere das Token – bewahre es an einem sicheren Ort auf, da du es im nächsten Schritt benötigst.
Schritt 6: API-Aufruf an Zeeg senden
Der letzte Schritt in n8n besteht darin, eine HTTP-Anfrage an die Zeeg API zu senden, um den ausgehenden Anruf auszulösen.
1. Füge deinem Workflow einen HTTP Request-Node hinzu.
2. Setze die Methode auf POST. Verwende folgenden Endpunkt und ersetze dabei :agentUuid durch die Agent-ID aus Schritt 1:
https://api.zeeg.me/v1/agents/:agentUuid/outbound-calls
3. Wähle unter Authentication die Option Bearer Auth und füge das in Zeeg erstellte API-Token ein.
4. Füge folgende Header hinzu:
Accept: application/json
Content-Type: application/json
5. Setze den Request Body auf den JSON-Payload aus dem vorherigen Schritt.
6. Klicke auf Execute step, um den Aufruf zu testen. Eine erfolgreiche Antwort bestätigt, dass die Einrichtung funktioniert.
Sobald alles reibungslos läuft, speichere deinen Workflow und vergib einen Namen.
Was passiert, wenn der Workflow ausgeführt wird
Sobald der Workflow aktiv ist, läuft bei jeder neuen Kontaktanfrage in Gmail folgender Ablauf ab:
Der KI-Agent tätigt den Anruf — Der Agent stellt sich mit dem von dir konfigurierten Begrüßungstext vor. Wenn der Interessent gesprächsbereit ist, stellt der Agent Qualifizierungsfragen und bucht direkt einen Termin.
Der Anruf wird protokolliert — Nach dem Gespräch wird der Anruf in deinem Zeeg-Konto gespeichert. Wenn die Transkription in den Datenschutzeinstellungen deines KI-Agenten aktiviert ist, wird auch eine vollständige Gesprächsabschrift erstellt.
Der Termin wird angelegt — Das Meeting wird automatisch in deinem Zeeg-Kalender eingetragen. Du kannst die Termindetails einsehen und im Zeeg CRM weitere Informationen zum neuen Lead ergänzen.
Häufige Fragen
Brauche ich Programmierkenntnisse? Grundkenntnisse in JSON und regulären Ausdrücken sind für den Datenverarbeitungsschritt hilfreich, aber der visuelle Editor von n8n ermöglichen es, dass du keinen Backend-Code schreiben musst.
Kann ich einen anderen E-Mail-Anbieter statt Gmail verwenden? Dieses Tutorial verwendet Gmail, aber n8n unterstützt viele weitere E-Mail-Anbieter. Die grundlegende Logik – Kontaktdaten extrahieren und die Zeeg API aufrufen – bleibt unabhängig vom verwendeten E-Mail-Trigger gleich.
Was passiert, wenn keine Telefonnummer aus der E-Mail ausgelesen werden kann? Wenn der reguläre Ausdruck keine Telefonnummer im E-Mail-Text findet, schlägt der Workflow-Schritt fehl. Füge in n8n einen Error Handler hinzu, um solche Fälle abzufangen und zur manuellen Prüfung weiterzuleiten.
Kann ich ausgehende Anrufe auch aus anderen Quellen als E-Mails auslösen? Ja. Jeder n8n-Trigger, der den erforderlichen Payload (Telefonnummer, Name, E-Mail) liefern kann, ist geeignet – etwa eine Formularübermittlung, ein CRM-Ereignis oder eine Slack-Nachricht.