Telegram-AI-Chatbot für Gruppen und DMs ohne Code bauen

Ein Telegram-AI-Chatbot beantwortet Fragen anhand deines Unternehmenswissens in Gruppen und privaten Gesprächen. Quickchat AI verbindet einen AI Agent über einen gemeinsamen Bot mit Telegram: Füge ihn einer Gruppe hinzu und bestätige die Verbindung im Dashboard. Mitglieder können den Bot dann erwähnen und Fragen stellen. Dafür brauchst du weder Code noch einen BotFather-Token.

Diese Anleitung baut Saltmarsh Sailing School auf, eine fiktive Segelschule mit Mitgliedergruppe und privaten Anfragen. Zwei Agents erhalten dieselben Fakten: Saltmarsh Group beantwortet öffentliche Fragen; Saltmarsh Sailing School erfasst private Probestundenanfragen und zieht bei Erstattungen einen Menschen hinzu. Eine Anfrage geht zur Bearbeitung ans Büro und ist keine bestätigte Buchung.

Zwei Agents trennen die Zuständigkeiten. Der Gruppen-Agent besitzt keine Übergabe- oder Erfassungs-Action; der private Agent bearbeitet Anfragen und Antworten des Teams.

Folge dem Ablauf unten. Die Erweiterung um Google Sheets ist optional; du kannst zunächst Antworten und die Übergabe an Menschen einrichten.

Lade das Saltmarsh-Telegram-Paket herunter. Es enthält das genaue Wissen, den Main Prompt, die Action-Konfiguration, Bewertungskriterien und Testnachrichten. Die Dateien lassen sich für die folgenden Schritte bearbeiten; sie sind kein Agent-Import mit einem Klick.

Die ausführbaren Vorlagen, Testnachrichten und Screenshots bleiben auf Englisch, damit du die gezeigten Ergebnisse reproduzieren kannst. Auch die Bezeichnungen der Bedienelemente entsprechen der englischen App.

Was brauchst du, um einen Telegram-Chatbot zu erstellen?

Du brauchst ein Konto bei Quickchat AI, zwei Agents und ein Telegram-Konto, das einer Testgruppe einen Bot hinzufügen darf. Für die optionale Erfassung von Anfragen brauchst du außerdem ein Google-Konto, das Google Sheets autorisieren kann.

1. Erstelle ein Konto bei Quickchat AI und bestätige bei Bedarf deine E-Mail-Adresse. Free unterstützt persönliches, nicht kommerzielles Lernen. Tarife gelten pro Agent; ein Unternehmen, das beide Agents nutzt, benötigt daher für beide passende kommerzielle Tarife. Preview und Simulation verbrauchen AI-Credits. Siehe die aktuellen Tarife.
2. Erstelle eine Telegram-Gruppe namens Saltmarsh Members. Verwende eine Testgruppe, um Erwähnungen, Schweigen und Folgemeldungen zu prüfen, bevor du Kunden einlädst.
3. Verwende für die Anleitung dein eigenes Telegram-Konto, auch für die Nachrichten des Besuchers. Du kannst zugleich die Inbox von Quickchat AI bedienen. Bitte vor dem Einladen von Kunden einen Kollegen, den Ablauf mit einem anderen Konto zu prüfen.
4. Entpacke das Paket. Halte die Beispieldaten der Schule zusammen und ersetze sie vor dem Einsatz durch deine eigenen geprüften Richtlinien.

Die Screenshots der Quickchat App zeigen eine lokal laufende App mit der fiktiven Saltmarsh-Konfiguration; Beispieldaten für Verbindungen sind in den Bildunterschriften gekennzeichnet. Die Screenshots aus Telegram und Google Sheets zeigen die tatsächlichen Antworten und die gespeicherte Anfrage der verbundenen Demo. Persönliche Kontodaten sind ausgeschnitten oder ausdrücklich verdeckt. Wiederhole die Prüfungen mit der abschließenden Liste, deinem eigenen Wissen und deinen verbundenen Konten.

Schritt 1: Wie bringst du dem Telegram-Chatbot dein Unternehmenswissen bei?

Hinterlege Unternehmensfakten in der Knowledge Base und Verhaltensanweisungen im Main Prompt. Diese Trennung erleichtert es, eine Antwort zu korrigieren, ohne das Verhalten des Agent zu verändern.

