Telegram AI-chatbot bouwen voor groepen en privéchats

Een Telegram AI-chatbot kan vragen beantwoorden op basis van je bedrijfskennis, in een groep of een privégesprek. Quickchat AI verbindt een AI Agent met Telegram via een gedeelde bot: voeg de bot toe aan een groep, bevestig de verbinding in je dashboard en leden kunnen de bot vermelden om een vraag te stellen. Voor deze aanpak heb je geen code of BotFather-token nodig.

In deze handleiding bouwen we Saltmarsh Sailing School, een fictieve zeilschool met een ledengroep en privévragen. Twee Agents gebruiken dezelfde schoolinformatie: Saltmarsh Group beantwoordt openbare vragen, terwijl Saltmarsh Sailing School privéaanvragen voor proeflessen behandelt en een medewerker inschakelt voor terugbetalingen. Een aanvraag is een vraag aan het kantoor, geen bevestigde boeking.

Twee Agents houden de verantwoordelijkheid gescheiden. De groeps-Agent heeft geen overdrachts- of intake-Action; de privé-Agent behandelt aanvragen en antwoorden van medewerkers.

Volg de route hieronder. De uitbreiding met Google Sheets is optioneel; je kunt eerst de antwoorden en overdracht instellen.

Download de Saltmarsh Telegram-kit met de exacte kennis, Main Prompt, Action-instellingen, beoordelingscriteria en testberichten. Dit zijn bewerkbare bestanden voor de onderstaande stappen, geen Agent-import met één klik.

De uitvoerbare bestanden, exacte testberichten en screenshots blijven in het Engels, zodat je de stappen en resultaten kunt reproduceren.

Wat heb je nodig om een Telegram-chatbot te maken?

Je hebt een Quickchat AI-account, twee Agents en een Telegram-account nodig met toestemming om een bot aan een testgroep toe te voegen. Voor de optionele registratie van aanvragen heb je ook een Google-account nodig dat Google Sheets kan autoriseren.

1. Maak een Quickchat AI-account aan en verifieer je e-mailadres als daarom wordt gevraagd. Free ondersteunt persoonlijk, niet-commercieel leren. Abonnementen gelden per Agent, dus een bedrijf dat beide Agents gebruikt heeft voor beide passende commerciële dekking nodig. Preview en Simulation verbruiken AI-credits. Bekijk de huidige abonnementen.
2. Maak een Telegram-groep met de naam Saltmarsh Members. Gebruik een testgroep om vermeldingen, stil blijven en vervolgberichten te controleren voordat je klanten uitnodigt.
3. Gebruik je eigen Telegram-account voor deze handleiding, ook voor de berichten van de bezoeker. Je kunt ook de Inbox van Quickchat AI bedienen. Vraag een collega om de ervaring vanuit een ander account te controleren voordat je klanten uitnodigt.
4. Pak de kit uit. Houd de voorbeeldinformatie van de school bij elkaar; vervang die vóór ingebruikname door je eigen geverifieerde beleid.

De screenshots van de Quickchat App tonen een lokaal draaiende app met de fictieve Saltmarsh-configuratie; voorbeeldgegevens voor verbindingen worden in de bijschriften aangegeven. De screenshots van Telegram en Google Sheets tonen de echte antwoorden en opgeslagen aanvraag van de verbonden demo. Persoonlijke accountgegevens zijn buiten de uitsnede gehouden of uitdrukkelijk afgeschermd. Gebruik de laatste checklist om de controles met je eigen kennis en verbonden accounts te herhalen.

Stap 1: Hoe leer je de Telegram-chatbot je bedrijf kennen?

Geef de Agent bedrijfsfeiten in de Knowledge Base en werkinstructies in de Main Prompt. Door die taken te scheiden kun je een antwoord makkelijker corrigeren zonder het gedrag van de Agent te veranderen.

Prijzen en beleid zijn bronfeiten. Beknoptheid, onzekerheid en routering zijn instructies.

Maak de Agent en voeg kennis toe

