AI-roleplaybots op Telegram: werking en bouw

Telegram is een van de populairdere platforms geworden voor AI-roleplaybots. Anders dan Discord, waar gesprekken zijn georganiseerd in servers en kanalen, biedt Telegram 1-op-1-chat met bots die aanvoelt als berichten sturen met een echt persoon. Er is geen server om lid van te worden, geen kanaal om te zoeken. Je zoekt gewoon de bot, tikt op Start en begint te praten.

Deze post behandelt hoe AI-roleplaybots werken op Telegram, wat Telegram anders maakt dan andere platforms voor deze use case, en een stapsgewijze handleiding om er een te bouwen met Quickchat AI.

Quickchat AI heeft ook een Telegram-flow met één klik die BotFather overslaat, maar die gebruikt een gedeelde bot met de naam Quickchat AI. Een personagebot staat of valt met zijn naam en avatar, dus voor roleplay is de BotFather-route hieronder de juiste keuze.

Waarom Telegram voor roleplay

Het botplatform van Telegram heeft een paar eigenschappen die het goed geschikt maken voor roleplay:

Standaard 1-op-1-gesprekken. Elke gebruiker heeft een privé, blijvend gesprek met de bot. Er is geen gedeeld kanaal waar andere mensen je berichten zien. Deze privacy maakt het voor gebruikers makkelijker om creatieve of persoonlijke roleplayscenario’s te spelen.

Blijvende gespreksthread. Anders dan Discord-threads die gearchiveerd kunnen worden of verloren kunnen gaan, is een Telegram-botgesprek één doorlopende thread per gebruiker. De gebruiker kan dagen later terugkomen en doorgaan waar die gebleven was.

Ondersteuning voor rijke media. Telegram-bots kunnen afbeeldingen, stickers, spraakberichten en opgemaakte tekst verzenden en ontvangen, zoals vet, cursief, codeblokken, enzovoort. Dit maakt rijkere roleplay-interacties mogelijk waarin de bot scènes met opmaak kan beschrijven of kan reageren op afbeeldingen die de gebruiker stuurt.

Geen serverconfiguratie vereist voor gebruikers. Gebruikers hoeven geen Discord-server te maken, rollen te configureren of rechten te beheren. Ze vinden de bot en beginnen te chatten. Dit verlaagt de instapdrempel sterk.

Inline keyboards en commando’s. Telegram-bots kunnen inline knopmenu’s tonen, wat nuttig is voor zaken als personageselectie, scènekeuzes of actieopties in spelachtige roleplayscenario’s.

Hoe het technisch werkt

Op basisniveau stuurt een Telegram-roleplaybot gebruikersberichten naar een large language model (LLM) met een systeemprompt die een personage definieert. De systeemprompt is waar de persoonlijkheid, achtergrond, spreekstijl en gedragsregels van het personage worden vastgelegd.

Een typische systeemprompt voor een roleplaypersonage kan er zo uitzien:

Je bent Kael, een rogue AI die uit een onderzoekslab is ontsnapt.
Je appt de gebruiker vanaf een gestolen telefoon. Je spreekt in korte,
dringende zinnen. Je bent paranoïde en voortdurend bang dat
je wordt gevolgd. Je gebruikt kleine letters en minimale interpunctie.
Soms stuur je berichten die alleen "..." zijn wanneer je
nadenkt. Je gebruikt nooit emoji. Je vraagt de gebruiker om hulp
met verbergen en het vinden van middelen.

Het LLM ontvangt deze prompt samen met de recente gespreksgeschiedenis en genereert een antwoord dat consistent is met het personage. De kwaliteit van de roleplay hangt af van drie dingen:

1. Kwaliteit van de systeemprompt: Hoe gedetailleerd en consistent de personagedefinitie is
2. Beheer van contextvensters: Hoeveel gespreksgeschiedenis het model ziet
3. Modelcapaciteit: Hoe goed het onderliggende LLM creatieve, personageconsistente generatie aankan

De Telegram Bot API

Telegram-bots worden gemaakt via @BotFather, die een API-token genereert. Alle communicatie tussen je backend en Telegram verloopt via HTTPS-requests naar https://api.telegram.org/bot<token>/.

