Tworzenie bota Telegram dla konta (BotFather, Secretary Mode, token)

Aby utworzyć bota Telegram dla konta LanaChat, wysyłają Państwo /newbot do @BotFather w Telegramie, włączają Secretary Mode bota, a potem wklejają w LanaChat token przesłany przez BotFather. Zajmuje to trzy minuty, jest bezpłatne, a Telegram Premium nie jest potrzebny.

Każde konto Telegram w LanaChat odpowiada fanom przez własnego bota. Te trzy kroki wykonuje się raz na bota, w kroku Create the bot kreatora Add account (Studio › Telegram Accounts). Następnie łączą Państwo bota z kontem Telegram twórczyni, w Telegram Business (ostatnia część tego przewodnika).

Zanim Państwo zaczną #

• Telegram otwarty na telefonie lub komputerze, na dowolnym koncie Telegram (Państwa konto wystarczy: bot nie jest przypisany do konta, które go tworzy).
• W Console: Studio › Telegram Accounts → Add account, z ukończonymi krokami Creator i Details. Trafiają Państwo do kroku 3, Create the bot.
• Dostęp do konta Telegram twórczyni na ostatnią część (połączenie w Telegram Business).

Krok 1: utworzenie bota przez /newbot #

1. Proszę wyszukać w Telegramie @BotFather i go otworzyć. Proszę sprawdzić niebieski znaczek: tylko ten jest oficjalny.
2. Proszę nacisnąć Start, a potem wysłać /newbot.
3. BotFather prosi o nazwę. To wyświetlana nazwa bota, na przykład *Julia Assistant*. Może to być dowolny tekst, także ze spacjami, i można go później zmienić.
4. BotFather prosi o nazwę użytkownika. To @ bota, unikalna w całym Telegramie. Zasady:
   • Od 5 do 32 znaków: tylko litery, cyfry i _, bez spacji i myślników.
   • Musi kończyć się na bot (lub Bot), na przykład julia_it_5_bot albo JuliaItBot.
   • Później nie da się jej zmienić: proszę wybrać taką, którą łatwo rozpoznać na liście.
5. BotFather odpowiada *Done! Congratulations on your new bot.* z linkiem do bota i jego tokenem.

Nazwa użytkownika jest już zajęta: co zrobić? #

BotFather odpowiada *Sorry, this username is already taken.* Nazwy użytkowników są unikalne w całym Telegramie: proszę dodać słowo lub cyfrę i wysłać ponownie: julia_it_5_bot, potem julia_it_5b_bot i tak dalej. Jeśli BotFather odpowie, że nazwa użytkownika jest nieprawidłowa, proszę sprawdzić, czy kończy się na bot i zawiera tylko litery, cyfry i _.

W kreatorze proszę zaznaczyć pierwsze pole, a potem wpisać nazwę użytkownika w Enter the bot username (z @ lub bez). Pole przyjmuje ją tylko wtedy, gdy spełnia powyższe zasady.

Krok 2: włączenie Secretary Mode (obowiązkowe) #

Secretary Mode to nowa nazwa, którą BotFather nadał trybowi Business Mode. Bez niego Telegram odrzuca bota w Telegram Business, a konto nigdy się nie połączy.

1. W @BotFather proszę wysłać /mybots.
2. Proszę wybrać właśnie utworzonego bota.
3. Proszę nacisnąć Bot Settings, potem Secretary Mode, potem Turn on.
4. BotFather potwierdza: *Secretary Mode is currently enabled for @your_bot*.

Pole Turn on Secretary Mode w kreatorze proszę zaznaczyć dopiero wtedy, gdy pojawi się to zdanie. Pole jest oznaczone jako obowiązkowe: bez niego Next pozostaje zablokowany.

Krok 3: wklejenie tokenu w LanaChat #

Token znajduje się w wiadomości *Done! Congratulations* od BotFather, po *Use this token to access the HTTP API*. Wygląda tak: 12345678:AAxxxx…, czyli od 8 do 10 cyfr, dwukropek, a potem 35 znaków.

1. W BotFather proszę dotknąć tokenu, aby skopiować go w całości.
2. W kreatorze proszę wkleić go w Paste the token BotFather sent.
3. LanaChat go sprawdza i pokazuje *Token accepted. It is never shown again.* Proszę nacisnąć Next.

Jeśli wiadomość zginęła, proszę wysłać /mybots w @BotFather, wybrać bota, a potem API Token: BotFather pokaże go ponownie.

Token musi pozostać tajny #

Token to hasło bota: każdy, kto go ma, może czytać i wysyłać wiadomości jako bot, czyli na koncie twórczyni.