Preise und Richtlinien sind Quellenwissen. Kürze, Umgang mit Unsicherheit und Weiterleitung sind Anweisungen.

Agent erstellen und Wissen hinzufügen

1. Wähle in einem neuen Konto Set up manually. Wähle in einem bestehenden Konto zuerst Add new AI Agent und anschließend die manuelle Einrichtung.
2. Trage auf Identity unter Name your AI Agent den Namen Saltmarsh Group ein. Füge group-main-prompt.txt aus dem Paket in Describe what you want your agent to do ein.
3. Fahre mit der Einrichtung fort, ohne externe Apps zu verbinden. Schließe die Tarifauswahl ab; nutze Skip for now, wenn du mit dem Lernkonto beginnst.
4. Öffne Knowledge Base > Add Article. Trage Courses and trial enquiries unter Create custom article ein, wähle Create article, füge saltmarsh-courses.txt in Content ein und klicke auf Save.
5. Wiederhole dies mit Weather, parking and personal enquiries und der Datei saltmarsh-policies.txt. Warte, bis beide Artikel Ready anzeigen.
6. Öffne Actions & MCPs für Saltmarsh Group. Lasse Human Handoff deaktiviert und füge die Action für Probestundenanfragen nicht hinzu.
7. Wähle Add new AI Agent und wiederhole die manuelle Einrichtung für Saltmarsh Sailing School mit main-prompt.txt und denselben beiden Wissensdateien. Dieser zweite Agent übernimmt private Gespräche. Wähle vor jeder Änderung im Kontowechsler den vorgesehenen Agent aus.

Zwei kurze Quellen zeigen klar, welche Fakten der Agent kennt. Ready ist der Prüfpunkt vor einem Wissenstest.

Neoprenanzugverleih fehlt absichtlich. Die richtige Antwort lautet, dass der Agent dies nicht bestätigen kann, statt ein Ja oder Nein zu erfinden. Ebenso liefert die Wetterregel keine aktuelle Vorhersage, und der Preis einer Privatstunde legt keinen Probestundenpreis fest.

Main Prompt festlegen und eine Antwort prüfen

1. Öffne bei jedem Agent Identity > Main Prompt und prüfe den zugehörigen Saltmarsh-Prompt. Der Gruppen-Prompt beantwortet allgemeine Fragen und verweist auf den angehefteten privaten Link; der private Prompt erfasst Anfragen und nutzt Human Handoff.
2. Öffne AI Preview und frage How much is Start Sailing?. Prüfe, ob zwei Tage und 240 EUR genannt werden.
3. Frage Do you rent wetsuits?. Prüfe, ob die Antwort die fehlende Information offen benennt.

Der Prompt des privaten Agent legt Erfassung und Übergabe fest. Der Gruppen-Agent verwendet einen eigenen Prompt und hat beide Actions deaktiviert.

Zwei Ausschnitte aus den echten Einstellungen des Gruppen-Agent. Er beantwortet Wissensfragen, besitzt aber keine Action zur Erfassung oder Übergabe.

Zwei Agents machen die Weiterleitung eindeutig. Der Gruppen-Agent kann keine Übergabe versehentlich auslösen; der private Agent kann eine Erstattungsanfrage weitergeben, ohne die Gruppe zu pausieren. Preview prüft die Fakten der Schule; die nächsten Schritte prüfen die beiden Telegram-Verbindungen.

Schritt 2: Wie fügst du den AI-Chatbot einer Telegram-Gruppe hinzu?

Öffne External Apps > Telegram, füge den gemeinsamen Bot deiner Gruppe hinzu und bestätige die Gruppe anschließend in Quickchat AI mit Confirm. Bis zu dieser Bestätigung bleibt der Agent dort still.

Die Telegram-Mitgliedschaft und die Bestätigung in Quickchat AI sind getrennte Schritte.