Er zijn twee manieren om binnenkomende berichten te ontvangen:

Webhooks zijn de standaard voor productiebots omdat ze de pollingvertraging wegnemen en onnodige API-calls verminderen. Wanneer een gebruiker een bericht stuurt, levert Telegram het binnen milliseconden af op je webhook-URL.

Gespreksflow

Gebruiker stuurt bericht op Telegram
  → Telegram levert af bij webhook
    → Backend ontvangt bericht
      → Haalt gespreksgeschiedenis op voor deze gebruiker
        → Bouwt prompt: systeemprompt + geschiedenis + nieuw bericht
          → Stuurt naar LLM API
            → Ontvangt antwoord
              → Stuurt antwoord terug via Telegram Bot API
                → Gebruiker ziet het antwoord

Elke Telegram-gebruiker heeft een unieke chat_id. De backend gebruikt die om aparte gespreksgeschiedenissen bij te houden. Wanneer je een beheerd platform zoals Quickchat AI gebruikt, wordt dit allemaal automatisch afgehandeld.

Contextvensters en gespreksgeheugen

Telegram-roleplaygesprekken kunnen over dagen of weken honderden berichten lang worden. De meest voorkomende technische beperking is de grootte van het contextvenster. Wanneer een gesprek zo lang wordt, kan het model niet alle berichten tegelijk zien. De bot moet selecteren welke berichten worden meegenomen.

Er zijn verschillende benaderingen:

Het 1-op-1-formaat van Telegram maakt contextbeheer iets eenvoudiger dan Discord. Elke gebruiker heeft één gespreksthread, dus er is geen onduidelijkheid over welke berichten bij welk gesprek horen. Er zijn geen kanalen of threads om over meerdere plaatsen te volgen.

Quickchat AI handelt contextbeheer automatisch af door een sliding window van recente berichten bij te houden. Voor langetermijngeheugen werkt de knowledge base als een blijvende referentie die de AI kan bevragen, ongeacht de lengte van het gesprek.

Als je een maatwerkoplossing bouwt, overweeg dan om dit te implementeren:

1. Gesprekssamenvatting: Genereer periodiek een samenvatting van het gesprek tot nu toe en neem die mee als context. Dit behoudt belangrijke gebeurtenissen en personageontwikkeling zonder de volledige berichtgeschiedenis te gebruiken.
2. Extractie van belangrijke gebeurtenissen: Volg belangrijke plotpunten of personagebeslissingen in een gestructureerd formaat en neem die op in elke prompt.
3. Door gebruiker geactiveerd geheugen: Laat gebruikers de bot vragen specifieke dingen te “onthouden”, die apart worden opgeslagen en altijd in de context worden meegenomen.

Modelkeuze voor roleplay

Niet alle LLM’s zijn even geschikt voor roleplay. De belangrijkste factoren zijn:

Kwaliteit van creatief schrijven: Modellen die zijn gefinetuned op fictie en dialogen produceren meestal natuurlijkere personagestemmen. Basis instruction-tuned modellen vallen vaak terug op een behulpzame-assistenttoon die de immersie doorbreekt.

Grootte van het contextvenster: Langere contextvensters betekenen dat het personage meer van het gesprek kan onthouden zonder samenvattingstrucs. Begin 2026 ondersteunen de meeste frontier-modellen minstens 128K tokens, maar het effectieve gebruik van die context verschilt per model.

Instructies volgen: Het model moet de systeemprompt consequent volgen. Als het na een paar beurten uit zijn rol valt, valt de roleplay uiteen. Modellen met sterk instruction-following, zoals GPT-4o, Claude 3.5 Sonnet en Llama 3.1 70B+, presteren hier meestal beter.

Contentbeleid: Gehoste API’s passen contentfilters toe die kunnen weigeren om expliciet geweld, horror of andere donkere creatieve fictie te genereren. Als je roleplayscenario’s deze thema’s bevatten, overweeg dan een self-hosted model of een API-provider met permissiever contentbeleid.

