Як створити чат-бота в Telegram для автоматичного прийому повідомлень?

Як створити чат-бота в Telegram для автоматичного прийому повідомлень

Створення Telegram бота для автоматичного прийому повідомлень — завдання, яке здається складним лише на перший погляд. За допомогою офіційного інструменту BotFather та кількох рядків коду ви можете налаштувати власного асистента для відстеження вхідних даних, авто-відповідей або збору зворотного зв'язку. У цьому посібнику ми розглянемо весь процес: від створення бота через BotFather до вибору оптимального способу отримання повідомлень (полінг або вебхук), а також розберемо типові помилки та способи їх усунення. Після завершення ви зможете запустити власного бота за лічені хвилини.

Передумови та підготовка

Перш ніж почати створення бота, переконайтеся, що у вас є:

• Обліковий запис Telegram — будь-який, навіть без преміум-підписки.
• Активне інтернет-з'єднання для реєстрації бота та подальшої роботи з API.
• Базові знання мови програмування (на прикладі Python, але ви можете використовувати будь-яку мову з підтримкою HTTP-запитів).
• Встановлений Python 3.7+ та менеджер пакетів pip (за бажанням використовуйте віртуальне середовище).

Цього набору достатньо, щоб почати. Ми будемо використовувати бібліотеку python-telegram-bot — одну з найпопулярніших і добре документованих. Станом на момент написання цього гайда (2026 рік) актуальною є версія 20.x, яка підтримує асинхронність та сучасні можливості Telegram API.

Створення бота через BotFather

BotFather — це офіційний бот Telegram, який дозволяє створювати та керувати іншими ботами. Процес займає буквально кілька хвилин:

1. Відкрийте Telegram та знайдіть @BotFather. Почніть діалог і надішліть команду /newbot.
2. Вас попросять ввести ім'я бота (наприклад, «Мій Перший Бот») — воно буде відображатися в контактах.
3. Потім введіть унікальний username бота, який має закінчуватися на bot (наприклад, MyFirstTestBot). Якщо ім'я вільне, BotFather підтвердить створення та надішле вам токен доступу.
4. Збережіть токен у безпечному місці — він є ключем до керування вашим ботом. Не публікуйте його в загальнодоступних репозиторіях.

Після завершення ви можете одразу написати своєму боту перше повідомлення (наприклад, /start) — поки що він не відповідатиме, оскільки не має логіки обробки. Але ви вже можете бачити, що бот існує. Тепер, коли бот створений, необхідно вирішити, яким чином він отримуватиме повідомлення.

Вибір способу отримання повідомлень: полінг vs вебхук

Перед написанням коду варто визначитися, яким чином ваш бот отримуватиме нові повідомлення. Telegram API пропонує два основних підходи:

Полінг (Polling)

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

Як це працює: Викликаєте метод getUpdates з інтервалом (наприклад, кожні 1–2 секунди). Отримані оновлення обробляються, після чого ви можете передати параметр offset, щоб не отримувати одні й ті самі повідомлення повторно. Полінг реалізується кількома рядками коду, що робить його ідеальним для початкового знайомства з API.

Вебхук (Webhook)

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

Вибір між полінгом і вебхуком залежить від сценарію використання. Якщо ви тільки починаєте або бот обслуговує невелику кількість користувачів (до 1000 активних чатів), полінг цілком прийнятний. Для ботів, які приймають тисячі повідомлень на день, вебхук рекомендований. Обраний метод впливає на написання коду та розгортання — розглянемо обидва варіанти на практиці.

Критерій	Полінг	Вебхук
Публічна адреса	Не потрібна	Обов'язкова (HTTPS)
Час реакції	Залежить від інтервалу	Майже миттєво
Навантаження на сервер	Середнє	Низьке
Складність налаштування	Проста	Помірна (потрібен SSL)

Написання коду: приклад на Python з полінгом

Для початку створимо простого бота, який автоматично приймає повідомлення та відповідає на них. Ми використаємо бібліотеку python-telegram-bot. Встановіть її через pip:

pip install python-telegram-bot==20.7

Тепер створіть файл bot.py з наступним вмістом:

import asyncio
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters

# Вставте ваш токен сюди
TOKEN = 'ВАШ_ТОКЕН_ВІД_BOTFATHER'

async def start(update: Update, context):
    await update.message.reply_text('Привіт! Я бот, який приймає повідомлення автоматично.')

async def echo(update: Update, context):
    # Автоматично відповідаємо тим самим текстом
    await update.message.reply_text(f'Ви написали: {update.message.text}')

def main():
    # Створюємо Application
    app = Application.builder().token(TOKEN).build()

    # Додаємо обробники
    app.add_handler(CommandHandler('start', start))
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

    # Запускаємо полінг
    app.run_polling()