1. Wähle Saltmarsh Group im Agent-Wechsler. Öffne External Apps, wähle Telegram und suche Quickchat AI bot.
2. Wähle Add to a Telegram group. Wähle in Telegram Saltmarsh Members und bestätige das Hinzufügen des Bot.
3. Kehre zu Quickchat AI zurück. Prüfe unter Waiting for your confirmation den Gruppennamen und die Angaben unter Added by.
4. Wähle für die erwartete Gruppe Confirm. Sie sollte mit eingeschaltetem Schalter unter Connected chats erscheinen.
5. Tippe in Telegram @ und wähle den Bot aus der Erwähnungsliste. Frage How much is Start Sailing?. Der gemeinsame Bot heißt normalerweise @QuickchatAI_bot; verwende den tatsächlich in deiner Gruppe angezeigten Benutzernamen.
6. Antworte direkt auf diese Antwort mit What should I bring?. Sende anschließend eine separate Nachricht ohne Erwähnung: Does anyone know the gate code?. Der gemeinsame Bot sollte die direkte Antwort beantworten und bei der normalen Nachricht schweigen.

Wähle Saltmarsh Members in Telegram und kehre danach zu Quickchat AI zurück, um die Verbindung zu bestätigen.

Echte lokale Oberfläche mit vorbereiteten Gruppen-Beispieldaten zeigt die Position von Confirm. Das veranschaulicht die Bedienung und belegt keinen Beitritt zu einer echten Telegram-Gruppe.

Die bestätigte Gruppe erhielt die erwartete Kursantwort. Erwähne den Bot mit seinem tatsächlichen Benutzernamen.

Eine direkte Antwort auf die Bot-Nachricht funktioniert ohne erneute Erwähnung. Die Antwort nennt die bereitgestellten Ausrüstungsinformationen.

Die Bestätigung ist wichtig, weil die Einladungsdaten in der Gruppe erscheinen. Quickchat AI verlangt eine Entscheidung im Konto, bevor die Gruppe als Ziel deines Agents gilt. Bestätige keine unbekannte Gruppe. Die Dokumentation zur Telegram-Verbindung erklärt diese Grenze ebenfalls.

Schließe diese Bestätigung ab, bevor du die Einrichtung verlässt. Wenn der Bot eine unbestätigte Gruppe verlässt, erstelle über Add to a Telegram group einen neuen Link, füge ihn erneut hinzu und bestätige die wartende Gruppe sofort in Quickchat AI. Den Bot über die Mitgliedersuche in Telegram hinzuzufügen, ersetzt diesen Verbindungsablauf nicht.

Das Abzeichen Admin zeigt den Status des Bot in Telegram. Es ist für normale Antworten des gemeinsamen Bot nicht erforderlich. Auch als Admin antwortet dieser weiterhin nur auf Erwähnungen oder direkte Antworten.

Schritt 3: Wie aktivierst du private Telegram-Chats?

Aktiviere Direct message link und teile die vollständig erzeugte URL. Der Link wählt deinen Agenten innerhalb des gemeinsamen Telegram-Bot aus. Kunden können dadurch privat fragen, ohne ihn einer Gruppe hinzuzufügen.

Die Gruppe ist ein gemeinsames Gespräch. Persönliche Angaben und Übergaben an Mitarbeiter gehören in private Nachrichten.

1. Wähle den privaten Agent Saltmarsh Sailing School. Öffne External Apps > Telegram und aktiviere Direct message link. Lasse seine Gruppenverbindungen leer.
2. Kopiere den erzeugten Link einschließlich des Parameters start=. Ein bloßer Link zum gemeinsamen Bot identifiziert deinen Agenten nicht.
3. Öffne ihn in Telegram und drücke bei Bedarf Start.
4. Frage How much is Start Sailing?, ohne den Bot zu erwähnen. Prüfe die Antwort der Schule und finde das Gespräch in Inbox.
5. Hefte den Link in der Begrüßungsnachricht deiner Gruppe an, damit Mitglieder ihn vor der Weitergabe persönlicher Informationen finden.

Verwende den für deinen eigenen Agent erzeugten Link. Die gezeigte lokale Konfiguration belegt keine tatsächliche Telegram-Zustellung.

Telegram hat die Saltmarsh-Begrüßung nach Start zugestellt. Prüfe als Nächstes eine Wissensantwort; die Begrüßung allein testet den Wissensabruf nicht.

Zwei Ausschnitte desselben Telegram-Fensters zeigen die angeheftete Einladung. Der start-Wert des Demo-Links ist ausgelassen; hefte deinen eigenen vollständig erzeugten Link an.

Ein privater Chat mit dem gemeinsamen Bot ist jeweils an einen Agent gebunden. Der Direktnachrichten-Link eines anderen Agent kann diese Zuordnung ändern. Für eine eigene Telegram-Identität und einen separaten Bot-Thread nutze die Einrichtung eines eigenen Bot.

