SHIPIT by Dzhura · Telegram

Перший бот: від ідеї до /start

Гайд 3 з 6 · без програмування
Огляд · Навіщо Telegram і чому саме він · Які бувають боти і що ти зробиш сам · Перший бот: від ідеї до /start · Нагадування й автоматизації · Розмова з агентом у Telegram · Де живе бот і чому він мовчить

Ти отримаєш робочого бота, якому можна написати /start і натиснути кожну кнопку. Код пише агент. Твоя частина: токен, прості відповіді і перевірка.

Підготовка

01Що має бути напоготові

Telegram

02Отримай токен у @BotFather

  1. Відкрий Telegram і знайди @BotFather із синьою галочкою.
  2. Надішли /newbot.
  3. Вигадай назву. Її потім можна змінити.
  4. Вигадай username: від 5 до 32 символів, латиниця, цифри й підкреслення, обовʼязково з bot наприкінці. Його потім змінити не можна.
  5. @BotFather надішле токен: довгий рядок. Він не обліковий запис, а ключ саме до цього бота.

Токен — як пароль. Не показуй його нікому, не клади в скриншоти й у код. Якщо він випадково став відомим, згенеруй новий у @BotFather командою /token.

Чи можна вставити токен у чат з агентом?

Можна, але пам’ятай: усе, що ти пишеш агентові, іде до компанії, чий це агент, як описано в розділі про дані в першому запуску. Найбезпечніше, щоб токен потрапив тільки у файл .env на твоєму комп’ютері. Агент створить цей файл і покаже, куди його вписати. Для тестового бота це не страшно, а для бота з реальними клієнтами, коли закінчиш, згенеруй токен заново.

Конструктор

03Збери завдання в конструкторі

Відкрий dzhura.app/build і вибери Telegram-бот. Відповідай на прості питання: що бот робить, як називається, якою мовою говорить, які кнопки мають бути, куди писати дані і кому надсилати сповіщення. Наприкінці конструктор збирає готове завдання для агента.

Обери, де працюватимеш: SHIPIT, Claude Code або Codex. Конструктор покаже короткі кроки саме для твого вибору. У застосунку SHIPIT той самий конструктор вбудований у розділ Промпти › Створити (англійською Prompts › Make): там не треба відкривати сайт. Якщо цього розділу ще немає, онови SHIPIT.

Не знаю, що відповісти

Обери найближче «Призначення», а решту дай конструктору за замовчуванням. Склади в полі «Своїми словами» одне-два речення про те, що бот має робити для людини. Агент уточнить усе інше сам.

Агент

04Віддай завдання агентові

  1. Створи порожню папку, наприклад my-bot, і відкрий у ній термінал. У SHIPIT: вкладка Agent, новий проєкт my-bot.
  2. Запусти claude або codex, встав завдання з конструктора і натисни Enter.
  3. Відповідай агентові на запитання. Коли він попросить токен, дай його (див. вище, як це зробити безпечніше).
Яку модель агента обрати

Для першого бота вистачить моделі за замовчуванням. Якщо хочеш розібратися, чим моделі відрізняються і коли міняти, прочитай «Яку модель обрати?».

Агент пише код простими файлами, додає .env у .gitignore, кладе поруч .env.example без справжніх значень, пише README і запускає бота локально.

Перевірка

05Перевір сам

  1. У Telegram знайди свого бота за username і натисни Start. Поки ти цього не зробив, бот не зможе писати тобі в особисті.
  2. Натисни кожну кнопку меню. Перевір, що відповіді правильні, а Скасувати повертає назад без помилок.
  3. Якщо бот має сповіщати тебе, зроби тестове замовлення чи запис і подивись, чи прийшло повідомлення.
  4. Якщо дані ідуть у таблицю, відкрий її і знайди новий рядок.
Бот не відповідає

Майже завжди бот просто не запущений. Перелік перевірок у гайді Де живе бот і чому він мовчить.

Далі

06Зроби так, щоб бот працював завжди

Поки бот запущено на твоєму Mac, він працює, тільки коли Mac ввімкнений. Наприкінці агент порівняє два способи, як зробити його незалежним від комп’ютера, і порадить один. Це окремий розділ: Де живе бот.

Змінити бота пізніше просто: відкрий ту саму папку і скажи агентові, що змінити. Наприклад, «додай кнопку Ціни» чи «зміни привітання». Якщо результат не сподобався, попроси скасувати останню зміну: Git тримає попередню версію.

← Які бувають боти і що ти зробиш самНагадування й автоматизації →