Как подключить Telegram-бота к BOTBuild за 5 минут

Если вы только думаете о Telegram-магазине — это самая первая и самая короткая статья, которую стоит прочитать. Разберём весь путь: от создания пустого бота в Telegram до момента, когда он отвечает первому покупателю.

На всё уйдёт около 5 минут. Никакого кода, никаких серверов, никакой настройки хостинга. Всё, что нужно — Telegram, аккаунт в BOTBuild и пара чашек терпения.

Что такое «бот» и зачем он магазину

Бот в Telegram — это, по сути, отдельный аккаунт, которым управляет программа, а не человек. Покупатель пишет ему, как обычному собеседнику, нажимает на кнопки, видит каталог, оформляет заказ и оплачивает. На той стороне за всё это отвечает BOTBuild.

Ключевое: один магазин = один бот. У бота своё имя, аватар, описание и токен — секретный ключ, через который BOTBuild им управляет.

Шаг 1. Создаём бота у @BotFather

@BotFather — официальный бот Telegram, через который выпускаются все остальные боты. Это бесплатно и занимает минуту.

1. Откройте Telegram и в поиске вбейте @BotFather (обратите внимание на синюю галочку — это важно, в Telegram есть фейки).
2. Нажмите Start.
3. Отправьте команду /newbot.
4. BotFather спросит имя бота — это то, как он будет отображаться в чатах. Например: Мой магазин одежды. Кириллица разрешена.
5. Дальше попросит username — техническое имя, которое должно заканчиваться на bot. Например: my_clothing_shop_bot. Если занято — придумайте другое.
6. После успешного создания BotFather пришлёт сообщение с токеном вида:

1234567890:AAEhBP0av28_M5l5fzZuKv6Vw...

Это и есть ключ. Никому его не показывайте. Тот, у кого есть токен, может управлять ботом так же, как вы.

Шаг 2. Настраиваем «лицо» бота (необязательно, но желательно)

Прямо в чате с BotFather можно сразу настроить внешний вид — это влияет на доверие покупателя:

• /setdescription — короткое описание (видно в профиле бота).
• /setabouttext — текст «About», который виден перед первым /start.
• /setuserpic — аватар бота. Загрузите логотип или фото товара.
• /setcommands — список команд (BOTBuild настроит их сам, но при желании можно дополнить).

Эти настройки можно вернуть и поменять в любой момент — они не влияют на работу BOTBuild.

Шаг 3. Подключаем бота в BOTBuild

Теперь самое простое.

1. Войдите в админку BOTBuild.
2. Перейдите в раздел Магазины → Создать магазин.
3. Введите название магазина (это для вас, покупатель его не увидит) и вставьте токен, который прислал BotFather.
4. Нажмите Создать.

Через несколько секунд BOTBuild подключится к боту, и в списке магазинов он засветится зелёным — значит, всё работает.

Если бот не подключается — обычно дело в опечатке в токене. Скопируйте его ещё раз из сообщения BotFather и вставьте заново.

Шаг 4. Проверяем, что бот живой

Откройте бота по ссылке вида t.me/ваш_username_bot и нажмите Start. Если бот отвечает приветственным сообщением — поздравляем, он подключён.

На этом этапе бот ещё «голый»: каталог пустой, оплата не настроена, тексты дефолтные. Это нормально — следующим шагом идёт настройка магазина.

Шаг 5. Что дальше

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

• Каталог — добавьте хотя бы одну категорию и один товар. На превью покупателей удивляет, насколько быстро это собирается.
• Способы оплаты — подключите хотя бы один. ЮKassa, CryptoBot, ручные платежи — выбирайте, что ближе.
• Тексты и кнопки — в конструкторе можно переписать любое сообщение бота, не трогая код.

Каждая из этих частей — отдельная статья. Но если хотите, можно открыть бота и поиграться прямо сейчас: всё, что вы меняете в админке, в боте появляется мгновенно.

Типовые ошибки

«Unauthorized» при подключении. Токен скопирован с лишним пробелом или не полностью. Откройте чат с BotFather, нажмите на токен — он скопируется целиком.

Бот не отвечает на /start. Проверьте, что магазин в BOTBuild помечен как активный. Если только что подключили — подождите 5–10 секунд, бот «прогревается».

Случайно отозвал токен через /revoke. Старый перестанет работать. Возьмите новый у BotFather, откройте настройки магазина в BOTBuild и обновите. Все данные магазина при этом сохранятся.

Хочу второго бота. В BOTBuild можно подключить сколько угодно магазинов — каждый со своим ботом. Просто создайте ещё один магазин и повторите шаги 1–3.

Итог

Пять минут назад у вас не было ничего, кроме идеи. Сейчас — работающий бот, готовый принимать первые заказы, как только вы заполните каталог. Остальное — уже про продукт и продажи, а это самая интересная часть.