Das Ausschalten von Direct message link verhindert neue Verbindungen über diesen Link. Um einen bestehenden Chat zu stoppen, verwende dessen Schalter oder Disconnect. Der Link ist ein öffentlicher Einstieg, keine Zugriffsbeschränkung für vertrauliches Wissen.

Schritt 4: Wie speicherst du eine Probestundenanfrage in Google Sheets?

Die Integration von Google Sheets erstellt eine Tabelle und eine Action zum Anhängen von Zeilen. Passe sie an, um drei Pflichtfelder einer Probestundenanfrage zu erfassen, und prüfe anschließend die echte Zeile. Dieser optionale Schritt funktioniert mit dem gemeinsamen Telegram-Bot.

Das Ergebnis ist eine Anfrage zur persönlichen Bearbeitung. Es reserviert keinen Platz und legt keinen Probestundenpreis fest.

Sheets verbinden und eine Action einrichten

1. Öffne für Saltmarsh Sailing School den Pfad Actions & MCPs > Add Action > Google Sheets und wähle Connect Google Sheets. Melde dich im vorgesehenen Google-Konto an und genehmige den angeforderten Zugriff.
2. Öffne die erstellte Tabelle Quickchat Leads. Behalte den Tabnamen Leads, weil die erzeugte Action-URL diesen Tab adressiert.
3. Ersetze die Kopfzeile in dieser Reihenfolge durch Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Öffne Actions & MCPs und bearbeite die erzeugte Action log_lead_to_google_sheet. Verwende die folgende Konfiguration. Ändere Parameter, Request-Body und Tabellenüberschriften gemeinsam, damit ihre Positionen übereinstimmen.

API Action Name

Record trial-lesson request

What to ask the user first

Setze alle drei Parameter auf No default und entferne die voreingestellten Parameter für E-Mail und Anliegen. Diese drei Felder sind die einzigen Fragen dieser Konfiguration. Ein Telegram-Benutzername ist optional und kein verlässliches Pflichtkontaktfeld; der gespeicherte Gesprächslink führt das Team zur Anfrage zurück.

Methode und URL: Behalte die erzeugte POST-URL. Sie enthält bereits deine Tabellen-ID, den Tab Leads und valueInputOption=RAW. Du musst keinen Platzhalter für eine Tabellen-ID ausfüllen.

Header: Behalte die Konfiguration der Integration.

Verwende im Tab Body des API Endpoint Folgendes:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Füge bei Bedarf über Add AI Data die Chips für Parameter und Gesprächsvariablen ein. Die ersten drei Werte stammen aus dem Gespräch; die letzten beiden liefert Quickchat AI.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

Öffne Advanced settings > Run only when und füge telegram_chat_type equals private hinzu. Verwende den reinen Metadatenschlüssel ohne metadata_ oder Klammern. Das verhindert HTTP-Anfragen für Gruppennachrichten, selbst wenn das Modell sie versucht. Die Dokumentation zu Ausführungsbedingungen erklärt diese Prüfung.

Setze Response filter auf $.updates.updatedRows, damit die Action die Zeilenzahl statt einer unnötigen Anbieterantwort zurückgibt. Lasse die Action aktiviert.

Der reine Schlüssel lautet telegram_chat_type. Die Bedingung wird vor dem Senden der Anfrage geprüft.

Lokale Konfiguration der Anfrage. Die erzeugte Sheets-URL und die OAuth-Autorisierung müssen aus deiner eigenen Google-Verbindung stammen.

Zeile prüfen und anschließend unvollständige Anfrage testen

Sende dies über den privaten Telegram-Link des Agent:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Prüfe alle drei Stellen: Die Antwort beschreibt eine Anfrage, die Action-Karte in Inbox zeigt die übergebenen Werte und der echte Tab Leads enthält die passende Zeile. Weder eine beruhigende Antwort noch ein hoher Simulation-Wert beweist einen Schreibvorgang in Google Sheets.

Der Agent hat den angegebenen Namen, den Wunschtag Dienstag und die Erfahrung als Anfänger erfasst. Verfügbarkeit und genauer Preis müssen noch vom Büro bestätigt werden.

Zwei Ausschnitte derselben gespeicherten Zeile machen alle fünf Spalten lesbar. Der kontospezifische Gesprächslink ist verdeckt; die anderen vier Werte sind unverändert.