1. Kies in een nieuw account Set up manually. Selecteer in een bestaand account eerst Add new AI Agent en kies daarna de handmatige route.
2. Vul op Identity bij Name your AI Agent Saltmarsh Group in. Plak group-main-prompt.txt uit de kit in Describe what you want your agent to do.
3. Doorloop de configuratie zonder al externe apps te verbinden. Rond de abonnementstap af en gebruik Skip for now als je begint met een leeraccount.
4. Open Knowledge Base > Add Article. Vul Courses and trial enquiries in bij Create custom article, selecteer Create article, plak saltmarsh-courses.txt in Content en kies Save.
5. Herhaal dit met Weather, parking and personal enquiries en gebruik saltmarsh-policies.txt. Wacht tot beide artikelen Ready tonen.
6. Open Actions & MCPs op Saltmarsh Group. Laat Human Handoff uitgeschakeld en voeg de Action voor proeflesaanvragen niet toe.
7. Selecteer Add new AI Agent en herhaal de handmatige configuratie voor Saltmarsh Sailing School, met main-prompt.txt en dezelfde twee kennisbestanden. Deze tweede Agent behandelt privégesprekken. Selecteer de bedoelde Agent in de accountkiezer voordat je instellingen wijzigt.

Twee korte bronnen maken duidelijk welke feiten de Agent heeft. Ready is het controlepunt vóór een kennistest.

Informatie over wetsuitverhuur ontbreekt bewust. Het juiste antwoord is dat de Agent dit niet kan bevestigen, in plaats van een verzonnen ja of nee. Ook geeft het weerbeleid geen weersverwachting voor vandaag, en bepaalt de prijs voor een privéles geen proeflesprijs.

Stel Main Prompt in en controleer een antwoord

1. Open Identity > Main Prompt bij elke Agent en controleer de bijbehorende Saltmarsh-prompt. De groepsprompt beantwoordt algemene vragen en verwijst naar de vastgezette privélink in de groep; de privéprompt verzamelt aanvragen en gebruikt Human Handoff.
2. Open AI Preview en vraag How much is Start Sailing?. Controleer of het antwoord twee dagen en EUR 240 vermeldt.
3. Vraag Do you rent wetsuits?. Controleer of het antwoord erkent dat deze informatie ontbreekt.

De prompt van de privé-Agent bepaalt de intake en overdracht. De groeps-Agent gebruikt een aparte prompt en heeft beide Actions uitgeschakeld.

Twee uitsneden uit de echte instellingen van de groeps-Agent. Hij kan kennisvragen beantwoorden, maar heeft geen intake- of overdrachts-Action om uit te voeren.

Twee Agents maken de routering expliciet. De groeps-Agent kan niet per ongeluk een overdracht starten; de privé-Agent kan een terugbetalingsverzoek overdragen zonder de groep te pauzeren. Preview controleert de schoolinformatie, terwijl de volgende stappen elke Telegram-verbinding verifiëren.

Stap 2: Hoe voeg je de AI-chatbot toe aan een Telegram-groep?

Open External Apps > Telegram, voeg de gedeelde bot toe aan je groep en keer terug naar Quickchat AI om Confirm voor de groep te kiezen. De Agent blijft stil in die groep totdat je de verbinding bevestigt.

Lidmaatschap in Telegram en bevestiging in Quickchat AI zijn afzonderlijke stappen.

1. Selecteer Saltmarsh Group in de Agent-kiezer. Open External Apps, selecteer Telegram en zoek Quickchat AI bot.
2. Selecteer Add to a Telegram group. Kies in Telegram Saltmarsh Members en keur het toevoegen van de bot goed.
3. Keer terug naar Quickchat AI. Controleer onder Waiting for your confirmation de groepsnaam en de informatie bij Added by.
4. Selecteer Confirm voor de verwachte groep. Die hoort te verschijnen onder Connected chats, met de inschakelaar aan.
5. Typ in Telegram @ en selecteer de bot uit de vermeldingskiezer. Vraag How much is Start Sailing?. De gebruikersnaam van de gedeelde bot is meestal @QuickchatAI_bot; gebruik de echte gebruikersnaam die in je groep wordt weergegeven.
6. Antwoord rechtstreeks op dat antwoord met What should I bring?. Stuur daarna een los bericht zonder vermelding: Does anyone know the gate code?. De gedeelde bot hoort de reactie te beantwoorden en stil te blijven bij het gewone bericht.