• Proszę wklejać go tylko w LanaChat. Nigdy nie wysyłać go na czacie, w e-mailu, na zrzucie ekranu ani w zgłoszeniu do wsparcia. Wsparcie LanaChat nigdy o niego nie prosi.
• Jeśli wyciekł, proszę od razu go unieważnić: w @BotFather wysłać /revoke i wybrać bota (albo /mybots → bot → API Token → Revoke current token). Stary token natychmiast przestaje działać, a BotFather wysyła nowy.
• Następnie proszę przekazać nowy token do LanaChat: w Studio › Telegram Accounts otworzyć menu Actions wiersza → Replace bot token i go wkleić. Przyjmowany jest tam tylko nowy token tego samego bota.

Połączenie bota z kontem twórczyni #

Kreator przechodzi wtedy do kroku 4, Connect in Telegram. Na koncie Telegram twórczyni (nie na koncie, które utworzyło bota):

1. Proszę otworzyć Settings → Telegram Business → Chat Automation (w niektórych wersjach Chatbots).
2. Proszę dodać bota po jego @ (kreator ma przycisk Copy) i zostawić *All Private Chats Except…*.
3. W Bot permissions proszę włączyć Manage Messages (oznaczone jako Required): bez tego LanaChat nie może odpowiadać.
4. Manage Profile, Manage Gifts and Stars i Manage Stories są opcjonalne, zalecane. W Gifts and Stars proszę zostawić wyłączone Transfer Stars i Transfer and Upgrade Gifts, chyba że LanaChat ma przenosić pieniądze.

Okno samo przełącza się na Connected as @username. Proszę nacisnąć Done. AI nowego konta jest wyłączona: proszę ją włączyć, gdy twórczyni będzie gotowa. Statusy i co zrobić, gdy połączenie czeka, opisuje Łączenie kont Telegram.

Jakie błędy zdarzają się najczęściej? #

• Zapomniany Secretary Mode: bota nie da się dodać w Chat Automation albo konto zostaje na Waiting for Telegram. Proszę włączyć go w @BotFather (krok 2), a potem ponownie dodać bota w Telegramie.
• Źle wklejony token: *This is not a bot token: 8 to 10 digits, a colon, then 35 characters.* albo *Token not accepted*. Wystarczy spacja, nowa linia lub brakujący znak. Proszę skopiować go ponownie z BotFather i wkleić sam token.
• Token innego bota: przy zamianie tokenu token innego bota jest odrzucany (*This token belongs to another bot*). Proszę wkleić nowy token tego samego bota.
• Bot używany już przez inne konto: kreator pokazuje *This bot is already in use* i proponuje Use it for this account too. Proszę się zgodzić tylko dla konta tej samej twórczyni: Stars obu kont trafiają na to samo saldo bota. W przeciwnym razie proszę utworzyć nowego bota przez /newbot.
• Wyłączone Manage Messages: konto się łączy, ale LanaChat nie może odpowiadać. W Chat Automation proszę włączyć Manage Messages z Reply to Messages.
• Bot dodany do złego konta Telegram: bota trzeba dodać na koncie twórczyni, tym, do którego piszą fani. Konto Telegram ma naraz tylko jednego bota: dodanie nowego zastępuje poprzedniego.

FAQ #

Czy utworzenie bota Telegram coś kosztuje? #

Nie. @BotFather tworzy boty za darmo, a Telegram Premium nie jest potrzebny, by bot Secretary obsługiwał konto.

Czy mogę utworzyć bota z własnego konta Telegram? #

Tak. Bot należy do konta Telegram, które utworzyło go w BotFather, ale można go dodać do dowolnego konta w Telegram Business. Tylko ostatnią część (Chat Automation) trzeba wykonać na koncie twórczyni.

Czy potrzebuję jednego bota na każde konto Telegram? #

Domyślnie tak: jeden bot na konto rozdziela Stars poszczególnych kont. Bot może też obsługiwać kilka kont tej samej twórczyni, wybrany w Use an existing bot w kroku 3.

Czy mogę później zmienić nazwę bota? #

Nazwę tak: /mybots → bot → Edit Bot → Edit Name. Nazwy użytkownika (@) nie da się zmienić: proszę utworzyć nowego bota i użyć Change bot w Edit konta, jeśli potrzebny jest inny.

Co zrobić, jeśli mój token wyciekł? #

Proszę wysłać /revoke do @BotFather i wybrać bota: stary token natychmiast przestaje działać. Potem proszę wkleić nowy w Studio › Telegram Accounts, wiersz Actions → Replace bot token.

Dlaczego BotFather nie pokazuje Secretary Mode? #

Proszę zaktualizować aplikację Telegram, ponownie wysłać /mybots i otworzyć Bot Settings. W starszych wersjach ustawienie nazywa się jeszcze Business Mode: proszę je włączyć, to ten sam przełącznik.

Więcej na stronie funkcji Konta Telegram.