if __name__ == '__main__':
    main()

Цей бот використовує полінг: він запускає нескінченний цикл, який кожні кілька секунд перевіряє нові повідомлення. Коли хтось пише боту, спрацьовує функція echo, яка надсилає у відповідь той самий текст. Ви можете змінити логіку на власний розсуд — наприклад, зберігати повідомлення в базу даних або пересилати їх адміністратору. Завдяки асинхронній архітектурі бот залишається чуйним навіть при одночасній обробці кількох запитів.

Налаштування вебхука для продакшн-середовища

Якщо ви плануєте запускати бота на сервері, вебхук — більш надійний варіант. Для цього вам знадобиться:

• Публічна доменна адреса з SSL-сертифікатом (можна використовувати Let's Encrypt).
• Сервер, який приймає POST-запити від Telegram (наприклад, Flask або FastAPI).
• Один виклик методу setWebhook для реєстрації URL.

Приклад на Python з використанням Flask та вебхука:

from flask import Flask, request
import telegram

TOKEN = 'ВАШ_ТОКЕН'
bot = telegram.Bot(token=TOKEN)
app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def webhook():
    update = telegram.Update.de_json(request.get_json(force=True), bot)
    # Обробка оновлення
    if update.message:
        chat_id = update.message.chat.id
        text = update.message.text
        bot.send_message(chat_id=chat_id, text=f'Отримано: {text}')
    return 'OK', 200

if __name__ == '__main__':
    # Спочатку встановіть вебхук
    bot.set_webhook(url='https://ваш-домен.com/webhook')
    app.run(host='0.0.0.0', port=8443, ssl_context=('cert.pem', 'key.pem')) # SSL обов'язковий

Зверніть увагу: Telegram приймає вебхуки лише на порти 80, 443, 88, 8443. Найчастіше використовують 443 або 8443. Для тестування можна скористатися сервісами на кшталт ngrok, який надає публічний HTTPS-тунель до вашого локального сервера. Це дозволяє відлагоджувати вебхук без придбання домену.

Автоматизація прийому повідомлень: розширені сценарії

Простий ехо-бот — це лише початок. Реальна автоматизація передбачає обробку повідомлень за певними правилами. Ось кілька типових прикладів, які ви можете адаптувати під свої потреби:

Фільтрація за ключовими словами

Ви можете налаштувати бота реагувати лише на повідомлення, що містять певні слова, та ігнорувати інші. Наприклад, якщо ви очікуєте заявки зі словом "допомога", додайте відповідний фільтр filters.Text(['допомога']). Це зручно для збору скарг або заявок, коли потрібно відокремити важливі повідомлення від загального потоку.

Пересилання повідомлень адміністратору

Бот може приймати повідомлення від користувачів і автоматично пересилати їх у приватний чат адміністратора або в групу. Для цього потрібно знати chat_id одержувача. Приклад: використайте метод context.bot.forward_message(chat_id=ADMIN_CHAT_ID, from_chat_id=update.message.chat.id, message_id=update.message.message_id).

Збереження в базу даних

Якщо ви збираєте зворотний зв'язок або замовлення, доцільно зберігати повідомлення в SQLite або PostgreSQL. У бібліотеці python-telegram-bot є зручний механізм збереження даних через PicklePersistence або власний клас. Це дозволяє зберігати стан бота між перезапусками.

from telegram.ext import PicklePersistence

persistence = PicklePersistence(filepath='bot_data.pickle')
app = Application.builder().token(TOKEN).persistence(persistence).build()
# Тепер дані бота зберігаються між перезапусками

Усунення несправностей

Навіть при ретельному налаштуванні можуть виникнути проблеми. Розглянемо типові симптоми, їх причини та способи вирішення.

Симптом: бот не відповідає на повідомлення

Можливі причини:

• Токен неправильний або неактивний. Перевірте через /token у BotFather.
• Бот зупинений або не запущений. Переконайтеся, що скрипт працює.
• При використанні вебхука — неправильно встановлений URL або SSL-сертифікат.
• Фільтри повідомлень не пропускають текст (наприклад, використано лише filters.TEXT, а користувач надсилає фото).

Симптом: помилка 409 Conflict при вебхуці

Це означає, що ви намагаєтеся одночасно використовувати полінг і вебхук. Зупиніть усі екземпляри бота, які використовують getUpdates, а потім видаліть вебхук командою bot.delete_webhook(). Після цього можна знову запустити полінг або встановити вебхук.

Симптом: бот отримує повідомлення з великою затримкою

При полінгу затримка залежить від інтервалу опитування. Зменшіть інтервал (наприклад, до 0.5 секунди), але врахуйте, що це збільшить навантаження на сервер Telegram. При вебхуці затримка зазвичай мінімальна; перевірте, чи сервер має достатню продуктивність та чи не блокується чергою обробки.

Чек-лист застосовних та незастосовних сценаріїв

Сценарій	Рекомендація
Особистий помічник для нагадувань	Підходить полінг, простий код.
Бот підтримки для невеликої компанії (до 500 клієнтів)	Вебхук рекомендовано, але полінг також працюватиме.
Високонавантажений бот (понад 10 000 повідомлень на день)	Вебхук обов'язковий, можливо знадобиться кешування та асинхронна обробка.
Бот для миттєвого опитування в реальному часі	Вебхук, оскільки критична затримка.
Бот, який працює лише у вихідні дні	Полінг простіше, можна запускати за розкладом.
Бот, який обробляє конфіденційні дані (паролі, фінанси)	Вебхук з додатковим шифруванням, обов'язковий HTTPS, але краще розглянути альтернативи (не Telegram).

Найкращі практики для надійної роботи бота

1. Завжди використовуйте змінні середовища для зберігання токена та конфіденційних даних.
2. Логуйте помилки — це допоможе швидко виявити проблеми. Використовуйте модуль logging.
3. Встановлюйте ліміти на швидкість (rate limiting) для запобігання флуду. Telegram API має власні обмеження (30 повідомлень на секунду на чат), але ваш бот може бути заблокований, якщо перевищуватиме їх.
4. Обробляйте винятки — не дайте боту впасти через одну помилку. У python-telegram-bot використовуйте error_handler.
5. Регулярно перевіряйте справність вебхука (наприклад, через метод getWebhookInfo).
6. Забезпечте безпеку — перевіряйте, що запити дійсно надходять від Telegram (можна перевіряти заголовок X-Telegram-Bot-Api-Secret-Token).

Висновок

Створення Telegram бота для автоматичного прийому повідомлень — завдання, яке можна виконати за лічені хвилини завдяки BotFather та сучасним бібліотекам. Головне — правильно обрати метод отримання оновлень (полінг для тестування, вебхук для продакшну) та написати чітку логіку обробки. Використовуючи наведені приклади коду та чек-лист, ви зможете запустити власного бота, який буде працювати стабільно та безпечно.

Наступним кроком може бути інтеграція з іншими сервісами (Google Sheets, CRM, Slack) або додавання платіжної системи через Telegram Payments. Пам'ятайте: автоматизація має починатися з малого — спочатку реалізуйте базовий прийом повідомлень, а потім поступово додавайте нові функції. З розвитком Telegram API та бібліотек, таких як python-telegram-bot, створення ботів стає все простішим — можна очікувати подальшої інтеграції зі штучним інтелектом та хмарними сервісами.

Часті запитання

Чи можна створити бота без програмування?

Існують платформи-конструктори (наприклад, ManyChat, Chatfuel), які дозволяють створити простого бота без коду. Однак для автоматичного прийому повідомлень із власною логікою вам знадобиться хоча б базове програмування. Telegram Bot API — це HTTP-інтерфейс, тому ви можете використовувати будь-яку мову, яка підтримує HTTP-запити.

Чи потрібен сервер для роботи бота?

Так, бот повинен постійно працювати, щоб приймати повідомлення. Для полінгу достатньо навіть слабкого VPS або Raspberry Pi. Для вебхука необхідний сервер з публічною адресою та SSL. Як тимчасове рішення можна використовувати хмарні сервіси (AWS Lambda, Google Cloud Functions) або безкоштовні хостинги з підтримкою Python.

Як дізнатися chat_id користувача?

Коли користувач надсилає повідомлення боту, ви можете отримати його chat_id з об'єкта Update: update.message.chat.id. Також можна використовувати бота @userinfobot для отримання вашого власного chat_id. Для групи chat_id — це від'ємне число, яке можна знайти, додавши бота в групу та надіславши повідомлення.

Чи можна, щоб бот ініціював діалог першим?

Ні, Telegram забороняє ботам надсилати повідомлення користувачам, які не написали боту першими (це стосується і груп). Виняток — канали, де бот може публікувати пости, але це не є особистим повідомленням. Для розсилок використовуйте офіційний метод sendMessage лише тим, хто вже взаємодіяв з ботом.

Як виправити помилку 'Conflict: terminated by other getUpdates request'?

Ця помилка виникає, коли одночасно використовуються полінг і вебхук. Зупиніть усі екземпляри бота, які використовують getUpdates, а потім викличте https://api.telegram.org/bot{TOKEN}/deleteWebhook. Після цього можна знову запустити полінг або встановити вебхук.