Kies Saltmarsh Members in Telegram en keer terug naar Quickchat AI om de verbinding te bevestigen.

Echte lokale interface met vooraf aangemaakte groepstestgegevens, die toont waar Confirm staat. Dit illustreert de bediening; het bewijst niet dat Telegram een echte groep is binnengegaan.

De bevestigde groep kreeg het verwachte antwoord over de cursus. Vermeld de bot met zijn echte gebruikersnaam.

Reageren op het bericht van de bot werkt zonder een nieuwe vermelding. Het antwoord somt de aangeleverde uitrustingsinformatie op.

Bevestiging is belangrijk omdat de uitnodigingsgegevens in de groep verschijnen. Quickchat AI vereist een beslissing vanuit het account voordat de groep een bestemming voor je Agent wordt. Bevestig geen groep die je niet herkent. De Telegram-verbindingsdocumentatie beschrijft dezelfde grens.

Rond deze bevestiging af voordat je de instellingen verlaat. Als de bot een onbevestigde groep verlaat, maak dan een nieuwe link via Add to a Telegram group, voeg hem opnieuw toe en bevestig de wachtende groep meteen in Quickchat AI. De bot toevoegen via de ledenzoekfunctie van Telegram vervangt deze verbindingsprocedure niet.

Het label Admin geeft de status van de bot in Telegram aan. Die status is niet nodig voor gewone antwoorden van de gedeelde bot. De gedeelde bot beheerder maken verandert de regel voor vermeldingen of reacties ook niet.

Stap 3: Hoe schakel je privéchats in Telegram in?

Schakel Direct message link in en deel de volledige gegenereerde URL. De link selecteert je Agent binnen de gedeelde Telegram-bot, zodat klanten privévragen kunnen stellen zonder de bot aan een groep toe te voegen.

De groep is een gedeeld gesprek. Verplaats persoonlijke gegevens en overdrachten aan medewerkers naar privéberichten.

1. Selecteer Saltmarsh Sailing School, de privé-Agent. Open External Apps > Telegram en schakel Direct message link in. Laat de groepsverbindingen leeg.
2. Kopieer de gegenereerde link. Behoud de parameter start=; een kale link naar de gedeelde bot identificeert je Agent niet.
3. Open de link in Telegram en druk op Start als daarom wordt gevraagd.
4. Vraag How much is Start Sailing? zonder de bot te vermelden. Controleer het antwoord van de school en zoek het gesprek in Inbox.
5. Zet de link vast in het welkomstbericht van je groep, zodat mensen hem vinden voordat ze persoonlijke informatie delen.

Gebruik de link die voor je eigen Agent is gegenereerd. De hier getoonde lokale configuratie is geen bewijs van live bezorging in Telegram.

Telegram bezorgde de Saltmarsh-begroeting na Start. Controleer vervolgens een kennisantwoord; de begroeting alleen test het ophalen van informatie niet.

Twee uitsneden van hetzelfde Telegram-scherm tonen de vastgezette uitnodiging. De start-waarde van de demolink is weggelaten; zet je eigen volledig gegenereerde link vast.

Een privéchat met de gedeelde bot is aan één Agent tegelijk gekoppeld. Het openen van de privélink van een andere Agent kan die koppeling wijzigen. Gebruik voor je eigen Telegram-identiteit en een eigen botgesprek de route met een eigen bot.

Het uitschakelen van Direct message link voorkomt nieuwe verbindingen via die link. Gebruik de schakelaar van een bestaande verbonden chat of Disconnect om die chat te stoppen. Beschouw de link als een openbare ingang, niet als toegangsbeperking voor vertrouwelijke kennis.

