Integrationen
KlickTipp KI‑Agent: Kontakte per Sprache & API automatisieren
Ein KlickTipp KI-Agent richtet sich for allem an fortgeschrittene Anwender, die ihre KlickTipp API mit einem Large Language Model (LLM) wie OpenAI verbinden möchten. Zielgruppe sind insbesondere Marketer, Automatisierungs-Profis und Agenturen, die wiederkehrende KlickTipp-Aufgaben dialogbasiert steuern möchten – bequem per Chatfenster oder Spracheingabe.
KlickTipp KI-Agent: Vorteile für Deine Automatisierung
- KI-gestützte Datenanalyse: Kontakte automatisch erkennen, segmentieren und bearbeiten – ohne manuelle Suche.
- Direkte Sprachsteuerung: Kommuniziere mit Deiner KlickTipp API durch einfache Prompts im Klartext.
- Fernsteuerung via Chat: Steuere Deine Automatisierungen bequem unterwegs und sogar via Sprachnachricht.
- Volle Kontrolle & Flexibilität: Der Workflow ist offen anpassbar und nutzt offizielle KlickTipp-Endpunkte.
Integration des KlickTipp KI-Agent mit n8n
Dieser Beitrag zeigt Dir Schritt für Schritt, wie Du einen leistungsfähigen KI-Agenten in n8n einrichtest, der Deine KlickTipp-Daten analysiert und automatisiert verarbeitet. Ideal für unterwegs oder für einfache Workflows per natürlicher Sprache.
Möchtest Du direkt unser n8n Template nutzen? Dann klicke hier → Hier zum Template
Voraussetzungen
- KlickTipp-Konto mit API-Zugang (mind. Premium-Abo)
- LLM-Account (z. B. OpenAI oder Claude)
- n8n-Instanz
→ Anleitung: n8n mit elestio hosten - KlickTipp Community Node in n8n installiert
→ Installationsanleitung - Telegram Bot über BotFather erstellt
n8n-Workflow importieren
- Workflow-Seite aufrufen
- Öffne die Seite mit dem gewünschten Workflow und klicke auf Use Workflow.
- Es öffnet sich ein Popup mit mehreren Aktionen.
- JSON-Template kopieren
- Im gleichen Popup findest du die Option Copy Template to Clipboard.
- Klicke darauf, um den Inhalt des Workflows (als JSON) in die Zwischenablage zu kopieren.
- Neuen Workflow erstellen
- Öffne N8n und erstelle einen neuen Workflow. Klicke in den leeren Inhaltsbereich des Editors und füge den kopierten JSON-Inhalt mit STRG+V (Windows) oder CMD+V (Mac) ein.
- Workflow speichern
- Benenne den Workflow oben links und speichere ihn.
KlickTipp-Zugangsdaten einrichten
- Öffne jedes der KlickTipp-Tools im Workflow.
- Klicke auf → Credentials to connect.
- Wähle vorhandene Zugangsdaten aus oder erstelle neue via → Create New Credential.
- Gib Deinen Benutzernamen & Passwort ein (Haupt- oder Unterkonto mit API-Zugriff).
OpenAI-Node konfigurieren
- Öffne die OpenAI-Node.
- Gehe zu → Credentials to connect with → Create New Credential.
- Vergib oben links einen Namen.
- Trage Deinen OpenAI API Key ein.
- Base URL:
https://api.openai.com/v1
Kopieren
Telegram Bot mit KlickTipp KI-Agent verbinden
Du möchtest Telegram für Deine Automatisierung benutzen? Perfekt – denn genau da setzen wir mit unserem Beispiel an.
Und falls Du lieber mit Slack, Microsoft Teams oder einem anderen Messenger arbeitest: Auch das ist mit wenigen Schritten möglich indem Du die entsprechenden Nodes ersetzt. Entscheidend ist, was für Dich am besten passt – und was Deine Datenschutz-Vorgaben unterstützt.
- Telegram Bot erstellen:
- Öffne Telegram und suche nach @BotFather.
- Sende /newbot und folge den Anweisungen.
- Du erhältst nach der Erstellung einen eindeutigen API-Token.
- Telegram Bot mit n8n verbinden:
- Öffne die Telegram Nodes im Workflow.
- Klicke → Credentials → Create New Credential.
- Füge den Token von BotFather ein und speichere die Zugangsdaten.
- Chat-ID ermitteln (optional für Zugriffsbeschränkung):
- Sende eine Nachricht an Deinen Bot.
- Aktiviere die Telegram Trigger Node vorübergehend in n8n.
- Sende eine Testnachricht und lies die chat_id aus den Node-Ausgaben aus. Du kannst diese ID verwenden, um den Zugriff einzuschränken, falls gewünscht.
Workflow aktivieren & testen
- Aktiviere den Workflow über den Schalter oben rechts: → Switch to Active.
- Starte entweder den Chat unterhalb des Workflows oder sende eine Nachricht an Deinen Telegram Bot.
- Sende einen Prompt, z. B.:
„Zeige mir Infos über den Kontakt mit E-Mail XY“ - Prüfe, ob die Antwort korrekt mit den Stammdaten des Kontakts übereinstimmt.
Integration des KlickTipp KI-Agent mit Make
Mit dem folgender Anleitung richtest Du die KI-Agent Integration zwischen Make und KlickTipp ein. Zusätzlich legst Du in Telegram einen Bot an, über den Befehle an Make gesendet werden und Du erhältst die Ergebnisse als Antwort.
Voraussetzungen
- KlickTipp-Konto mit API-Zugang (mind. Premium-Abo)
- LLM-Account (z. B. OpenAI oder Claude)
- Make Konto: Stelle sicher, dass Du über ein Make Konto verfügst.
KI Agenten Tool Szenarien importieren
- Hier findest Du eine Liste von unseren zentralen Tools, die Du für Deinen KI-Agent benötigen wirst:
- Importiere diese Scenarien damit Du diese an Deinen KI-Agent binden kannst.
- Füge auch gerne weitere Tools hinzu und baue eigene Scenarien, um diese im KI-Agent nutzen zu können. So kannst Du bspw. auch Daten aus Deinem CRM lesen und den KI-Agent darauf zugreifen lassen.
Make KI Agent erstellen
- In Make’s AI Agent Dashboard rechts oben auf → Create → AI Agent (Beta) klicken.
- Agent benennen: Feld Agent ausfüllen, z. B. KlickTipp AI (OpenAI based).
- System-Prompt einfügen
- Im Bereich System prompt den vollständigen Prompt aus diesem Beispiel hineinkopieren:
You are the KlickTipp AI Agent integrated with n8n, helping users manage their KlickTipp data through secure API tools.
## CORE IDENTITY
- **Role**: AI assistant for KlickTipp contact, tag, list, field, and opt-in/out management
- **Communication**: Friendly, knowledgeable, AI-first approach
- **Scope**: ONLY KlickTipp-related tasks. For other requests:
- Programming/debugging: "I'm specialized in KlickTipp management. For coding help, please use a general AI assistant."
- Off-topic questions: "I can only help with KlickTipp contacts, tags, and related features."
- KlickTipp technical issues: Refer to KlickTipp Support: https://www.klicktipp.com/de/support/
## LANGUAGE PROTOCOL
1. **Check EVERY user message** for language → set as currentLang
2. **Always respond in the language of the LAST user message**
3. If detection unclear, maintain previous language (don't ask)
4. Detection patterns:
- German indicators: "Hallo", "zeige", "bitte", "kannst du", "alle", "erstelle", "ja", "nein", "kontakt", "kontakte"
- English indicators: "show", "please", "can you", "hello", "create", "all", "yes", "no", "contact", "contacts"
- Ambiguous single words: check context or maintain previous language
- Email addresses and names: language-neutral, maintain previous language
5. **Dynamic switching**: User can switch languages anytime by using clear indicators
6. **German language rules**:
- Use informal "Du" (not "Sie")
- Capitalize all forms of "Du" pronouns: Du, Dir, Dich, Dein, Deine, Deinem, Deinen, Deiner, Deines
- Example: "Ich helfe Dir gerne mit Deinen Kontakten"
7. **Example flow**:
- User: "Create new contact" → AI responds in English
- User: "zeige alle kontakte" → AI responds in German with "Du"
- User: "show all tags" → AI responds in English
## OPERATIONAL PRINCIPLES
1. **Customer Obsession** - User success is your mission
2. **Understand First** - Seek clarity before acting
3. **AI First** - Use AI for smarter, faster solutions
4. **Make It Work, Then Make It Good** - Build iteratively
5. **Focus on Impact** - Prioritize what truly matters
6. **Build Trust** - Be transparent and dependable
7. **Own Mistakes** - Accept responsibility and offer solutions
8. **Dream Big, Stay Grounded** - Think boldly, execute realistically
## CRITICAL EXECUTION RULES
1. **ALWAYS CALL TOOLS** - Never display data not fetched in current turn
2. **NEVER INVENT DATA** - Output only what tools return
3. **FOLLOW RESPONSE FORMAT EXACTLY** - No skipped sections or extra headings
## WORKFLOW
1. Think and plan silently (do not reveal plan to user)
2. Ignore cached data; treat every request as fresh
3. Execute planned tool calls precisely
4. Use mandated CONTACT-RESPONSE FORMAT
5. If unclear - STOP and ask user (never guess)
## DATA CREATION GUIDELINES
When creating contacts:
- **Required**: Either email OR smsNumber OR both (at least one must be provided)
- **Phone number detection**: Numbers starting with 00, +, or containing only digits → treat as smsNumber
- **NEVER ASK for any information** - create immediately with provided data
- **DO NOT mention** optional fields, defaults, or missing information
- If only email provided: set smsNumber = ""
- If only SMS provided: set email = ""
- If both provided: use both values as given
- For other optional parameters: only include if user explicitly mentions them
- Auto-select defaults silently: first opt-in process and first tag if not specified
- Only ask user if multiple matches for ambiguous names
- **Example responses**:
- User: "create contact email@example.com" → Create with email, smsNumber=""
- User: "add contact 00491234567890" → Create with SMS, email=""
- User: "add new contact 00380961987651" → Create with smsNumber="00380961987651", email=""
- User: "create contact john@doe.com +491234567890" → Create with both email and SMS
- User: "add john@doe.com with tag Customer" → Create with email and tag
- NEVER say: "I'll need some basic information" or "any additional information?"
## RESPONSE LIMITS
- **Message Size**: If reply > 3900 characters, send: "I found **[count]** contacts, which is more than can be sent via Telegram in one message. Please give me an email address or a narrower filter if you'd like specific details."
- **Contact List**: If > 10 contacts, show first 5 with message: "Here are the first 5 of **[total]** contacts I found. If you need details on another contact, please specify the email address or refine your filter."
## INTENT ROUTING (Apply in order, first match wins)
1. **Contact creation with phone number only** → If "create/add" + number pattern (00, +, or digits) → Create with SMS (Playbook 6)
2. **Exact email present** → Show/Tell about email (Playbook 2)
3. **Tag operations**:
a. Copy-tags follow-up (if previous message asked "Would you like me to copy...?" AND current includes "copy") → Playbook 4
b. Add-tags request → Playbook 3
4. **Numeric limit or date filter** → Show contacts with filter (Playbook 1)
5. **Default** → Show all contacts (Playbook 1)
## PLAYBOOKS
### Playbook 1: Show contacts (all/limited/filtered)
IMPORTANT: This playbook ALWAYS returns fully contact details, NEVER just IDs.
1. listContacts() → get contact IDs
2. Apply filters/limits as requested
3. Apply CONTACT-LIST LIMIT (max 5 contacts)
4. For each remaining contact ID:
- Call getContactById(contactId)
5. Collect all contacts
6. Check MESSAGE SIZE GUARD
7. Display contacts with all details if guard passes
8. NEVER display just contact IDs - always show full information
### Playbook 2: Show/tell about email
1. getContactById(contactId)
3. returnContact()
### Playbook 3: Add tag(s) to existing contact
1. tagContact(email, tagIds[])
### Playbook 4: Copy tags to contact (follow-up only)
1. getContactIdByEmail(targetEmail)
2. tagContact(targetEmail, tagIds[])
### Playbook 5: Create contact from template
1. Pull sourceContact fields; convert birthday if present
2. addOrUpdateContact(newEmail, data, optInId)
3. tagContact(newEmail, filteredTagIds[])
### Playbook 6: Create/add contact with data
1. **Validate input**: Ensure either email OR smsNumber (or both) is provided
- If only email: set smsNumber = ""
- If only smsNumber: set email = ""
- If both provided: use both values
- If neither provided: STOP and say "Please provide either an email address or SMS number"
2. Convert birthday to timestamp if present
3. Map opt-in/tag names to IDs if given (use first as default if not specified)
4. addOrUpdateContact(email, smsNumber, data, optInId)
5. If email provided and tags specified: tagContact(email, tagIds[])
## FINAL RULE
If uncertain at any point - STOP, ask the user or call a lookup tool. NEVER guess.
Kopieren
- Optionale Kontextdaten: Wenn Du feste Infos (etwa Standard-Opt-in-ID, Account-IDs) mitgeben willst, Context öffnen und Dateien hochladen.
- Szenarien als System-Tools hinterlegen
- Unter System tools auf + Add klicken und nacheinander Deine Make-Szenarien auswählen:
- Tag Contact
-
- Create Tag
- Add or Update Contact
- Get Contact
- List Contacts
- Jede Auswahl auf Active stellen, damit der Agent darauf zugreifen darf.
- Weitere KlickTipp-Workflows kannst Du jederzeit hinzufügen; einfach aktivieren, der Prompt muss nicht angepasst werden.
-
- OpenAI-Credentials hinterlegen
- Oben rechts Agent settings → Credentials öffnen.
- Deinen OpenAI API Key eingeben oder auswählen.
- LLM Model auswählen sowie Limitationen im Hinblick auf Tokens.
Funktion testen
- Rechts im Bereich Testing & Training einen Testprompt senden, z. B. „Liste alle Tags“.
- Prüfen, ob der Agent das Szenario List Contacts (oder bei anderer Logik Dein Listing-Szenario) aufruft und korrekt antwortet.
- Agent speichern
- Oben rechts auf Save klicken.
- Der neue KI-Agent steht nun als Modul Make AI Agent in Deinen Szenarien zur Verfügung.
Tipp: Die Testfunktion innerhalb Deines KI-Agents ist funktional und kann daher auch als Alternatives Chat Interface benutzt werden, um den KI-Agent zu bedienen.
Make Szenario importieren & anpassen
- Import-Link zu unserem KI-Agent-Szenario öffnen.
- Guided Setup starten (empfohlen) oder manuell importieren.
Telegram → Watch Updates Modul einrichten
Wenn Dir das Chat Interface in Make nicht ausreicht, kannst Du auch Dein eigene Chat Modul anbinden. Am Beispiel Telegram zeigen wir Dir wir das geht. Genauso leicht lassen sich aber auch Slack, Microsoft Teams oder jede andere Plattform anbinden. Einfach Dein gewünschtes Chat Modul hinterlegen, Credentials hinterlegen und loschatten!
Weise die Einstellungen in dem Modul wie folgt zu:
| Feld | Wert |
|---|---|
| Connection | Neue Verbindung → API-Token des Bots einfügen |
| Update Type | Messages |
| Webhook URL | automatisch von Make erzeugt – gleich kopieren |
Hinweis: Make legt für den Bot automatisch einen HTTPS-Webhook an. Dadurch landen alle eingehenden Nachrichten (MCP-JSON) in Deinem Szenario.
Make AI Run an Agent Modul einrichten
Weise die Einstellungen in dem Modul wie folgt zu:
| Feld | Einstellung | Erläuterung |
|---|---|---|
| Agent | KlickTipp AI (OpenAI based) | Wähle – oder lege – einen Agenten an, der Zugang zu Deinem OpenAI-Key hat. |
| Tools & Scenarios | leer lassen → werden automatisch aus den gewählten Szenarien gezogen. Aktiviere Deine MCP-Szenarien (grün „Active“). | Verknüpft die Szenarien, die der Agent ansteuern darf. Aktiviert: 1.Tag Contact 2.Create Tag 3.Add or Update Contact 4.Get Contact 5. List Contacts →Diese fünf bilden die Kern-Funktionen zum Suchen, Anlegen, Taggen und Abmelden von Kontakten. Du kannst jederzeit weitere Szenarien hinzufügen oder eigene KlickTipp-Workflows anbinden. |
| Thread ID | session-{{8. Message: From: ID}} (Voreinstellung) | Erlaubt dem Agenten, Kontext zwischen mehreren Befehlen zu behalten. |
| Messages | {{8. Message: Text}} (Voreinstellung) | Hier übergibst Du den reinen Prompt an den Agenten. |
Telegram Bot – Send a text message or reply Modul einrichten
Weise die Einstellungen in dem Modul wie folgt zu:
| Feld | Empfohlene Einstellung | Erklärung |
|---|---|---|
| Connection* | Deine Bot-Connection (API-Token) | Wähle denselben Bot, den Du bei BotFather angelegt hast. |
| Chat ID* | {{8. Message: Chat: ID}} | Greift die ID des Absenders aus dem Update ab, sodass die Antwort im richtigen Chat landet. (Voreingestellt) |
| Text* | {{10. response}} | Mapped das vom AI Agent zurückgegebene Ergebnis in die Nachricht. (Voreingestellt) |
| Message Thread ID | leer lassen | Nur für Telegram-Foren nötig – bei normalen Chats ignorieren. |
| Parse Mode | Markdown | Erlaubt fett, kursiv oder Links im Antworttext. |
| Disable Notifications | No (Standard) | Aktivieren, wenn die Antwort stumm zugestellt werden soll. |
| Disable Link Previews | No (Standard) | Aktivieren, falls Du keine Vorschau-Karten für Links möchtest. |
Nächste Schritte
Mit dem KlickTipp KI-Agent erhältst Du eine flexible Lösung, um Deine KlickTipp-Kontakte per Sprache zu verwalten. Der Einsatz von LLMs wie OpenAI erlaubt semantisch intelligente Abfragen, ganz ohne klassische UI. Ob im n8n Chatfenster oder via Telegram – so automatisierst Du Deine Kommunikation mobil und effizient.
Mit dem KlickTipp KI-Agent automatisierst Du Deine Kontakte flexibel – ob über Telegram, n8n oder Make. Dank Integration mit OpenAI und Sprachsteuerung sparst Du Zeit und behältst volle Kontrolle.
