Создание 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».