Stap 4: Hoe sla je een proeflesaanvraag op in Google Sheets?

De Google Sheets-integratie maakt een spreadsheet en een Action om rijen toe te voegen. Pas die Action aan om drie verplichte aanvraagvelden vast te leggen en controleer daarna de echte rij. Deze stap is optioneel en werkt met de gedeelde Telegram-bot.

Het resultaat is een aanvraag die een persoon moet opvolgen. Er wordt geen plek gereserveerd en geen proeflesprijs vastgesteld.

Verbind Sheets en configureer één Action

1. Open op Saltmarsh Sailing School Actions & MCPs > Add Action > Google Sheets en selecteer Connect Google Sheets. Meld je aan bij het bedoelde Google-account en keur de gevraagde toegang goed.
2. Open de gegenereerde spreadsheet Quickchat Leads. Behoud de tabnaam Leads, omdat de gegenereerde Action-URL naar dat tabblad verwijst.
3. Vervang de koprij, in deze volgorde, door Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Open Actions & MCPs en bewerk de gegenereerde Action log_lead_to_google_sheet. Gebruik de instellingen hieronder. Wijzig parameters, aanvraaginhoud en spreadsheetkoppen samen, zodat hun posities overeenkomen.

API Action Name

Record trial-lesson request

What to ask the user first

Stel alle drie de parameters in op No default en verwijder de standaardparameters voor e-mail en aanvraag. Deze drie velden zijn de enige vragen in deze configuratie. Een Telegram-gebruikersnaam is optioneel en geen betrouwbaar verplicht contactveld; via de vastgelegde gesprekslink kunnen medewerkers terug naar de aanvraag.

Methode en URL: behoud de gegenereerde POST-URL. Die bevat al je spreadsheet-ID, het tabblad Leads en valueInputOption=RAW. Er is geen tijdelijke spreadsheet-ID die je moet invullen.

Headers: behoud de configuratie van de integratie.

Gebruik in het tabblad Body van het API Endpoint:

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

Gebruik Add AI Data om waar nodig chips voor parameters en gespreksvariabelen in te voegen. De eerste drie waarden komen uit het gesprek; Quickchat AI levert de laatste twee.

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.

Open Advanced settings > Run only when en voeg telegram_chat_type equals private toe. Gebruik de metadatasleutel zonder metadata_ of accolades. Dit voorkomt dat het HTTP-verzoek voor een groepsbericht wordt uitgevoerd, zelfs als het model dat probeert. De documentatie over uitvoeringsvoorwaarden legt deze controle uit.

Stel Response filter in op $.updates.updatedRows, zodat de Action het aantal rijen teruggeeft in plaats van een onnodig providerantwoord. Laat de Action ingeschakeld.

De onbewerkte sleutel is telegram_chat_type. De voorwaarde wordt gecontroleerd voordat het verzoek wordt verstuurd.

Lokale configuratie van de aanvraag. De gegenereerde Sheets-URL en OAuth-autorisatie moeten uit je eigen Google-verbinding komen.

Controleer de rij en daarna de onvolledige aanvraag

Stuur dit via de privélink van de Agent in Telegram:

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

Controleer alle drie de plekken: het antwoord beschrijft een aanvraag, de Action-kaart in Inbox toont de opgegeven waarden en het echte tabblad Leads bevat de overeenkomstige rij. Een geruststellend antwoord of een hoge Simulation-score bewijst niet dat Google Sheets een schrijfactie heeft ontvangen.

De Agent legde de opgegeven naam, de voorkeur voor dinsdag en de ervaring als beginner vast. Het kantoor moet de beschikbaarheid en de exacte prijs nog bevestigen.

Twee details van dezelfde opgeslagen rij houden alle vijf kolommen leesbaar. De accountspecifieke gesprekslink is afgeschermd; de andere vier waarden zijn ongewijzigd.

