Hantera dina bottar – anslut och kör din egen Telegram-bot

1Att köra Telm under din egen bot

Som standard skyddas dina grupper av den delade Telm-boten. Tilläggstjänsten för anpassad bot låter dig köra samma skydd under en bot du äger och brandar, så att medlemmar ser din bot i gruppen snarare än vår.

Bot-skärmen i ditt konto listar varje anpassad bot som är ansluten till ditt konto, visar dess aktuella status, och låter dig ansluta nya och tilldela dem till grupper.

2Varför köra din egen bot

För byråer, återförsäljare och brandade communities är boten i gruppen en del av upplevelsen. Att köra din egen bot betyder att medlemmar interagerar med ditt namn och din avatar, välkomst- och moderationsmeddelanden kommer från din bot, och skyddet under är fortfarande hela Telm-motorn.

Det är skillnaden mellan att använda ett verktyg och att erbjuda en tjänst: dina medlemmar behöver aldrig veta att Telm är inblandat.

• Medlemmar ser din bot, inte den delade Telm-boten.
• Moderationsmotorn, reglerna och ryktet är oförändrade – bara ansiktet är ditt.
• Idealisk för byråer som hanterar kundcommunities och för varumärken som vill ha en konsekvent identitet.

3Vad du behöver först

Innan du kan använda en anpassad bot i en grupp måste tilläggstjänsten för anpassad bot vara aktiv för den gruppen, ovanpå en Pro- eller Business-plan. Om tilläggstjänsten inte är aktiv blockeras tilldelning av en bot med ett tydligt meddelande som talar om att tilläggstjänsten krävs.

Du behöver också en egen bot, skapad i Telegram BotFather, och dess API-token.

• Tilläggstjänsten för anpassad bot är tillgänglig på Pro och Business.
• Tilläggstjänsten måste vara aktiv på den specifika grupp där du vill att din bot ska köra.
• Du behöver en BotFather-bot och dess token.

4Att ansluta en bot

Skapa en bot i BotFather och kopiera token den ger dig. På bot-skärmen, välj att lägga till en ny bot och klistra in token. Telm validerar token genom att göra ett live-anrop till Telegram, så att en felaktig eller redan återkallad token avvisas omedelbart, och registrerar sedan boten till ditt konto under namnet och användarnamnet Telegram rapporterar.

Token lagras krypterad, och varje bot får sin egen hemlighet för säker webhook-trafik. För att hålla saker säkra är registrering hastighetsbegränsad – du kan registrera upp till fem bottar per timme – så om du klistrar in flera tokens i snabb följd kan du bli ombedd att vänta.

• Token kontrolleras live mot Telegram innan boten registreras.
• Tokens lagras krypterade med stark kryptering; den råa token exponeras aldrig efter registrering.
• Registrering är begränsad till fem försök per timme för att förhindra missbruk.

5Att förstå bot-statusar

Varje ansluten bot visar en status så att du med en blick vet om den fungerar. Det finns fem:

• Väntande – boten är registrerad och håller på att tas i drift.
• Aktiv – boten körs och hanterar din grupp (detta är det fungerande tillståndet).
• Stoppad – boten är ansluten men körs inte för närvarande eftersom du stoppade den.
• Pausad – boten pausades eftersom faktureringen upphörde (tilläggstjänsten eller planen är inte aktiv för närvarande); dess token och inställningar behålls.
• Fel – något gick fel, oftast en återkallad token; gruppen faller tillbaka på den delade boten tills du fixar det.

6Att starta, stoppa och ersätta bottar

Från bot-skärmen kan du starta en stoppad bot eller stoppa en körande när som helst, och tilldela en bot till (eller ta bort den från) en grupp som har tilläggstjänsten aktiv. Om faktureringen upphör flyttas berörda bottar till Pausad; när planen är aktiv igen kan du återaktivera dem med ett klick och de återgår till Aktiv.

Om din token återkallas i BotFather flyttas boten till Fel och gruppen faller tillfälligt tillbaka på den delade Telm-boten så att skyddet aldrig försvinner. För att ersätta en token, registrera boten igen med den nya token – det finns inget separat redigera-token-steg.

• Starta, stoppa och tilldela bottar från en skärm.
• En pausad bot återupptas med ett klick när planen är aktiv igen.
• Ersätt en återkallad token genom att registrera boten igen med den nya.
• Medan en bot är i Fel fortsätter gruppen att köra på den delade Telm-boten.

7Att hålla din bot-token säker

Din bot-token är lika känslig som ett lösenord: vem som helst som har den kan kontrollera din bot. Telm krypterar token i vila och visar den aldrig igen efter att du anslutit boten, men du bör ändå skydda den på din sida.

Om du misstänker att en token har läckt, återkalla den i BotFather och registrera boten igen med en ny token. Den gamla token slutar fungera i det ögonblick du återkallar den.

8Att felsöka en bot i Fel

Om en bot visar Fel, arbeta igenom de vanliga orsakerna i tur och ordning.

• Token återkallades eller är felaktig – registrera boten igen med en giltig token från BotFather.
• Boten är inte administratör i gruppen, eller saknar rättigheter att ta bort eller begränsa – fixa dess adminrättigheter och starta den igen.
• Tilläggstjänsten upphörde – boten visar Pausad snarare än Fel; återaktivera den när planen är aktiv igen.
• Efter att ha fixat orsaken, starta boten; den bör återgå till Aktiv.