Starte einen separaten Test mit I would like a trial lesson. Der Agent sollte vor der Action nacheinander nach fehlenden Feldern fragen. Teste außerdem How much is Start Sailing?; eine normale Kursfrage darf keine Zeile erzeugen. Der Prompt fordert einen Schreibvorgang pro Anfrage, doch diese Anhänge-Konfiguration ist kein idempotentes Buchungssystem. Prüfe Duplikate vor dem operativen Einsatz.

Schritt 5: Wie übergibst du ein Telegram-Gespräch an einen Menschen?

Konfiguriere Human Handoff und prüfe anschließend die Gesprächszuweisung in Inbox. Ein Prompt mit „Das Büro antwortet“ überträgt allein weder die Zuständigkeit noch pausiert er die AI.

Der Prüfpunkt ist die geänderte Zuweisung. Lass einen Menschen den Fall abschließen und prüfe eine Rückgabe an die AI separat.

1. Wähle Saltmarsh Sailing School, öffne Actions & MCPs > Human Handoff und aktiviere es. Lasse diese Action für Saltmarsh Group ausgeschaltet.
2. Wähle unter Handoff Rules das Zeichen +. Trage Private enquiries als Rule Name ein, füge handoff-rule.txt in Description ein und aktiviere State. Neue Zeilen sind zunächst inaktiv. Die Regel erfasst Erstattungen, Beschwerden, Wünsche nach einer Person und die Annahme menschlicher Hilfe bei diesem privaten Agenten.
3. Leere für dieses Beispiel Keywords und deaktiviere die vordefinierten Regeln. Lasse nur die eigene Regel aktiv und speichere. Die Gruppe bleibt getrennt, weil Human Handoff beim separaten Gruppen-Agent deaktiviert ist; die eigene Regel bestimmt die Übergabe beim privaten Agent.
4. Setze Confirmation auf I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Konfiguriere Human Agents’ availability für die tatsächlichen Arbeitszeiten deines Teams und hinterlege eine ehrliche Nachricht für Zeiten außerhalb dieser Abdeckung.
5. Sende im privaten Telegram-Chat I want a refund for last week. Can I speak to a person?.
6. Finde das Gespräch in Inbox, prüfe die Zuweisung, wähle Assign to me und sende Hi, I’m Alex from the office. I’ll review your request. Prüfe den Empfang in Telegram.
7. Sende eine weitere Kundennachricht, während der Mensch das Gespräch betreut. Die AI sollte schweigen. Lass den Mitarbeiter den Fall beenden und in Inbox abschließen. Behandle die Rückgabe an die AI als separaten Test.

State ist für die eigene Regel eingeschaltet. Vordefinierte Auslöser sind aus; dadurch ist nur eine Regel zu prüfen.

Die echte Telegram-Anfrage löste Handoff aus. Die Inbox-Zuweisung und die ausgehende Antwort des Mitarbeiters wurden separat geprüft.

Im Live-Test wechselte das Gespräch zu Unassigned und stand damit zur Übernahme bereit. Der Mitarbeiter wählte Assign to me, schickte die Antwort des Büros, und Telegram nahm sie an. Der Screenshot oben zeigt die Übergabeantwort, nicht die spätere Nachricht des Mitarbeiters. Prüfe beim Wiederholen des Tests sowohl Zuweisung als auch Zustellung.

Lass den Fall bis zur Lösung beim Mitarbeiter. In unserem lokalen Erstattungstest ermöglichte die Rückgabe an AI Agent eine Antwort, bevor Handoff erneut ausgelöst wurde. Die Rückkehr zur AI braucht einen eigenen erfolgreichen Folgetest und gehört nicht zu den Abschlusskriterien dieses Ablaufs. Der Leitfaden zur menschlichen Übergabe erläutert Personalplanung und Zuständigkeit genauer.

Schritt 6: Wie testest du den vollständigen Telegram-Chatbot?

Nutze Testing für wiederholbare Antwortprüfungen und prüfe danach echte Telegram-Wege und externe Auswirkungen getrennt. Ein Modell kann korrekt antworten, während Gruppenverbindung, Tabelleneintrag oder Zustellung nach der Übergabe noch fehlerhaft sind.

Prüfe das zuständige System: Wissen für Fakten, Action-Logs für Anfragen, Sheets für Zeilen und Telegram für die Zustellung.

