Створення Telegram-бота для акаунта (BotFather, Secretary Mode, token)
Щоб створити Telegram-бота для акаунта LanaChat, надішліть /newbot боту @BotFather у Telegram, увімкніть у бота Secretary Mode, а потім вставте в LanaChat token, який надішле BotFather. Це займає три хвилини, безкоштовно, і Telegram Premium не потрібен.
Кожен акаунт Telegram у LanaChat відповідає фанам через власного бота. Ці три кроки виконуються один раз для кожного бота, на кроці Create the bot майстра Add account (Studio › Telegram Accounts). Потім ви прив'язуєте бота до акаунта Telegram авторки в Telegram Business (остання частина цього посібника).
Перед початком #
- Telegram, відкритий на телефоні чи комп'ютері, у будь-якому акаунті Telegram (підійде ваш: бот не прив'язаний до акаунта, який його створює).
- У Console: Studio › Telegram Accounts → Add account, кроки Creator і Details пройдено. Ви на кроці 3, Create the bot.
- Доступ до акаунта Telegram авторки для останньої частини (прив'язка в Telegram Business).
Крок 1: створіть бота командою /newbot #
- У Telegram знайдіть @BotFather і відкрийте його. Перевірте синю галочку: офіційний лише він.
- Натисніть Start, потім надішліть
/newbot. - BotFather просить ім'я. Це відображуване ім'я бота, наприклад *Julia Assistant*. Підійде будь-який текст, з пробілами, і його можна змінити пізніше.
- BotFather просить ім'я користувача. Це @ бота, унікальний у всьому Telegram. Правила:
- Від 5 до 32 символів: лише літери, цифри та
_, без пробілів і дефісів. - Має закінчуватися на
bot(абоBot), наприкладjulia_it_5_botабоJuliaItBot. - Змінити його потім не можна: виберіть таке, яке ви впізнаєте у списку.
- Від 5 до 32 символів: лише літери, цифри та
- BotFather відповідає *Done! Congratulations on your new bot.* з посиланням на бота та його token.
Порада Називайте бота за акаунтом, який він вестиме, наприклад julia_it_meta_5_bot для акаунта *Julia IT Meta Ads 5*. Коли акаунтів кілька, одразу видно, який бот веде який акаунт.
Ім'я користувача вже зайняте: що робити? #
BotFather відповідає *Sorry, this username is already taken.* Імена користувачів унікальні в усьому Telegram: додайте слово чи цифру й надішліть знову: julia_it_5_bot, потім julia_it_5b_bot і так далі. Якщо BotFather відповідає, що ім'я користувача недійсне, перевірте, що воно закінчується на bot і містить лише літери, цифри та _.
У майстрі позначте перший пункт, потім введіть ім'я користувача в Enter the bot username (з @ або без). Поле приймає його, лише якщо воно відповідає правилам вище.
Крок 2: увімкніть Secretary Mode (обов'язково) #
Secretary Mode це нова назва, яку BotFather дав режиму Business Mode. Без нього Telegram не приймає бота в Telegram Business, і акаунт ніколи не підключиться.
- У @BotFather надішліть
/mybots. - Виберіть щойно створеного бота.
- Натисніть Bot Settings, потім Secretary Mode, потім Turn on.
- BotFather підтверджує: *Secretary Mode is currently enabled for @your_bot*.
Позначайте пункт Turn on Secretary Mode у майстрі, лише коли побачите цю фразу. Пункт позначено як обов'язковий: без нього кнопка Next залишається заблокованою.
Крок 3: вставте token у LanaChat #
Token міститься в повідомленні BotFather *Done! Congratulations*, після *Use this token to access the HTTP API*. Він виглядає так: 12345678:AAxxxx…, тобто від 8 до 10 цифр, двокрапка, потім 35 символів.
- У BotFather натисніть на token, щоб скопіювати його повністю.
- У майстрі вставте його в Paste the token BotFather sent.
- LanaChat перевіряє його й показує *Token accepted. It is never shown again.* Натисніть Next.
Якщо повідомлення загубилося, надішліть /mybots у @BotFather, виберіть бота, потім API Token: BotFather покаже його знову.
Тримайте token у секреті #
Token це пароль бота: будь-хто, у кого він є, може читати й надсилати повідомлення від імені бота, тобто в акаунті авторки.
- Вставляйте його лише в LanaChat. Ніколи не надсилайте його в чаті, листі, на скриншоті чи у зверненні до підтримки. Підтримка LanaChat ніколи його не просить.
- Якщо він витік, одразу відкличте його: у @BotFather надішліть
/revokeі виберіть бота (або/mybots→ бот → API Token → Revoke current token). Старий token одразу перестає працювати, і BotFather надсилає новий. - Потім передайте новий token у LanaChat: у Studio › Telegram Accounts відкрийте меню Actions рядка → Replace bot token і вставте його. Там приймається лише новий token того самого бота.
Прив'язка бота до акаунта авторки #
Далі майстер переходить до кроку 4, Connect in Telegram. В акаунті Telegram авторки (а не в акаунті, який створив бота):
- Відкрийте Settings → Telegram Business → Chat Automation (у деяких версіях Chatbots).
- Додайте бота за його @ (у майстрі є кнопка Copy) і залиште *All Private Chats Except…*.
- У Bot permissions увімкніть Manage Messages (позначено як Required): без цього LanaChat не може відповідати.
- Manage Profile, Manage Gifts and Stars і Manage Stories необов'язкові, але рекомендовані. Усередині Gifts and Stars залиште Transfer Stars і Transfer and Upgrade Gifts вимкненими, якщо не хочете, щоб LanaChat переказував гроші.
Вікно саме перемикається на Connected as @username. Натисніть Done. ШІ нового акаунта вимкнено: увімкніть його, коли авторка буде готова. Статуси й що робити, якщо підключення чекає, описано в Підключення акаунтів Telegram.
Які помилки трапляються найчастіше? #
- Забули Secretary Mode: бота не можна додати в Chat Automation, або акаунт залишається в статусі Waiting for Telegram. Увімкніть його в @BotFather (крок 2), потім знову додайте бота в Telegram.
- Token вставлено з помилкою: *This is not a bot token: 8 to 10 digits, a colon, then 35 characters.* або *Token not accepted*. Досить пробілу, перенесення рядка чи пропущеного символу. Скопіюйте його знову з BotFather і вставте лише його.
- Token іншого бота: під час заміни token іншого бота відхиляється (*This token belongs to another bot*). Вставте новий token того самого бота.
- Бот уже використовує інший акаунт: майстер показує *This bot is already in use* і пропонує Use it for this account too. Погоджуйтеся лише для акаунта тієї самої авторки: Stars обох акаунтів надходять на один баланс бота. Інакше створіть нового бота через
/newbot. - Manage Messages вимкнено: акаунт підключається, але LanaChat не може відповідати. У Chat Automation увімкніть Manage Messages разом із Reply to Messages.
- Бота додано не в той акаунт Telegram: бота треба додати в акаунт авторки, той, якому пишуть фани. В акаунта Telegram одночасно лише один бот: новий замінює попереднього.
FAQ #
Створення Telegram-бота платне? #
Ні. @BotFather створює ботів безкоштовно, а Telegram Premium не потрібен, щоб бот Secretary вів акаунт.
Чи можна створити бота зі свого акаунта Telegram? #
Так. Бот належить акаунту Telegram, який створив його в BotFather, але його можна додати до будь-якого акаунта в Telegram Business. Лише останню частину (Chat Automation) треба зробити в акаунті авторки.
Чи потрібен окремий бот для кожного акаунта Telegram? #
За замовчуванням так: один бот на акаунт тримає Stars кожного акаунта окремо. Бот також може вести кілька акаунтів однієї авторки, якщо вибрати його в Use an existing bot на кроці 3.
Чи можна потім перейменувати бота? #
Ім'я так: /mybots → бот → Edit Bot → Edit Name. Ім'я користувача (@) змінити не можна: створіть нового бота й використайте Change bot в Edit акаунта, якщо потрібен інший.
Що робити, якщо мій token витік? #
Надішліть /revoke у @BotFather і виберіть бота: старий token одразу перестає працювати. Потім вставте новий у Studio › Telegram Accounts, рядок Actions → Replace bot token.
Чому BotFather не показує Secretary Mode? #
Оновіть застосунок Telegram, знову надішліть /mybots і відкрийте Bot Settings. У старих версіях налаштування ще називається Business Mode: увімкніть його, це той самий перемикач.
Докладніше на сторінці функції «Акаунти Telegram».