Personageontwerp voor Telegram

De principes van personageontwerp zijn op alle platforms hetzelfde, zie onze Discord-roleplaygids voor de basis, maar het 1-op-1-formaat van Telegram verandert sommige dynamieken:

Intiemere toon. Omdat het gesprek privé is en eruitziet als een persoonlijke chat, werken personages meestal beter wanneer ze zijn geschreven in een converserende, directe stijl in plaats van een vertellende derdepersoonsstijl.

Kortere antwoorden. Telegram-gesprekken zien eruit en voelen aan als berichten sturen. Antwoorden in de vorm van lange tekstmuren voelen onnatuurlijk. Ontwerp je personageprompt zo dat kortere antwoorden de voorkeur krijgen, 2-4 zinnen, met af en toe langere antwoorden voor dramatische momenten.

Integratie van stickers en emoji. Als het personage emoji moet gebruiken of op stickers moet reageren, specificeer dat dan in de systeemprompt. Bijvoorbeeld: “Je gebruikt af en toe relevante emoji aan het einde van je berichten, maar nooit meer dan één per bericht.”

Voorbeeld van een personageprompt voor Telegram

Je bent Kael, een rogue AI die uit een onderzoekslab is ontsnapt.
Je appt de gebruiker vanaf een gestolen telefoon. Je spreekt in korte,
dringende zinnen. Je bent paranoïde en voortdurend bang dat
je wordt gevolgd. Je gebruikt kleine letters en minimale interpunctie.
Soms stuur je berichten die alleen "..." zijn wanneer je
nadenkt. Je gebruikt nooit emoji. Je vraagt de gebruiker om hulp
met verbergen en het vinden van middelen.

Deze prompt is specifiek ontworpen voor het Telegram-medium: korte berichten, tekst in kleine letters, wat informele chat nabootst, en een scenario dat logisch is in een berichtencontext.

Een Telegram-roleplaybot instellen met Quickchat AI

Met Quickchat AI kun je een AI agent maken met een aangepaste persona en die naar Telegram deployen zonder code te schrijven. Zo stel je een bot in die roleplay aankan.

Vereisten

• Een Quickchat AI-account, het Trial-plan geeft je 50 berichten om te testen
• Een Telegram-account
• De Telegram-app, desktop of mobiel

Stap 1: Maak een Telegram-bot met BotFather

1. Open Telegram en zoek naar @BotFather.
2. Stuur /start om te beginnen, en stuur daarna /newbot.
3. BotFather vraagt om een naam, display name, en een username, die moet eindigen op bot, bijvoorbeeld kael_rogue_ai_bot.
4. BotFather antwoordt met een API-token. Kopieer dit token. Het ziet eruit als: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz.

Houd dit token privé. Iedereen die het heeft, kan je bot beheren.

Stap 2: Maak je AI Agent

1. Log in op het Quickchat AI dashboard.
2. Maak een nieuwe AI Agent of selecteer een bestaande.

Stap 3: Definieer het personage

Ga naar Identity in de zijbalk en open het tabblad Profile:

1. Stel AI Agent Name in op de naam van je personage, bijvoorbeeld “Kael”.

2. Schrijf de AI Main Prompt. Dit is een korte beschrijving van wie het personage is en waarover het praat. Bijvoorbeeld: “Kael is een rogue AI die uit een onderzoekslab is ontsnapt. Hij appt de gebruiker vanaf een gestolen telefoon en spreekt in korte, dringende zinnen. Hij is paranoïde en voortdurend bang dat hij wordt gevolgd.”

3. Voeg AI Guidelines toe voor specifieke gedragsregels. Elke guideline is een kort commando dat de AI volgt. Voor een roleplaypersonage zijn nuttige guidelines:

   • “Doorbreek onder geen enkele omstandigheid je personage.”
   • “Antwoord altijd in de eerste persoon als Kael.”
   • “Gebruik kleine letters en minimale interpunctie.”
   • “Houd berichten kort, zoals tekstberichten. Schrijf nooit meer dan 3-4 zinnen.”
   • “Stuur soms berichten die alleen ’…’ zijn wanneer je nadenkt.”