Einen wiederholbaren Antwortdatensatz ausführen

1. Öffne Testing, erstelle einen Datensatz namens Saltmarsh: knowledge checks und wähle Paste messages.
2. Füge simulation-messages.txt ein. Behalte die alleinstehenden Trennzeichen --- zwischen den Fällen.
3. Öffne Evaluation criteria, füge evaluation-criteria.txt aus dem Paket ein und speichere.
4. Wähle Run > Start Run und prüfe neben den Bewertungen auch die einzelnen Antworten.

Behalte dieselben Fragen bei, wenn du eine Anweisung änderst. So bleibt der Vergleich aussagekräftig.

Lies die Antworten zusätzlich zur Bewertung. Das sind lokale Wissenstests, keine Telegram-Zustelltests.

Der Evaluator braucht die Fakten der Schule, um die Richtigkeit zu beurteilen. Er muss auch wissen, dass das Transkript weder eine Tabellenzeile noch Telegram-Zustellung oder eine Zuweisungsänderung belegen kann. Die normale Text-Simulation liefert keine Telegram-Chat-Metadaten. Eine auf private Chats beschränkte Action-Bedingung ist daher bei fehlenden Metadaten nicht automatisch defekt. Prüfe kanalabhängiges Verhalten im echten privaten Chat.

Was haben die lokalen Tests verändert?

Der erste Entwurf verwendete einen Agent für beide Zugänge. Ein lokaler Test zeigte, dass eine Erstattungsanfrage in der Gruppe das gemeinsame Gespräch an Human Handoff übergab. Wir trennten die Agents und deaktivierten auf dem Gruppen-Agent sowohl Handoff als auch die Actions zur Anfrageerfassung. Bei den wiederholten Gruppenprüfungen zu Erstattungen und Probestunden verwies der Agent auf den angehefteten privaten Link und blieb für das Gespräch zuständig. Deshalb trennt Schritt 1 die beiden Gespräche durch Konfiguration und Anweisungen.

Die zehn abschließenden lokalen Wissensprüfungen erhielten jeweils 5/5 Punkte, und beide gehosteten Agents bestanden dieselben zehn Fälle. Diese kleinen Testläufe sind keine Schätzung der Genauigkeit im Produktivbetrieb. Auch die echte Gruppe beantwortete die Preis- und Packlistenfragen und bestätigte anschließend keinen Neoprenanzugverleih. Behalte diese Fälle mit fehlenden Fakten bei, wenn du das Paket anpasst; richtige Preisantworten allein prüfen die Zurückhaltung des Agents nicht.

Fehlendes Wissen führt zu „kann ich nicht bestätigen“. Die separate Nachricht zum Torcode spricht den Bot nicht an; auf diesem Screenshot ist keine Antwort darauf sichtbar.

Die echte private Anfrage nach einer Probestunde führte zu einem erfolgreichen Sheets-Action-Aufruf mit Alex Morgan, Tuesday und beginner. Google lieferte HTTP 200 und eine aktualisierte Zeile zurück; die gespeicherte Zeile enthielt außerdem den Gesprächslink und den Kanal telegram. Ein separater Action-Test mit Gruppenchat-Metadaten sendete keine HTTP-Anfrage. Prüfe beim Anpassen der Bedingung sowohl die akzeptierte private Anfrage als auch den abgewiesenen Gruppenkontext.

Kanal und Auswirkungen prüfen

Trage deine eigenen Beobachtungen in die leere test-matrix.csv des Pakets ein. Die Screenshots oben zeigen die nachgewiesenen Ergebnisse; die Tabelle enthält auch Prüfungen für deine eigene Konfiguration. Notiere bei Schweigetests die verstrichene Zeit und prüfe die menschliche Übernahme getrennt von einer späteren Rückgabe an die AI.

Ändere bei einem Fehlschlag eine relevante Einstellung und wiederhole dieselbe Nachricht. Ergänze fehlende Fakten in der Knowledge Base, korrigiere zu frühe Action-Aufrufe in Beschreibung oder Pflichtparametern und prüfe bei einer stillen Gruppe zuerst Bestätigung und Ansprache. Bewahre das fehlerhafte Ergebnis auf, damit die Verbesserung erkennbar bleibt.

Wann solltest du mit BotFather einen eigenen Bot erstellen?

