Je bots beheren — verbind en draai je eigen Telegram-bot

1Telm draaien onder je eigen bot

Standaard worden uw groepen beschermd door de gedeelde Telm-bot. De custom-bot-add-on laat u dezelfde bescherming draaien onder een bot die u zelf bezit en van uw eigen merk voorziet, zodat leden uw bot in de groep zien in plaats van de onze.

Het bots-scherm in uw account somt elke aangepaste bot op die met uw account is verbonden, toont zijn huidige status, en laat u nieuwe verbinden en aan groepen toewijzen.

2Waarom je eigen bot draaien

Voor bureaus, resellers en gemeenschappen met een eigen merk is de bot in de groep onderdeel van de ervaring. Uw eigen bot draaien betekent dat leden interacteren met uw naam en avatar, dat welkomst- en moderatieberichten van uw bot komen, en dat de bescherming eronder nog steeds de volledige Telm-engine is.

Het is het verschil tussen een tool gebruiken en een dienst aanbieden: uw leden hoeven nooit te weten dat Telm erbij betrokken is.

• Leden zien uw bot, niet de gedeelde Telm-bot.
• De moderatie-engine, regels en reputatie zijn ongewijzigd — alleen het gezicht is van u.
• Ideaal voor bureaus die klantgemeenschappen beheren en voor merken die een consistente identiteit willen.

3Wat je eerst nodig hebt

Voordat u een aangepaste bot in een groep kunt gebruiken, moet de custom-bot-add-on actief zijn voor die groep, bovenop een Pro- of Business-plan. Als de add-on niet actief is, wordt het toewijzen van een bot geblokkeerd met een duidelijke melding die u vertelt dat de add-on vereist is.

U hebt ook een eigen bot nodig, aangemaakt in Telegram BotFather, en zijn API-token.

• De custom-bot-add-on is beschikbaar op Pro en Business.
• De add-on moet actief zijn op de specifieke groep waar u uw bot wilt laten draaien.
• U hebt een BotFather-bot en zijn token nodig.

4Een bot verbinden

Maak een bot aan in BotFather en kopieer het token dat het u geeft. Kies op het bots-scherm om een nieuwe bot toe te voegen en plak het token. Telm valideert het token door een live aanroep naar Telegram te doen, zodat een verkeerd of reeds ingetrokken token onmiddellijk wordt afgewezen, en registreert de bot vervolgens bij uw account onder de naam en gebruikersnaam die Telegram rapporteert.

Het token wordt versleuteld opgeslagen, en elke bot krijgt zijn eigen geheim voor veilig webhook-verkeer. Om alles veilig te houden, geldt er een registratielimiet — u kunt tot vijf bots per uur registreren — dus als u meerdere tokens snel achter elkaar plakt, wordt u mogelijk gevraagd te wachten.

• Het token wordt live tegen Telegram gecontroleerd voordat de bot wordt geregistreerd.
• Tokens worden versleuteld opgeslagen met sterke versleuteling; het ruwe token wordt na registratie nooit meer prijsgegeven.
• Registratie is beperkt tot vijf pogingen per uur om misbruik te voorkomen.

5Bot-statussen begrijpen

Elke verbonden bot toont een status zodat u in één oogopslag weet of hij werkt. Er zijn er vijf:

• Pending (in behandeling) — de bot is geregistreerd en wordt online gebracht.
• Active (actief) — de bot draait en handelt uw groep af (dit is de werkende toestand).
• Stopped (gestopt) — de bot is verbonden maar draait momenteel niet omdat u hem hebt gestopt.
• Suspended (opgeschort) — de bot werd gepauzeerd omdat de facturering verliep (de add-on of het plan is momenteel niet actief); zijn token en instellingen worden bewaard.
• Error (fout) — er is iets misgegaan, meestal een ingetrokken token; de groep valt terug op de gedeelde bot tot u het oplost.

6Bots starten, stoppen en vervangen

Vanaf het bots-scherm kunt u op elk moment een gestopte bot starten of een draaiende stoppen, en een bot toewijzen aan (of verwijderen uit) een groep waar de add-on actief is. Als de facturering verloopt, gaan de getroffen bots naar Suspended; zodra het plan weer actief is kunt u ze met één klik weer inschakelen en keren ze terug naar Active.

Als uw token in BotFather wordt ingetrokken, gaat de bot naar Error en valt de groep tijdelijk terug op de gedeelde Telm-bot zodat de bescherming nooit wegvalt. Om een token te vervangen, registreert u de bot opnieuw met het nieuwe token — er is geen aparte token-bewerkstap.

• Start, stop en wijs bots toe vanaf één scherm.
• Een opgeschorte bot hervat met één klik zodra het plan weer actief is.
• Vervang een ingetrokken token door de bot opnieuw te registreren met het nieuwe.
• Terwijl een bot in Error is, blijft de groep draaien op de gedeelde Telm-bot.

7Je bot-token veilig houden

Uw bot-token is net zo gevoelig als een wachtwoord: iedereen die het heeft kan uw bot besturen. Telm slaat het token versleuteld op en toont het nooit meer nadat u de bot hebt verbonden, maar u zou het aan uw kant nog steeds moeten beschermen.

Als u vermoedt dat een token is gelekt, trek het in in BotFather en registreer de bot opnieuw met een nieuw token. Het oude token stopt met werken op het moment dat u het intrekt.

8Een bot in Error oplossen

Als een bot Error toont, werk de gebruikelijke oorzaken op volgorde af.

• Het token werd ingetrokken of is verkeerd — registreer de bot opnieuw met een geldig token uit BotFather.
• De bot is geen beheerder in de groep, of mist verwijder- of beperkingsrechten — herstel zijn beheerdersrechten en start hem opnieuw.
• De add-on is verlopen — de bot toont dan Suspended in plaats van Error; schakel hem weer in zodra het plan weer actief is.
• Na het herstellen van de oorzaak, start de bot; hij zou moeten terugkeren naar Active.