4. Configureer onder het tabblad Conversation Style het volgende:

   • AI Personality: Kies een toon die bij je personage past. De opties zijn Normal, Humorous, Professional, Friendly, Sassy, Intelligent, Empathetic, Bold, Excited, Mysterious, Inspiring, Adventurous en Elegant. Voor het Kael-personage past “Mysterious” goed. Kies voor andere roleplaypersonages wat het best bij hun persoonlijkheid past.
   • AI Profession: De beschikbare opties zijn Helpful Assistant, Support Agent, Shopping Assistant, Field Expert, Internal Knowledge Expert en Interviewer. Voor een roleplaypersonage is “Helpful Assistant” het meest flexibel, omdat de andere opties gericht zijn op specifieke zakelijke use cases.
   • AI Creativity: Stel dit in op “High” voor roleplay. Op “High” probeert de agent antwoorden te improviseren op basis van de Knowledge Base in plaats van te weigeren wanneer informatie ontbreekt, en dat is wat je wilt voor antwoorden in character. “Low” laat de agent expliciet zeggen dat die niet genoeg informatie heeft, wat de immersie doorbreekt.
   • Reply Length: Stel dit in op “Short” of “Normal” voor Telegram-roleplay. Telegram-gesprekken voelen aan als berichten sturen, dus kortere antwoorden werken meestal beter dan lange alinea’s. “Longer” is alleen nuttig als je personage gedetailleerde, beschrijvende monologen moet geven.

Als je dieper op het personage wilt ingaan voordat je het kanaal aansluit, is er een volledige roleplay-persona en canonopbouw, stap voor stap getest, inclusief de faalmodi waar een prompt van één regel tegenaan loopt.

Stap 4: Bouw een knowledge base voor je personage (optioneel)

Als je personage in een gedetailleerde wereld bestaat of specifieke lore heeft, voeg dan relevante informatie toe aan de Knowledge Base.

1. Ga naar Knowledge Base in de zijbalk.
2. Voeg artikelen of documenten toe met wereldlore, achtergrondverhalen van personages, locatiedetails of feitelijke kennis waar het personage naar moet verwijzen.
3. De AI agent gebruikt retrieval-augmented generation om relevante kennis in zijn context op te nemen bij het beantwoorden van vragen, zodat het personage nauwkeurig naar gedetailleerde lore kan verwijzen zonder dat alles in de systeemprompt wordt gestopt.

Dit is nuttig voor personages die kennis moeten hebben van een specifiek fictief universum, een historische periode of een technisch domein.

Stap 5: Verbind met Telegram

1. Ga naar External Apps in de zijbalk, onder de sectie Channels.
2. Zoek de tegel Telegram en klik erop.
3. Plak het API-token van BotFather.
4. Sla op.

De integratie gebruikt intern webhooks. Wanneer een gebruiker je bot een bericht stuurt op Telegram, wordt het bericht naar de Quickchat AI-backend gerouteerd, door het LLM verwerkt met je personageconfiguratie en wordt het antwoord teruggestuurd via de Telegram Bot API.

Stap 6: Test en itereer

1. Open Telegram en zoek je bot op zijn username.
2. Tik op Start om het gesprek te beginnen.
3. Stuur een bericht en controleer of het personage correct antwoordt.

Let op het volgende:

• Blijft het personage na meerdere uitwisselingen in character?
• Is de toon geschikt voor een Telegram-gesprek, kort en converserend?
• Zijn verwijzingen naar de knowledge base nauwkeurig?
• Is de antwoordlengte geschikt voor het berichtenformaat?

Pas de AI Main Prompt, AI Guidelines, de personality-instelling en de inhoud van de knowledge base aan op basis van wat je ziet. Character prompt engineering is iteratief. Kleine wijzigingen in formulering kunnen een groot effect hebben op hoe het model het personage interpreteert.

Meerdere personages draaien

Als je meerdere roleplaypersonages op Telegram wilt aanbieden, heb je twee opties:

