Создайте первого Telegram-бота за 10 минут

Каждый Telegram-бот принадлежит аккаунту в Telegram, и ключ от бота выдаёт сам Telegram, а не мы. Его даёт официальный бот Telegram — BotFather. Этот шаг удобно сделать с телефона.

1. Откройте Telegram и найдите @BotFather. Выберите того, у кого синяя галочка.
2. Нажмите кнопку внизу чата (Запустить или Start), затем отправьте /newbot.
3. BotFather спросит имя бота. Его люди видят вверху чата — например Acme Support. Отправьте его.
4. Затем BotFather спросит username. Он должен быть уникальным во всём Telegram и заканчиваться на bot — например acme_support_bot. Если имя занято, BotFather так и напишет — попробуйте другое.
5. BotFather пришлёт сообщение примерно такого вида (оно на английском):

Done! Congratulations on your new bot. You will find it at t.me/acme_support_bot.
...
Use this token to access the HTTP API:
7212345678:AAHfK3x9Qm2LpZr8TnVw4yBc6DeFgHiJkLo
Keep your token secure and store it safely, it can be used by anyone to control your bot.

Токен — это длинная строка с двоеточием посередине: цифры, двоеточие, потом буквы и цифры. Скопируйте только её, а не всё сообщение. В большинстве приложений Telegram токен копируется простым нажатием на него.

Токен — это пароль от бота: у кого он есть, тот и управляет ботом. Не отправляйте его в общие чаты и не показывайте на скриншотах.

Этот шаг можно отложить: окно, куда вы вставите токен (шаг 5), повторяет эту инструкцию.

Зарегистрируйтесь в FlowCastle. Первый экран называется Создайте первую автоматизацию, на нём три варианта. Нажмите Начать с нуля.

Работают все три варианта, но именно этот лучше всего показывает, из чего состоит бот:

• Начать с шаблона — готовый бот, который остаётся настроить под себя.
• Собрать с ИИ — первый черновик по вашему описанию в одну фразу.
• Начать с нуля — маленький рабочий бот, который можно прочитать целиком.

Вопреки названию, пусто не будет: сразу создаются два сценария, поэтому бот отвечает с первой минуты. Сценарий — это один путь разговора: шаги, которые бот проходит по порядку.

• Приветственный сценарий — то, что видит человек, написавший боту
• Главное меню — пример меню из трёх кнопок

Вы попадаете на страницу Автоматизация. Большая область в точку справа — это холст, логика бота. Слева от него — список Сценарии.

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

• Стартовый шаг — с него начинается диалог, когда человек отправляет /start
• Приветственное сообщение — текст, который отправляет бот
• Открыть главное меню — переход в сценарий Главное меню

1. Нажмите на блок Приветственное сообщение. Редактор откроется в левой части экрана.
2. В поле Текст сообщения замените текст на свой: скажите, чем бот полезен и что человеку делать дальше.
3. Нажмите Сохранить изменения внизу редактора.

Теперь откройте сценарий Главное меню и сделайте то же самое. Нажмите на блок Главное меню, чтобы переименовать три кнопки — например, замените 💬 Помощь на то, с чем ваш бот действительно помогает. Потом нажмите на каждый блок с ответом (Ответ: помощь, Ответ: о нас, Ответ: контакты) и напишите настоящий ответ. Каждый раз нажимайте Сохранить изменения.

Вот и весь навык. Сценарий — это блоки, которые что-то отправляют, и блоки, которые что-то решают, соединённые в нужном порядке.

Нажмите Тест на панели вверху справа.

Справа откроется панель Тест бота. Здесь вы разговариваете с ботом так же, как будет делать пользователь, — ещё до публикации и не заходя в Telegram. Первое сообщение бот пришлёт сам, дальше нажимайте кнопки или пишите, как обычный пользователь.

Нажмите каждую кнопку меню. Если что-то читается плохо, поправьте это на холсте, нажмите Сохранить изменения и проверьте снова.

Вкладка Логи рядом с вкладкой Чат показывает, что бот сделал на каждом шаге. Туда стоит смотреть, когда бот повёл себя не так, как вы ждали.

Нажмите Опубликовать на панели вверху справа. Публикация переносит текущие сценарии в настоящего бота. Канал ещё не подключён, поэтому сначала откроется окно Запуск.

1. Выберите Telegram.
2. Вставьте токен из шага 1 в поле Токен бота.
3. Нажмите Подключить и опубликовать.

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

Потом откройте Telegram, найдите бота по выбранному username и отправьте /start. Он ответит.

Вернитесь на холст, измените любое сообщение и нажмите Сохранить изменения.

Посмотрите в Telegram: там всё ещё старый текст. Сохранённые правки живут на холсте, пока вы их не опубликуете.

Теперь нажмите Опубликовать — на этот раз без всяких окон. Напишите боту снова: текст новый.

Этот цикл вы будете повторять всегда: правка → Сохранить изменения → Тест → Опубликовать. Помнить о нём — главное различие между ботом, который улучшается каждую неделю, и ботом, который тихо устарел.

• Научите бота по-разному реагировать на разные ответы: Блок «Условие»: основы
• Пишите сообщения лучше — с кнопками и переменными: Блок «Сообщение»: основы
• Поставьте того же бота на сайт, не собирая его заново: Чат-виджет на вашем сайте

BotFather пишет, что username занят. Имена в Telegram общие для всех. Добавьте название компании или уточняющее слово.

«Подключить и опубликовать» показывает ошибку про токен. Скорее всего, вы скопировали лишний текст. Вставьте только строку с токеном — цифры, двоеточие, потом буквы и цифры — без пробелов.

Бот не отвечает на /start. Проверьте, что публикация завершилась и что вы пишете боту с вашим username: поиск в Telegram часто первым показывает другого бота с похожим именем.

Изменения не появляются. Сохранить — не значит опубликовать. Нажмите Опубликовать.

Бот работает — теперь научитесь добавлять на холст свои шаги: Как добавить первый блок