Begin een aparte test met I would like a trial lesson. De Agent hoort de ontbrekende velden één voor één uit te vragen voordat de Action wordt uitgevoerd. Probeer ook How much is Start Sailing?; een gewone cursusvraag mag geen rij maken. De prompt vraagt om één schrijfactie per aanvraag, maar deze toevoegconfiguratie is geen idempotent boekingssysteem. Controleer op dubbele rijen voordat je deze gebruikt voor operationele intake.

Stap 5: Hoe draag je een Telegram-gesprek over aan een persoon?

Configureer Human Handoff en controleer vervolgens de toewijzing van het gesprek in Inbox. Een prompt die zegt dat het kantoor zal antwoorden draagt op zichzelf geen verantwoordelijkheid over en pauzeert de AI niet.

Een gewijzigde toewijzing is het controlepunt. Laat een persoon de zaak afronden; controleer een eventuele terugkeer naar AI afzonderlijk.

1. Selecteer Saltmarsh Sailing School, open Actions & MCPs > Human Handoff en schakel dit in. Laat deze Action uit op Saltmarsh Group.
2. Selecteer bij Handoff Rules het +-teken. Vul Private enquiries in als Rule Name, plak handoff-rule.txt in Description en zet State aan. Nieuwe rijen beginnen inactief. De regel omvat terugbetalingen, klachten, verzoeken om een persoon en het accepteren van menselijke hulp bij deze privé-Agent.
3. Maak Keywords leeg en schakel voor dit voorbeeld de vooraf ingestelde regels uit, zodat alleen de aangepaste regel actief blijft. Sla daarna op. De groep blijft geïsoleerd doordat Human Handoff op de aparte groeps-Agent is uitgeschakeld; de aangepaste regel bepaalt wanneer de privé-Agent moet overdragen.
4. Stel Confirmation in op I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Configureer Human Agents’ availability voor de uren waarin je team daadwerkelijk beschikbaar is en geef een eerlijk bericht voor buiten die uren.
5. Stuur vanuit de privéchat in Telegram I want a refund for last week. Can I speak to a person?.
6. Zoek het gesprek in Inbox, controleer de toewijzing, selecteer Assign to me en stuur Hi, I’m Alex from the office. I’ll review your request. Controleer of het bericht in Telegram aankomt.
7. Stuur nog een klantbericht terwijl de persoon eigenaar van het gesprek is. De AI hoort stil te blijven. Laat de medewerker de zaak afhandelen en in Inbox oplossen. Behandel terugkeer naar AI als een aparte test.

State van de aangepaste regel staat aan. De vooraf ingestelde triggers staan uit, zodat er één regel te controleren is.

Het echte Telegram-verzoek activeerde Handoff. De Inbox-toewijzing en het uitgaande antwoord van de medewerker zijn afzonderlijk gecontroleerd.

Bij de livecontrole ging het gesprek naar Unassigned, klaar om door een medewerker te worden opgepakt. De medewerker selecteerde Assign to me, stuurde het antwoord van het kantoor en Telegram accepteerde het. Het screenshot hierboven toont het overdrachtsantwoord, niet het latere bericht van de medewerker. Controleer zowel de toewijzing als de bezorging wanneer je de test herhaalt.

Laat deze zaak bij de medewerker totdat ze is opgelost. In onze lokale terugbetalingstest maakte teruggave aan AI Agent één antwoord mogelijk voordat Handoff opnieuw werd geactiveerd. Terugkeer naar AI vereist een eigen geslaagde vervolgtest en maakt geen deel uit van de voltooiingscriteria van deze werkwijze. De handleiding voor menselijke overdracht gaat dieper in op bezetting en verantwoordelijkheid.

Stap 6: Hoe test je de volledige Telegram-chatbot?

Gebruik Testing voor herhaalbare antwoordcontroles en controleer daarna de live Telegram-routes en externe effecten afzonderlijk. Een model kan correct antwoorden terwijl de groepsverbinding, spreadsheetregistratie of bezorging bij overdracht nog fout gaat.