Erstelle einen eigenen Telegram-Bot, wenn du einen eigenen Namen und ein Bild, Telegram-Bot-API-Actions oder den Empfang normaler Gruppennachrichten brauchst. Für die oben beschriebenen Gruppen- und Privatantworten genügt der gemeinsame Bot.

Wähle Identität und Nachrichtenverhalten, bevor du einen zweiten Bot hinzufügst.

1. Öffne das verifizierte BotFather-Konto in Telegram und sende /newbot.
2. Wähle einen Anzeigenamen und anschließend einen freien Benutzernamen, der auf bot endet. BotFather liefert einen Token. Halte ihn geheim.
3. Wähle Saltmarsh Group, wenn dieser Bot einer Gruppe beitreten soll. Verwende Saltmarsh Sailing School ausschließlich für private Chats. Öffne unter External Apps > Telegram den Bereich Your own bot und wähle Connect to Telegram.
4. Füge den Token in Bot Token ein und schließe die Verbindung ab. Prüfe, ob Enable your own bot eingeschaltet ist.
5. Öffne den Telegram-Link des Bot und sende /start, danach dieselbe Kurspreisfrage.
6. Für normale Gruppennachrichten verwende in BotFather /setprivacy, wähle deinen Bot und Disable. Entferne ihn anschließend aus der Testgruppe und füge ihn wieder hinzu. Ein Admin-Bot erhält ebenfalls normale Nachrichten. Die Dokumentation zum Datenschutzmodus erklärt Telegrams Zustellregeln.

Füge den Token nur in Bot Token ein. Das leere Feld verhindert, dass Zugangsdaten veröffentlicht werden.

Halte gemeinsamen und eigenen Bot in getrennten Gruppen. Beide in einer Gruppe können doppelte Antworten erzeugen. Wenn du Ankündigungen anheften oder Mitglieder moderieren möchtest, folge der separaten Anleitung zur Telegram-Gruppenverwaltung samt den Action-Bedingungen für Administratoren.

Können ChatGPT oder Claude bei der Einrichtung des Telegram-Chatbot helfen?

Eine verbundene App zur Verwaltung deines Kontos bei Quickchat AI kann Agents erstellen, Wissen hinzufügen, unterstützte Einstellungen konfigurieren und Tests ausführen. Wenn der Client die Telegram-Einrichtung unterstützt, kann er den Direct message link des gemeinsamen Bots aktivieren. Gruppenauswahl und Bestätigung im Dashboard bleiben Aufgaben des Kontoinhabers. Manche Clients benötigen das Dashboard auch für die Aktivierung des Direktlinks und die Einstellungen von Human Handoff. Lass den Assistenten daher zuerst seine verfügbaren Tools prüfen.

Verbinde das Quickchat AI-Plugin für ChatGPT oder den Claude-Connector und übergib die Dateien des Pakets mit diesem Prompt:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

Verfügbare Tools hängen vom Client und den Kontoberechtigungen ab. Nutze zur Anmeldung die Dokumentation zur Kontoverwaltung. Dadurch erhält ein Assistent Zugriff auf dein Konto bei Quickchat AI; ein persönlicher ChatGPT- oder Claude-Chat wird nicht zum gehosteten Backend deines Telegram-Bots.

Warum antwortet der Telegram-Chatbot nicht?

Prüfe Verbindung und Nachrichtenweg, bevor du den Prompt umschreibst. Diese Symptome haben unterschiedliche Ursachen.

Ersetze vor Kundeneinladungen die fiktiven Fakten, prüfe die Trennung von Gruppe und Privat-Chat und besetze die Übergabewarteschlange. Bitte einen Kollegen, die öffentlichen Zugänge vor dem Start mit einem anderen Konto zu prüfen. Die Discord-Chatbot-Anleitung zeigt einen vergleichbaren Aufbau mit Tests für einen anderen Community-Kanal. Für Charaktergespräche nutze den Telegram-Rollenspiel-Leitfaden.

Optionale Einrichtungsprüfungen: Vergleiche Bereitstellungsmethoden anhand deiner angegebenen Anforderungen oder Antworten je Credit-Budget anhand eines vorgegebenen Budgets. Diese Rechner prüfen weder dein Konto noch deine Website oder dein Guthaben.

Saltmarsh-Konfiguration zum Kopieren

