Налаштування бота в Telegram і отримання API-ключа

Налаштування бота в Telegram і отримання API-ключа

Перш ніж ми почнемо програмувати, нам потрібен реальний бот у Telegram. Telegram надає зручного "боса-бота" для створення нових ботів — BotFather.

Крок 1. Знайдіть BotFather

Відкрийте Telegram і знайдіть бота з іменем @BotFather. Це офіційний бот від Telegram, який надає інтерфейс для керування іншими ботами. Ви одразу пізнаєте його за верифікованим значком.

Крок 2. Створіть нового бота

Надішліть команду /newbot у чат з BotFather. Бот відреагує і попросить ввести ім'я для вашого нового бота. Назвіть його як завгодно. Наприклад, MyAwesomeBot.

BotFather:

Alright, a new bot. How are we going to call it? Please choose a name for your bot.

Введіть ім'я:

MyAwesomeBot

Крок 3. Вкажіть username

Далі вас попросять вказати унікальне ім'я користувача для бота. Воно має закінчуватися на "bot". Наприклад, MyAwesomeBot_bot. Якщо ім'я вільне, BotFather його прийме.

BotFather:

Good. Now let's choose a username for your bot. It must end in `bot`. For example: TetrisBot or tetris_bot.

Введіть username:

MyAwesomeBot_bot

Крок 4. Отримайте API токен

Після успішного створення бота BotFather надасть унікальний токен у наступному вигляді:

BotFather:

Done! Congratulations on your new bot. You will find it at t.me/MyAwesomeBot_bot. 
You can now add a description, about section, and profile picture for your bot.

Use this token to access the HTTP API:
123456789:ABCDefGhIJKlmNoPqRsTuVWxYz1234567890

Збережіть цей токен — він знадобиться, щоб ваш код міг взаємодіяти з Telegram.

---

Налаштування і безпека токена

Ваш API токен — це ключ до всього вашого бота. Втрата або витік його може призвести до катастрофічних наслідків, тому важливо вжити кроки для його захисту.

Рекомендації щодо безпечного зберігання

• Використання змінних середовища

  Найпопулярніший підхід полягає у використанні змінних середовища. Наприклад, ви можете помістити токен у файл .env:

  
  TELEGRAM_BOT_TOKEN=123456789:ABCDefGhIJKlmNoPqRsTuVWxYz1234567890
  

  І потім прочитати його в Python за допомогою бібліотеки python-dotenv:

  
  pip install python-dotenv
  

  Приклад коду:

  
  from dotenv import load_dotenv
  import os
  
  # Завантажуємо .env файл
  load_dotenv()
  
  # Читаємо значення токена
  TELEGRAM_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")
  
  print(f"Ваш токен: {TELEGRAM_TOKEN}")
  

• Налаштування токена через системні змінні (наприклад, в Docker)

  Якщо ви працюєте в контейнеризованих додатках, ви можете передавати токен у середовище виконання як змінну середовища:

  
  docker run -e TELEGRAM_BOT_TOKEN=123456789:ABCDefGhIJKlmNoPqRsTuVWxYz1234567890 my-telegram-bot
  

• Робота з менеджерами секретів

  Якщо ви розробляєте веб-застосунки в продакшені, використовуйте менеджери секретів, такі як AWS Secrets Manager, HashiCorp Vault або Google Secret Manager.

---

Перевірка зв'язку з ботом

Перед тим як рухатися далі, спробуємо перевірити, що наш бот працює. Для цього надішліть команду /start вашому боту в Telegram. Бот відповідатиме мовчанням, оскільки ми поки нічому його не навчили, але це нормально. Головне, що він існує.

Якщо все зроблено правильно, бот вже відображатиметься в Telegram і готовий до подальшого налаштування.

---

Часто зустрічані проблеми при створенні токена

Якщо у вас виникли труднощі, ось кілька поширених помилок, які можна легко виправити:

Помилка: «Телеграм-бот заблокований»

Telegram може тимчасово заблокувати вашого бота, якщо API токен використовується в нерелевантних запитах. Щоб вирішити проблему, просто створіть новий токен через команду /revoke.

Помилка: «Токен втрачено»

Не панікуйте. Вам потрібно повернутися до BotFather і за допомогою команди /token згенерувати новий токен.

---

Додавання опису і налаштувань бота

Після створення бота ви можете налаштувати його ім'я, опис, зображення профілю та інші параметри через додаткові команди BotFather:

• /setdescription — додати опис, який користувачі побачать в інформації про бота.
• /setabouttext — вказати текст "Про бота".
• /setuserpic — завантажити фото профілю для бота.

Приклад команди:

/setdescription MyAwesomeBot

---

Фінальна перевірка

Після всіх описаних кроків у вас має бути готовий Telegram-бот з унікальним токеном і базовими налаштуваннями. Ви зможете використовувати його токен для подальшої розробки за допомогою бібліотеки python-telegram-bot.

На наступній лекції ми почнемо створювати найпростішого бота, який відповідає на текстові повідомлення. Його перше завдання — відповідати на команди /start і /help. Впевнений, ваш бот готовий до нових звершень!