Controleer het systeem dat het resultaat beheert: kennis voor feiten, Action-logboeken voor verzoeken, Sheets voor rijen en Telegram voor bezorging.

Voer een herhaalbare dataset met antwoorden uit

1. Open Testing, maak een dataset met de naam Saltmarsh: knowledge checks en kies Paste messages.
2. Plak simulation-messages.txt. Behoud de losse scheidingsregels --- tussen gevallen.
3. Open Evaluation criteria, plak evaluation-criteria.txt uit de kit en sla op.
4. Selecteer Run > Start Run en inspecteer naast de scores ook de afzonderlijke antwoorden.

Behoud dezelfde vragen wanneer je één instructie wijzigt, zodat de vergelijking bruikbaar blijft.

Lees de antwoorden naast de score. Dit zijn lokale kennistests, geen Telegram-bezorgingstests.

De beoordelaar heeft de schoolinformatie nodig om juistheid te beoordelen. Hij moet ook weten dat een transcript geen spreadsheetrij, Telegram-bezorging of gewijzigde toewijzing kan bewijzen. De standaardtekstmodus van Simulation levert geen Telegram-chatmetadata, dus een Action-voorwaarde die alleen privéchats toestaat is niet defect omdat die metadata ontbreekt. Voer kanaalafhankelijke controles uit in de echte privéchat.

Wat hebben de lokale tests veranderd?

Het eerste ontwerp gebruikte één Agent voor beide ingangen. Een lokale test liet zien dat een terugbetalingsverzoek in de groep het gedeelde gesprek naar Human Handoff overdroeg. We scheidden de Agents en schakelden zowel Handoff als de Actions voor het vastleggen van aanvragen uit op de groeps-Agent. Bij herhaling van de groepscontroles voor terugbetalingen en proeflessen verwees de Agent naar de vastgezette privélink, terwijl het gesprek aan AI toegewezen bleef. Daarom gebruikt stap 1 zowel configuratie als instructies om de twee gesprekken te scheiden.

De tien laatste lokale kenniscontroles kregen elk 5/5 en beide gehoste Agents slaagden voor dezelfde tien gevallen. Deze kleine testrondes schatten de nauwkeurigheid in productie niet. De echte groep beantwoordde ook de vragen over de cursusprijs en de paklijst en bevestigde vervolgens de verhuur van wetsuits niet. Behoud deze gevallen met ontbrekende feiten wanneer je het pakket aanpast; correcte prijsantwoorden alleen testen de terughoudendheid van de Agent niet.

Ontbrekende kennis leidt tot ‘kan ik niet bevestigen’. Het aparte bericht over de poortcode richt zich niet tot de bot en er is geen antwoord op te zien in deze opname.

De echte privéaanvraag voor een proefles leidde tot één geslaagde Sheets-Action-aanroep met Alex Morgan, Tuesday en beginner. Google retourneerde HTTP 200 en één bijgewerkte rij; de opgeslagen rij bevatte ook de gesprekslink en het kanaal telegram. Een afzonderlijke Action-test met groepschatmetadata stuurde geen HTTP-verzoek. Controleer bij het aanpassen van de voorwaarde zowel het geaccepteerde privéverzoek als de geweigerde groepscontext.

Controleer het kanaal en de neveneffecten

Gebruik het lege bestand test-matrix.csv uit het pakket om je eigen waarnemingen vast te leggen. De screenshots hierboven tonen de aangetoonde resultaten; de tabel bevat ook controles voor je eigen configuratie. Noteer de verstreken tijd bij het testen van stilte en houd menselijke overname gescheiden van een eventuele latere terugkeer naar AI.

Als een controle mislukt, wijzig dan één relevante instelling en herhaal hetzelfde bericht. Corrigeer een ontbrekend bronfeit in Knowledge Base; corrigeer een te vroege Action-aanroep in de beschrijving of verplichte parameters; controleer bij een stille groep eerst bevestiging en adressering. Bewaar het mislukte resultaat zodat de verbetering zichtbaar is.

