Як створити чат-бот у Telegram · Організаторам подій

Навіщо це вам

Чат-бот — це канал, у якому з вами говорять там, де людям зручно. Він тримає розмову з гостем після події, відповідає на типові питання цілодобово і збирає аудиторію.

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

Крок 1. Створіть бота в @BotFather

Відкрийте Telegram і знайдіть у пошуку @BotFather. У офіційного бота біля імені стоїть синя галочка — перевірте її, ботів-двійників вистачає.
Натисніть «Запустити» (Start).
Надішліть команду /newbot.
Вкажіть назву — її бачитимуть люди в чаті. Наприклад, «Кава на Подолі».
Вкажіть нікнейм — за ним бота знаходять у пошуку. Він має бути унікальним і закінчуватися на bot: наприклад, kava_podil_bot.

Після цього BotFather надішле повідомлення з посиланням на бота і токеном — довгим рядком виду 1234567890:AAH…. Це ключ від бота: хто має токен, той керує ботом. Не пересилайте його в чати й не публікуйте.

Якщо бот у вас уже є

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

Крок 2. Підключіть бота в AOA

Увімкніть модуль: Налаштування → Модулі в кабінеті організації (у закладі — Налаштування → Відображення), перемикач «Чат-боти».
Відкрийте вкладку Чат-боти.
Вставте токен у поле й натисніть «Підключити».

Токен зберігається зашифрованим. Ми не читаємо ваші особисті чати — бот бачить лише те, що люди пишуть саме йому.

Крок 3. Перевірте бота на собі

Натисніть «Відкрити в Telegram» і надішліть боту /start. У відповідь прийде «✅ Бот активований» — це означає, що ланцюжок працює наскрізь: ваш бот → наш сервер → відповідь. Заразом ви станете його першим підписником і зможете тестувати на собі все, що налаштуєте далі.

Одна деталь, яка часто дивує: бот не може написати першим. Так влаштований Telegram — доки людина не натисне Start, чату не існує. Тому посилання на бота варто поставити скрізь, де вас читають: у профілі, на афіші, у підтверджувальному листі.

Що налаштувати першим

Меню команд — те, що Telegram показує у списку «/». Мінімум: /start і /help. Опис бачать усі, тож пишіть його для гостя, а не для себе.
Стандартну відповідь — що бот скаже, коли не зрозумів запитання. Порожньо — бот промовчить, і людина вирішить, що ви її ігноруєте.
Чати — вкладка, де ви відповідаєте вручну. Це працює одразу, без жодних сценаріїв: бот просто стає ще однією скринькою, у яку вам пишуть.

Чати з підписниками

Усі, хто написав боту, зʼявляються у вкладці «Чати». Там можна відповісти, поставити реакцію на повідомлення й відповісти цитатою на конкретну репліку. Якщо ботів кілька — перемикач угорі показує або всі чати разом, або чати одного бота.

Коли ви відповідаєте вручну, автоматичні ланцюжки на час замовкають — щоб робот не перебивав живу людину. Строк паузи налаштовується в загальних налаштуваннях бота.

Розсилки

Повідомлення можна надіслати всім підписникам або сегменту — наприклад, лише тим, хто залишив телефон. Кількість одержувачів видно до відправки. Розсилка йде фоном: вкладку можна закрити одразу.

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

Якщо бот не відповідає

У картці бота червоний статус і текст помилки — натисніть «Повторити»: найчастіше це тимчасовий збій мережі під час підключення.
Статус «Відключений» означає, що токен відкликали в @BotFather. Візьміть новий токен (/token) і підключіть бота заново.
Бот «Призупинений» — його зупинили ви або хтось із команди. Натисніть «Відновити».