Как создать своего Telegram-бота через @BotFather — пошагово с картинками

В Recordo можно подключить бота двумя способами: взять готовый из нашего пула (быстрее) или зарегистрировать свой через @BotFather. Свой удобен, если вы хотите бренд: имя вида @anna_studio_bot, ваш аватар, ваше описание. Регистрация занимает 5 минут и не требует никаких технических знаний — нужен только сам Telegram.

В этой статье — пошагово, с картинками: как создать бота, где взять токен и куда его вставить в Recordo.

Что такое токен и зачем он нужен

Токен — это «ключ» от вашего бота. Любой, кто знает токен, может писать от имени бота и читать переписку клиентов. Это значит две вещи:

• Никогда никому не показывайте токен. Не публикуйте в чатах, не отправляйте в личку «помогу настроить». Если случайно показали — пересоздайте токен у @BotFather командой /revoke.
• Хранить токен в открытом виде в записях, на флешке, в Google-документе — плохая идея. Recordo шифрует токен на своей стороне (AES-256-GCM на отдельном master-key'е) — после того, как вы его вставили, токен из системы уже не достать в открытом виде.

Шаг 1. Откройте @BotFather

@BotFather — это официальный бот Telegram, через который создаются все остальные боты. Других способов нет — все сторонние сервисы либо обёртки над ним, либо мошенники.

1. Откройте Telegram.
2. В поиске наберите @BotFather.
3. Откройте чат с ботом, у которого синяя галочка верификации Telegram рядом с именем.
4. Нажмите Start (или отправьте /start, если уже общались с ним раньше).

Шаг 2. Команда /newbot

В чате с @BotFather отправьте команду:

/newbot

Бот ответит: «Alright, a new bot. How are we going to call it?» Это запрос на «дружелюбное» имя бота — то, которое клиенты увидят в заголовке чата.

Шаг 3. Имя бота

Имя — это любое читаемое название. Может быть с пробелами, на русском, с эмодзи. Примеры:

• Анна — массаж
• Барбершоп «Восток»
• Маникюр у Кати

Это то, что клиент увидит вверху чата. Не путайте с username — он будет на следующем шаге.

Введите имя и отправьте.

Шаг 4. Username (@-имя)

@BotFather попросит username — короткий уникальный идентификатор, который начинается с @ и заканчивается на bot. Это то, что клиенты будут вводить в поиск и видеть в ссылках.

Правила:

• Должен заканчиваться на bot или _bot. Так требует Telegram.
• Только латинские буквы, цифры и подчёркивания.
• 5–32 символа.
• Должен быть свободен — если кто-то занял @vostok_bot, попробуйте @vostok_studio_bot, @vostok_msk_bot и т.п.

Введите username и отправьте.

Шаг 5. Получите токен

Если username свободен, @BotFather ответит длинным сообщением: «Done! Congratulations on your new bot.» Внутри будет строка вида:

1234567890:AAHfRr_KsexampleTokenDontUseThisOneItsFake

Это и есть токен. Скопируйте его целиком — от первой цифры до последнего символа.

Шаг 6. Вставьте токен в Recordo

Зайдите в раздел Бот в кабинете Recordo. Если бот ещё не подключён, вы увидите два таба: «Из пула» и «Свой бот через @BotFather». Выберите второй, вставьте скопированный токен в поле и нажмите «Подключить бота».

Recordo проверит токен у Telegram, зашифрует его и положит к себе в базу. Через пару секунд на странице появится карточка с @username бота и статусом «active» — всё работает.

Шаг 7. (опционально) Настройте внешний вид

В кабинете Recordo во вкладке Внешний вид на странице Бот можно настроить:

• Имя бота — то, что отображается над аватаром в профиле бота.
• Короткое описание — текст под аватаром, до 120 символов.
• Описание — большой текст, который клиент видит в пустом чате до того, как нажмёт /start. До 512 символов.
• Аватар — квадратное JPEG/PNG до 5 МБ. Telegram обрежет в круг.

Все эти изменения уходят в Telegram автоматически — никаких отдельных команд /setdescription, /setabouttext, /setuserpic запускать не нужно.

Частые ошибки

«Sorry, this username is already taken.» — username занят. Добавьте уточнение: город, имя, тип услуги (@vostok_msk_bot, @anna_manicure_bot).

«Sorry, the username must end in 'bot'.» — забыли суффикс. Имена ботов в Telegram обязательно заканчиваются на bot или _bot.

Вставили токен в Recordo, а получаете ошибку «invalid token». — скорее всего, скопировали с лишним пробелом или часть символов. Откройте чат с @BotFather, наберите /mybots, выберите вашего бота, нажмите API Token — там есть кнопка для копирования без лишних символов.

Бот не отвечает клиентам после подключения. Проверьте, что в Recordo вкладке Бот статус карточки — active (не disabled). Если disabled — нажмите «Включить». Если active, но бот молчит — напишите ему /start сами от своего Telegram-аккаунта, чтобы инициализировать диалог: проблема обычно в том, что Telegram кэширует «нет такого бота» у клиента, который видел его до настройки.

Что дальше

После подключения бот сразу умеет принимать записи: услуга → мастер → день → время → подтверждение. Имена услуг, мастеров и расписание он берёт из вашего кабинета Recordo — править ничего не нужно, всё что вы уже завели, появится в боте.

Дальше имеет смысл:

• настроить тексты бота (вкладка «Тексты») — приветствие, подтверждение, напоминание. Можно оставить стандартные.
• настроить поведение (вкладка «Поведение»): разрешить ли клиентам самим переносить запись, показывать ли список услуг и страницу «о мастерах» прямо в боте, добавить контакт оператора.
• поделиться ссылкой на бота клиентам — её можно скопировать прямо с верхней карточки страницы Бот.

Если что-то не получилось — напишите нам, поможем.