Wanneer maak je een eigen bot met BotFather?

Maak een eigen Telegram-bot als je een eigen botnaam en afbeelding, Telegram Bot API Actions of een groep nodig hebt die gewone berichten ontvangt. De gedeelde bot volstaat voor de groeps- en privéantwoorden hierboven.

Kies de identiteit en het berichtgedrag dat je nodig hebt voordat je een tweede bot toevoegt.

1. Open het geverifieerde BotFather-account in Telegram en stuur /newbot.
2. Kies een weergavenaam en daarna een beschikbare gebruikersnaam die eindigt op bot. BotFather geeft een token terug. Houd dit privé.
3. Selecteer Saltmarsh Group als deze bot aan een groep wordt toegevoegd. Gebruik Saltmarsh Sailing School uitsluitend voor privéchats. Open bij External Apps > Telegram Your own bot en selecteer Connect to Telegram.
4. Plak het token in Bot Token en voltooi de verbinding. Controleer of Enable your own bot aan staat.
5. Open de Telegram-link van de bot en stuur /start, gevolgd door dezelfde vraag over de cursusprijs.
6. Wil je gewone groepsberichten ontvangen, gebruik dan /setprivacy in BotFather, selecteer je bot en kies Disable. Verwijder de bot vervolgens uit de testgroep en voeg hem opnieuw toe. Een bot met beheerdersrechten ontvangt ook gewone berichten. De documentatie over de privacymodus van Telegram legt de bezorgingsregels uit.

Plak het token alleen in Bot Token. Het veld wordt leeg getoond zodat geen inloggegeven wordt gepubliceerd.

Houd de gedeelde bot en je eigen bot in afzonderlijke groepen. Beide in één groep gebruiken kan dubbele antwoorden opleveren. Wil je daarna aankondigingen vastzetten of leden modereren, volg dan de aparte handleiding voor Telegram-groepsbeheer, inclusief de Action-voorwaarden die uitvoering beperken tot beheerders.

Kunnen ChatGPT of Claude de Telegram-chatbot helpen configureren?

Een verbonden app voor Quickchat AI-accountbeheer kan helpen een Agent te maken, kennis toe te voegen, ondersteunde instellingen te configureren en tests uit te voeren. Als de client Telegram-configuratie aanbiedt, kan hij de Direct message link van de gedeelde bot activeren. De eigenaar blijft verantwoordelijk voor de groepskeuze en bevestiging in het dashboard. Sommige clients vereisen het dashboard ook voor het activeren van de privélink en de instellingen van Human Handoff. Laat de assistent daarom eerst zijn beschikbare tools bekijken.

Verbind de Quickchat AI ChatGPT-plugin of Claude-connector en lever de kitbestanden aan met deze 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.

Beschikbare tools verschillen per client en accountrechten. Volg de documentatie voor accountbeheer om in te loggen. Hiermee verbind je een assistent met je Quickchat AI-account; een persoonlijk ChatGPT- of Claude-gesprek wordt daarmee niet de gehoste backend van de Telegram-bot.

Waarom antwoordt de Telegram-chatbot niet?

Controleer de verbinding en de berichtroute voordat je de prompt herschrijft. Deze symptomen hebben verschillende oorzaken.

Vervang vóór het uitnodigen van klanten de fictieve feiten, controleer de scheiding tussen groep en privé en zorg voor bezetting van de overdrachtswachtrij. Vraag een collega om als laatste controle voor de lancering de openbare ingangen vanuit een ander account te testen. Voor een ander communitykanaal volgt de Discord-chatbothandleiding een vergelijkbare bouw- en testroute. Gebruik voor gesprekken met personages de Telegram-rollenspelhandleiding.

Optionele configuratiecontroles: Vergelijk implementatiemethoden op basis van je opgegeven eisen of vergelijk antwoorden per creditbudget met een opgegeven budget. Deze rekenhulpen bekijken je account, website of saldo niet.

Kopieerbare Saltmarsh-configuratie