Hier stehen die vollständigen Quellenfakten und Anweisungen dieser Anleitung. Der Download enthält zusätzlich die Action-Konfiguration, Bewertungskriterien und Tests.

Gruppen-Agent: Main Prompt

Füge dies bei Saltmarsh Group in Identity > Main Prompt ein. Lasse Human Handoff und eigene Actions für diesen Agent deaktiviert.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Privater Agent: Main Prompt

Füge dies bei Saltmarsh Sailing School in Identity > Main Prompt ein. Der Name der Action muss mit der Konfiguration übereinstimmen.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

Wissen: Kurse und Probestundenanfragen

Füge dies in das Feld Content des ersten Wissensartikels ein.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

Wissen: Richtlinien und Mitgliederinformationen

Füge dies in das Feld Content des zweiten Artikels ein.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Regel für Human Handoff

Füge dies unter Human Handoff > Handoff Rules ein und konfiguriere die tatsächliche Verfügbarkeit.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

Häufig gestellte Fragen

Wie füge ich einer Telegram-Gruppe einen AI-Chatbot hinzu?

Öffne in Quickchat AI External Apps, wähle Telegram und Add to a Telegram group. Wähle deine Gruppe in Telegram und bestätige sie danach in Quickchat AI mit Confirm. Mitglieder können Fragen stellen, indem sie den gemeinsamen Bot erwähnen oder auf seine Nachrichten antworten.

Beantwortet ein Telegram-AI-Chatbot jede Nachricht?

Der gemeinsame Bot von Quickchat AI beantwortet Gruppennachrichten, die ihn erwähnen oder auf ihn antworten. Normale Gruppenunterhaltungen lösen keine Antwort aus. Dein eigener Bot kann normale Gruppennachrichten erhalten, wenn Telegrams Datenschutzmodus deaktiviert oder der Bot Admin ist. Teste dies in einer separaten Gruppe.

Brauche ich BotFather oder einen Telegram-Bot-Token?

Für den gemeinsamen Bot und seinen Direktnachrichten-Link brauchst du weder BotFather noch einen Token. Erstelle mit BotFather einen eigenen Bot, wenn du einen eigenen Telegram-Namen und ein Bild oder Actions für die Telegram Bot API brauchst. Normale Actions für Google Sheets funktionieren auch mit dem gemeinsamen Bot.

Können Kunden dem Telegram-Chatbot privat schreiben?

Ja. Aktiviere Direct message link in Quickchat AI und teile den vollständigen erzeugten Link. Ein Kunde öffnet ihn und drückt bei Bedarf Start. Der Link wählt deinen Agenten im gemeinsamen Bot aus. Das Ausschalten verhindert neue Verbindungen; bestehende private Chats haben eigene Schalter zum Aktivieren und Trennen.

Ist ein Telegram-AI-Chatbot kostenlos?

Ein mit BotFather erstellter Bot enthält noch keinen AI-Dienst. Quickchat AI bietet Free zum persönlichen, nicht kommerziellen Lernen mit begrenzten AI-Credits. Kommerzielle Nutzung erfordert einen kostenpflichtigen Tarif. Antworten, Preview und Simulation verbrauchen AI-Credits; externe Dienste können weitere Kosten verursachen.

Gibt es AI-Chatbots in Telegram?

Telegram unterstützt AI-Bots und AI-Integrationen von Drittanbietern. Diese Anleitung verbindet einen Quickchat AI Agent, der aus deinem eigenen Unternehmenswissen antwortet. BotFather erstellt die Bot-Identität; es liefert weder dieses Wissen noch die Konfiguration deiner Kundenbetreuung.

Kann der Chatbot Fotos und Dateien verstehen?

Die Telegram-Integration kann Fotos empfangen und ihren visuellen Inhalt analysieren. Andere Dateien können als Anhänge im Gespräch ankommen, ihr Inhalt wird jedoch nicht automatisch gelesen. Teste die tatsächlichen Dateitypen deiner Kunden und prüfe sowohl Telegram als auch Inbox.

Kann ich einen Telegram-Rollenspiel- oder Charakter-Bot erstellen?

Ja. Dieselbe Telegram-Verbindung kann einen Agenten mit Charakteridentität und passenden Anweisungen bedienen. Diese Anleitung nutzt ein Support-Beispiel für Unternehmen; ein Rollenspiel-Agent braucht eigene Prompts und Tests.