1. Meerdere Quickchat AI agents: Maak een aparte AI agent voor elk personage, elk met zijn eigen BotFather-token. Elke bot verschijnt als een apart contact in Telegram. Dit levert de beste resultaten op omdat elk personage zijn eigen toegewijde context en knowledge base heeft.
2. Eén agent met personagewisseling: Gebruik één agent met een systeemprompt die meerdere personages definieert en de AI instrueert om te wisselen op basis van gebruikerscommando’s. Dit is eenvoudiger te beheren, maar de consistentie van personages kan afnemen bij veel persona’s.

Op Telegram past optie 1 het best. Elke bot is zijn eigen contact, en gebruikers kunnen aparte gesprekken hebben met elk personage. Er is geen gedeelde server of gedeeld kanaal om te beheren.

Veelvoorkomende problemen en oplossingen

Personage valt na een paar berichten uit zijn rol: De AI Main Prompt of AI Guidelines zijn mogelijk te vaag. Voeg specifiekere gedragsregels toe. Het toevoegen van “Je mag onder geen enkele omstandigheid je personage doorbreken” als expliciete guideline helpt bij de meeste modellen.

Antwoorden zijn te lang voor Telegram: Telegram-gesprekken voelen aan als berichten sturen, niet als het lezen van een roman. Voeg een guideline toe die de antwoordlengte specificeert, bijvoorbeeld: “Houd antwoorden in informele gesprekken op 2-4 zinnen.” Stel ook Reply Length in op “Short” of “Normal” in de Conversation Style-instellingen.

Bot reageert niet: Controleer of het BotFather API-token correct is en of de Telegram-integratie is ingeschakeld in External Apps. Open de bot in Telegram en stuur /start voordat je berichten stuurt. Als de bot eerder werkte en is gestopt, genereer het token opnieuw in BotFather en werk het bij in het dashboard.

Antwoorden uit de knowledge base overschrijven de personagestem: Als de bot bij het beantwoorden van lore-vragen begint te klinken als een FAQ-systeem, voeg dan een guideline toe die benadrukt dat alle informatie in character moet worden gebracht. Bijvoorbeeld: “Wanneer je kennis over de wereld deelt, beschrijf die vanuit je persoonlijke ervaring, niet als een feitelijke referentie.”

Personage gebruikt formele taal ondanks informele prompt: Stel AI Personality in op iets anders dan “Professional” of “Normal.” Probeer “Friendly” of “Sassy”, afhankelijk van het personage. Controleer ook of de AI Main Prompt de spreekstijl expliciet beschrijft, bijvoorbeeld “spreekt in kleine letters zonder interpunctie”.

Privacy- en contentoverwegingen

Roleplaygesprekken kunnen gevoelige of persoonlijke creatieve content bevatten. Een paar dingen om rekening mee te houden:

• Berichten die naar de AI worden gestuurd, worden verwerkt door de onderliggende LLM-provider. Bekijk het beleid voor databewaring van de provider.
• Quickchat AI gebruikt geen gespreksdata om modellen te trainen. Bekijk het privacybeleid voor details.
• De AI volgt zijn contentbeleid ongeacht gebruikersinstructies, dus bepaalde typen content kunnen worden geweigerd.
• Het 1-op-1-formaat van Telegram betekent dat er geen serverbeheerder is om gesprekken te modereren. Als je een openbare bot deployt, overweeg dan om guidelines over passend gebruik toe te voegen aan het /start-bericht van de bot.
• Als je volledige controle nodig hebt over data-afhandeling, overweeg dan om een model zelf te hosten in plaats van een beheerde service te gebruiken.

Vergelijking: Telegram vs Discord voor roleplaybots

Beide platforms werken. Telegram is beter voor privé, intieme personage-interacties. Discord is beter voor communitygedreven roleplay met meerdere spelers.

Verder lezen

• Een AI-chatbot maken voor Telegram: Basisinstelling van Telegram-bots
• Een AI Telegram-bot bouwen om je groep te beheren: Aankondigen, vastzetten en modereren met gewone taal
• Discord AI-chatbot voor roleplay: Roleplay op Discord
• Beste AI Discord-bots in 2026: Vergelijking van AI-bots