Dit zijn de volledige bronfeiten en instructies die deze handleiding gebruikt. De download bevat ook de Action-instellingen, beoordelingscriteria en tests.

Groeps-Agent: Main Prompt

Plak dit in Identity > Main Prompt op Saltmarsh Group. Houd Human Handoff en aangepaste Actions op deze Agent uitgeschakeld.

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.

Privé-Agent: Main Prompt

Plak dit in Identity > Main Prompt op Saltmarsh Sailing School. Zorg dat de genoemde Action overeenkomt met de configuratie.

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.

Kennis: cursussen en proeflesaanvragen

Plak dit in het veld Content van het eerste kennisartikel.

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.

Kennis: beleid en ledeninformatie

Plak dit in het veld Content van het tweede artikel.

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.

Human Handoff-regel

Plak dit onder Human Handoff > Handoff Rules en configureer de werkelijke beschikbaarheid.

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.

Veelgestelde vragen

Hoe voeg ik een AI-chatbot toe aan een Telegram-groep?

Open in Quickchat AI External Apps, selecteer Telegram en kies Add to a Telegram group. Selecteer je groep in Telegram, keer terug naar Quickchat AI en kies Confirm. Leden kunnen vragen stellen door de gedeelde bot te vermelden of op een van zijn berichten te antwoorden.

Beantwoordt een Telegram AI-chatbot elk bericht?

De gedeelde Quickchat AI-bot beantwoordt groepsberichten die hem vermelden of op hem reageren. Gewone groepsgesprekken activeren geen antwoord. Je eigen bot kan gewone groepsberichten ontvangen als de Telegram-privacymodus is uitgeschakeld of de bot beheerder is. Test die configuratie in een aparte groep.

Heb ik BotFather of een Telegram-bottoken nodig?

Voor de gedeelde bot en zijn privélink heb je geen BotFather of token nodig. Maak een eigen bot met BotFather als je een eigen Telegram-naam en afbeelding of Actions nodig hebt die de Telegram Bot API aanroepen. Gewone Google Sheets-Actions kunnen met de gedeelde bot werken.

Kunnen klanten de Telegram-chatbot privéberichten sturen?

Ja. Schakel Direct message link in Quickchat AI in en deel de volledige gegenereerde link. Een klant opent de link en drukt indien gevraagd op Start. De link selecteert je Agent binnen de gedeelde bot. De link uitschakelen voorkomt nieuwe verbindingen; bestaande privéchats hebben aparte bediening voor inschakelen en verbreken.

Is een Telegram AI-chatbot gratis?

Een bot maken met BotFather voegt op zichzelf geen AI-dienst toe. Quickchat AI biedt een Free-abonnement voor persoonlijk, niet-commercieel leren met een beperkt aantal AI-credits. Een commerciële inzet vereist een betaald abonnement. Antwoorden, Preview en Simulation gebruiken AI-credits en externe diensten kunnen eigen kosten hebben.

Heeft Telegram AI-chatbots?

Telegram ondersteunt AI-bots en AI-integraties van derden. Deze handleiding verbindt een Quickchat AI Agent die antwoordt op basis van je eigen bedrijfskennis. BotFather maakt de botidentiteit; het levert die kennis niet aan en configureert je klantenserviceproces niet.

Kan de chatbot foto’s en bestanden begrijpen?

De Telegram-integratie kan foto’s ontvangen en hun visuele inhoud analyseren. Andere bestanden kunnen als bijlagen bij het gesprek komen, maar hun inhoud wordt niet automatisch gelezen. Test de bestandstypen die je klanten echt gebruiken en controleer zowel Telegram als Inbox.

Kan ik een Telegram-bot voor rollenspel of personages maken?

Ja. Dezelfde Telegram-verbinding kan een Agent met een personage-identiteit en passende instructies bedienen. Deze handleiding gebruikt een voorbeeld voor zakelijke ondersteuning; een rollenspel-Agent heeft een eigen prompt en tests nodig.