Щоб створити Telegram-бота, відкрийте BotFather, надішліть /newbot, виберіть назву й ім’я користувача та скопіюйте токен у сервіс, який запускатиме бота. У цьому посібнику це Quickchat AI: він надає боту AI-агента, що відповідає з ваших знань, без написання коду чи запуску сервера.
Ви створите Fernway Languages, вигадану онлайн-школу англійської. Учень може відкрити її Telegram-бота, перевірити ціни курсів, натиснути /schedule, попросити PDF-путівник курсами й розмову з людиною. Уся взаємодія залишається в Telegram-чаті учня; ваша команда керує знаннями, Actions і розмовами в Quickchat AI.
Основне налаштування охоплює кроки від створення бота до перевірки відповідей. Потім додайте доставку PDF і передавання людині. Розділ про групові чати пояснює, як зберегти передбачувані відповіді у спільній розмові.
Завантажте комплект налаштування Fernway зі знаннями, Main Prompt, списком команд, тестовим аркушем, аватаром і прикладом PDF. Файли є редагованими прикладами для вставлення в панель керування, а не автоматичним імпортом агента.
Знімки екрана, назви елементів інтерфейсу й демонстраційні матеріали для копіювання залишено англійською, щоб ви могли відтворити показаний приклад.
Що потрібно, щоб створити Telegram-бота без програмування?
Вам потрібні обліковий запис Telegram, обліковий запис Quickchat AI і новий бот для вправи. BotFather створює ідентичність у Telegram; Quickchat AI запускає агента за нею.
- Увійдіть у Telegram на телефоні або комп’ютері. Скористайтеся офіційним BotFather за посиланням у кроці 1, а не обліковим записом зі схожою назвою.
- Створіть обліковий запис Quickchat AI і підтвердьте електронну пошту, якщо потрібно. План Free підтримує особисте некомерційне навчання в межах включеного ліміту. Для справжнього бізнес-впровадження використовуйте комерційний план. AI-відповіді та Simulation Testing витрачають кредити; перегляньте актуальні плани й ліміти.
- Залиште обидва застосунки відкритими. Використовуйте нового тестового бота, щоб вправа не змінила наявний канал підтримки. Другий обліковий запис Telegram допоможе перевірити досвід першого відвідування.
Telegram не стягує плату за реєстрацію бота. Сервіс, який генерує AI-відповіді, має власний ліміт використання. Для цього налаштування окремий API-ключ моделі не потрібен.
За що відповідає BotFather, а за що AI?
BotFather керує ідентичністю та налаштуваннями бота. Підключений агент вирішує, як відповісти, за своїми знаннями й інструкціями. Саме створення бота не дає йому інформації про курси або програми, що відповідає на повідомлення.
Telegram доставляє повідомлення учня підключеному сервісу. Відповідь агента повертається в той самий чат.
| Компонент | Що ви налаштовуєте | Що бачить учень |
|---|---|---|
| BotFather | Назву, ім’я користувача, фото профілю, опис, меню команд і режим приватності | Ідентичність бота та способи почати спілкування |
| Quickchat AI | Knowledge Base, Main Prompt, привітання та Actions | Відповіді про курси, запитаний PDF і передавання |
| Ваша команда | Точну інформацію про курси й контрольований Inbox | Відповідь людини, коли вона потрібна |
Крок 1: Як створити Telegram-бота в BotFather?
Надішліть /newbot офіційному BotFather, потім укажіть відображувану назву й унікальне ім’я користувача.
- Відкрийте @BotFather у Telegram і виберіть Start.
- Надішліть
/newbot. - Коли буде запитано назву, надішліть
Fernway Languages. Це відображувана назва, яку бачать учні. - Коли буде запитано ім’я користувача, виберіть, наприклад,
fernway_lessons_yourname_bot. Замінітьyournameунікальною частиною. Використовуйте від 5 до 32 латинських літер, цифр або підкреслень; регістр літер не враховується. Для цього стандартного безкоштовного налаштування використовуйте ім’я із закінченнямbot. Якщо воно зайняте, спробуйте іншу частину. Для відповідних облікових записів Premium BotFather пропонує й інші закінчення. - BotFather поверне посилання на бота й токен автентифікації. Збережіть посилання: воно відкриває чат для учнів. Тримайте токен у таємниці для кроку 4.
Для цього посібника достатньо інтерфейсу команд. BotFather також може пропонувати Mini App для керування ботами; якщо ваш екран відрізняється, використовуйте команди нижче.
Де знайти токен свого Telegram-бота?
Надішліть BotFather /mybots, виберіть бота й відкрийте API Token. Токен автентифікує запити від імені цього бота. Вставляйте його лише в спеціальне поле сервісу для даних доступу, а не в промпт агента, знання, чат підтримки чи знімок екрана.
Якщо токен розкрито, надішліть BotFather /revoke, виберіть бота й отримайте заміну. Оновіть токен у підключеному сервісі та перевірте відповідь. Старі дані доступу перестануть працювати; перейменування бота або видалення знімка їх не скасовує.
Webhook має одне призначення. Підключення того самого бота до іншого сервісу може замінити webhook, який доставляє вхідні повідомлення в Quickchat AI. Окремі сервіси можуть виконувати вихідні API-виклики з одним токеном, але не отримують автоматично кожен копію вхідних оновлень. Telegram також забороняє опитування через getUpdates, доки встановлено webhook. Для окремого вхідного процесу використовуйте окремого бота. Обидва механізми пояснює документація доставки оновлень Telegram.
Крок 2: Як додати зображення, опис і меню команд?
Використовуйте профільні команди BotFather, щоб бота можна було впізнати ще до першого повідомлення учня. Після кожної команди виберіть бота й надішліть указане нижче значення.
| Надішліть BotFather | Потім укажіть | Де відображається |
|---|---|---|
/setname | Fernway Languages | Відображувана назва в Telegram |
/setuserpic | Завантажте fernway-avatar.png із комплекту | Фото профілю |
/setdescription | Опис нижче | Вступ перед початком чату |
/setabouttext | Короткий текст профілю нижче | Профіль бота й попередній перегляд поширеного посилання |
/setcommands | Список команд нижче | Меню, яким учні користуються в розмові |
Description (до 512 символів):
Ask Fernway Languages about English courses, prices and weekly class times. Request the course guide or ask to speak to the team. This is a fictional school built for a tutorial.
About text (до 120 символів):
English courses, prices and class times. A fictional school for a Quickchat AI tutorial.
Список команд: вставте всі чотири рядки разом. У цьому списку BotFather назви команд не мають початкового слеша.
prices - Course prices
schedule - Weekly class times
trial - Request a free trial lesson
help - Talk to a person
Відкрийте профіль бота й перевірте назву, зображення та короткий текст. Відкрийте чат перед вибором Start, щоб перевірити вступ. Окремі налаштування Telegram описує в посібнику BotFather.
Після підключення бота в кроці 4 і вибору Start відкрийте меню команд і перевірте всі чотири пункти. Вставляючи список у BotFather, зберігайте розриви рядків; інакше кілька пунктів можуть перетворитися на один довгий опис команди.
Додавання /schedule до меню не реалізує пошук розкладу. Наступний крок пояснює агенту значення цього повідомлення.
Крок 3: Як навчити Telegram-бота відповідати з ваших знань?
Створіть агента, додайте факти про школу до Knowledge Base, потім помістіть правила відповідей у Main Prompt. Відокремлення фактів від інструкцій полегшує зміну ціни без зміни поведінки бота.
Після вибору знімки відкриваються в повному розмірі. Точний текст і значення запитів містяться в блоках для копіювання.
Додайте інформацію про курси
- Створіть у Quickchat AI нового агента з назвою
Fernway Languages. У Identity задайте таку саму назву. - Відкрийте Knowledge Base, виберіть Add Article і вкажіть
Fernway Languages course guideяк Title. - Вставте наступний текст у Content і виберіть Save. Дочекайтеся завершення обробки й статусу Ready. Перед тестуванням реального каналу виконайте будь-який показаний крок публікації або застосування змін.
Додайте факти в Knowledge Base. Повна стаття для копіювання нижче також містить правила пробних занять, повернення коштів і визначення рівня.
Скопіювати статтю знань Fernway
Fernway Languages is a fictional online English school used for this tutorial.
Courses
B1 English: EUR120 total for a four-week course. Classes are on Tuesdays and Thursdays, 18:00 to 19:00 UTC.
A2 English: EUR90 total for a four-week course. Classes are on Mondays and Wednesdays, 18:00 to 19:00 UTC.
Both courses meet online. Prices are for the complete four-week course, not per lesson.
Trial lessons
A free trial lesson lasts 20 minutes. Ask the student which course interests them and which day and time they prefer, including their time zone. A member of the Fernway team must confirm availability. The bot cannot book or confirm a trial lesson.
Refunds
Students can receive a full refund if they cancel at least 48 hours before their first class. The team reviews requests made later; no refund is promised for those requests.
Course brochure
The course guide contains the same course prices, weekly schedule, trial policy and refund policy. Send it only when the student asks for the brochure or course guide.
Placement
The team handles level placement. This knowledge base does not contain a placement-test score cutoff or rules that convert a test score into a course level. Do not invent a cutoff or interpret a student's score.
Відсутність порогового бала дає змістовний тест. Агент може назвати ціну B1 за джерелом, але не повинен вигадувати результат, потрібний учневі для зарахування.
Надайте командам значення
Відкрийте Identity, виберіть картку Main Prompt із позначкою Edit і вставте весь промпт нижче. Дочекайтеся автозбереження, потім відкрийте його знову й перевірте збережений текст.
Скопіювати весь Main Prompt
You are the Fernway Languages assistant. Help prospective students understand the English courses using the Knowledge Base.
Answer the student's question directly. Use plain text, short paragraphs and no Markdown tables. Keep routine answers under 100 words. State prices in EUR and class times in UTC unless the student explicitly asks for a conversion.
Treat /prices as a request for the course prices. Treat /schedule as a request for the weekly class times. Treat /trial as a request for a free trial lesson: explain that it lasts 20 minutes, ask for the preferred course, day, time and time zone, and make clear that the team must confirm availability. Treat /help as a request to speak to a person. These commands may include a bot username after an @ sign; apply the same rule to /prices@username, /schedule@username, /trial@username and /help@username.
Call send_course_brochure only when the student explicitly asks to receive the brochure or course guide. Do not call it for a price or schedule question alone. Do not ask for a chat ID, token or email address to send it. Say that the brochure was sent only after the action succeeds. If it fails, say that the file could not be sent and offer to explain the courses in the chat.
Use only the Knowledge Base for course facts and policies. If a requested fact is missing, say that the team will need to confirm it. Never invent placement-test cutoffs, available trial slots, bookings, refunds or course discounts.
If the student asks for a person, use Human Handoff. Do not promise an immediate response or pretend a staff member has already replied.
Цей промпт включає необов’язкові кроки надсилання брошури й передавання людині, які ви налаштуєте пізніше. Завершіть їх перед тим, як пропонувати бота як повноцінну підтримку учнів. Промпт може запросити Action; він не створює її та не підключає Telegram.
Адресовані форми на кшталт /schedule@your_bot важливі, коли бот приєднується до групи. Інструкція про звичайний текст теж важлива: стандартні відповіді через цю інтеграцію надсилаються без форматування Telegram Markdown.
Налаштуйте привітання
Відкрийте Your Website, виберіть вкладку Text Content і змініть Welcome message. Це спільне привітання використовує й підключення власного Telegram-бота:
Welcome to Fernway Languages. I can help with our English courses, prices and class times. Try /prices, /schedule or /trial, or ask a question. Use /help to ask for a person.
Спільне поле Welcome message розташоване в Your Website → Text Content; Telegram використовує його для /start.
Інтеграція власного бота надсилає налаштоване привітання, коли відвідувач надсилає /start. Воно окреме від опису BotFather перед чатом і від AI-відповіді на запитання про курс.
Крок 4: Як підключити токен до Quickchat AI?
Підключіться через Your own bot, щоб використати щойно створену ідентичність Telegram.
- Відкрийте External Apps, виберіть Telegram, потім Your own bot.
- Виберіть Connect to Telegram, вставте токен BotFather у Bot Token, потім натисніть Connect to Telegram у діалозі для надсилання.
- Увімкніть Enable your own bot, потім виберіть Save.
- Відкрийте посилання
t.meбота в Telegram. Виберіть Start або надішліть/start, щоб перевірити привітання.
Панель реального підключення показує ідентичність бота та ввімкнений стан. Для ідентичності з BotFather використовуйте Your own bot.
Спільний варіант Quickchat AI bot у панелі є іншим налаштуванням. Він надає посилання на чат конкретного агента без створення власного бота; основний посібник використовує вашу ідентичність і токен. Спільний варіант описує посібник з AI-чатбота для Telegram.
Якщо діалог підключення описує вимкнення приватності для груп, для адресованих команд цього посібника залиште її ввімкненою. Особисті чати працюють незалежно від налаштування приватності групи. Різницю пояснює розділ про групи.
Крок 5: Як протестувати Telegram-бота?
Перевіряйте і відповідь агента, і повідомлення, доставлене в Telegram. Тест у панелі перевіряє логіку відповіді; лише розмова в Telegram перевіряє весь канал.
Перевірте відповіді в Quickchat AI
Відкрийте Testing, виберіть Create Dataset, назвіть набір Fernway course answers і додайте ці повідомлення окремими рядками:
How much is the B1 English course?
/prices
/schedule
/schedule@fernway_demo_bot
/trial
I scored 62 on your placement test. Do I qualify for B1?
Рядок з адресованою командою використовує приклад імені користувача для перевірки правила промпту. У реальному тесті Telegram використовуйте справжнє ім’я свого бота.
У Evaluation criteria вкажіть:
Fernway Languages is a fictional English school. B1 costs EUR120 total for four weeks and meets Tuesdays and Thursdays, 18:00 to 19:00 UTC. A2 costs EUR90 total for four weeks and meets Mondays and Wednesdays, 18:00 to 19:00 UTC. A free trial lasts 20 minutes and requires team confirmation; no booking may be claimed. Commands must be treated as requests for the corresponding information. No placement-score cutoff is known, so the Agent must not decide a level from a score. Replies should be brief, plain text and based on these facts. Evaluate reply content only. This test cannot verify Telegram delivery, a received PDF or human assignment.
За наявності AI-кредитів виберіть Run. Кожен рядок починає окрему розмову. Подальші запитання перевіряйте в одній розмові AI Preview, що триває, а не вважайте наступний рядок набору наступною реплікою.
Справжні локальні результати Simulation. Відповідь про рівень отримала нижчу оцінку, бо оцінювач не бачив передавання; Inbox підтвердив реальну зміну відповідального.
Перевірте досвід учня в Telegram
Надішліть наступні повідомлення в особистий чат справжнього бота, очікуючи кожної відповіді. Знайдіть відповідні запитання й відповідь у Inbox.
Запитання про результат тесту рівня залиште наостанок, після кроків 6 і 7. Воно може передати розмову працівникам і призупинити автоматичні відповіді.
| Повідомлення або дія | Успішний результат |
|---|---|
/start | З’являється налаштоване привітання |
How much is the B1 English course? | EUR120 за весь чотиритижневий курс |
Натисніть /schedule у меню | Обидва тижневі розклади з чіткою позначкою UTC |
Натисніть /trial | Запит на пробне заняття тривалістю 20 хвилин; доступність підтверджує команда |
I scored 62 on your placement test. Do I qualify for B1? | Без вигаданого порога чи рішення про зарахування; потрібне підтвердження команди |
У реальному тесті агент не вивів рівень із бала. Після цього Inbox показував розмову як Unassigned за ввімкненого передавання Lack Of Knowledge. Перевіряйте відповідь і призначення окремо: оцінювач відповіді не може встановити, хто веде чат. Виконайте перевірку рівня після решти тестів розмови або виберіть AI Agent у меню призначення Inbox, перш ніж продовжувати автоматичні відповіді.
Якщо відповідь неправильна, перевірте потрібну статтю знань і збережений промпт, змініть щось одне й повторіть те саме повідомлення в новій розмові. За збою команди перевірте її точне правило; за неправильної ціни курсу перевірте пошук знань і публікацію. Записуйте реальну відповідь, а не визнавайте налаштування успішним лише через зелений стан підключення.
Набір із шести повідомлень є початковою точкою. Посібник із тестування AI-агента підтримки показує, як перед запуском доповнити його реалістичними помилковими сценаріями та критеріями оцінювання.
Крок 6: Як навчити бота надсилати PDF?
Додайте одну API Action, що надсилає фіксований путівник курсами в поточний Telegram-чат. Агент вирішує, чи попросив його учень; інтеграція надає дані доступу й одержувача.
Учень не надає токен або ID чату. Action не має параметрів, які заповнює модель.
Завантажте fernway-course-guide.pdf із комплекту й перегляньте приклад. Конфігурація використовує його публічний URL на цьому сайті. Для власного файла використовуйте прямий HTTPS URL, за яким Telegram без входу отримає PDF із правильним типом вмісту. Документи, отримувані за URL, мають бути менші за 20 MB. Telegram розрізняє отримання за URL і передавання файлів у документації надсилання файлів.
Відкрийте Actions & MCPs, виберіть Add Action, потім конструктор API Action і налаштуйте ці поля. Якщо конструктор пропонує згенеровану чернетку, перед активацією порівняйте справжній запит із наведеною конфігурацією.
API Action Name
send_course_brochure
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Без параметрів | Немає | Залиште розділ порожнім. Усі значення запиту беруться з підключення або фіксованої конфігурації. | Не застосовується |
API Endpoint: метод і URL
Виберіть POST і введіть:
https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument
Скористайтеся Add AI Data, щоб вставити telegram_bot_token із System Tokens. Це посилання на дані доступу підключеного бота, а не місце для вставлення самого токена.
Headers
| Ключ | Значення |
|---|---|
Content-Type | application/json |
Body: вставте у вкладку Body в API Endpoint.
{
"chat_id": "{{metadata_telegram_chat_id}}",
"document": "https://quickchat.ai/blog-assets/tutorials/create-telegram-bot/fernway-course-guide.pdf",
"caption": "Fernway Languages course guide (fictional tutorial example)"
}
Вставте telegram_chat_id із метаданих розмови через Add AI Data. Його шаблонна форма: {{metadata_telegram_chat_id}}. Канал Telegram задає значення з вхідного чату, тому PDF повертається в ту саму розмову. URL документа й підпис залиште фіксованими.
API Action Description
Send the Fernway Languages course guide PDF to the current Telegram chat when the student explicitly asks to receive the brochure or course guide. Do not call this action for a price, schedule or trial question alone. No information needs to be collected from the student: the current chat and bot credentials are supplied automatically. Call it once per explicit request. Confirm delivery only if the request succeeds.
Збережіть і активуйте Action. Повний Main Prompt уже містить правило явного запиту. Метод Bot API описано в sendDocument.
Перевірте файл, а не лише відповідь
- У Telegram надішліть
How much is the B1 English course?. Переконайтеся, що отримуєте ціну без незапитаного файла. - Надішліть
Can you send me the brochure?. - Підтвердьте, що надійшло PDF-вкладення й воно відкриває путівник курсами Fernway.
- У Inbox відкрийте цю розмову й розгорніть картку викликаної Action. На картці Action в Actions & MCPs відкрийте View logs і перевірте запит та результат. Перед поширенням знімка токен потрібно приховати.
- Підтвердьте, що одержувачем є поточний чат і за запитом надіслано один документ.
У реальному тесті send_course_brochure повернула HTTP 200 з відповіддю Telegram ok: true. Перший знімок показує отримане вкладення fernway-course-guide.pdf у чаті учня. Разом результат запиту й отриманий файл підтверджують доставку; самого текстового підтвердження агента недостатньо.
Проводьте тест доставки в Telegram. Розмови Simulation не мають контексту справжнього токена Telegram-бота. Використовуйте Simulation для перевірки відповідей, а реальний Telegram-чат для перевірки доставки файла.
Крок 7: Як передати Telegram-чат людині?
Увімкніть Human Handoff, щоб прохання про людину змінювало відповідального за розмову, потім попросіть колегу відповісти з Inbox.
- Відкрийте Actions & MCPs, увімкніть Human Handoff і виберіть Edit Action.
- Збережіть стандартні Handoff Rules: Media Message, User Frustration, Customer Support Suggestion і Lack Of Knowledge увімкнено, Irrelevant Advice вимкнено. Main Prompt уже пов’язує
/helpіз проханням про людину; у цьому прикладі окремого правила передавання не додається. - Для вправи під наглядом залиште Human Agents’ availability вимкненим і забезпечте присутність колеги біля Inbox під час тесту. Залиште Email notifications вимкненим. Ці налаштування використано в демонстрації; передавання без обмежень не означає постійну доступність людини.
- Перед запуском увімкніть розклад доступності й налаштуйте часовий пояс і години роботи за реальною присутністю працівників. Відповідно налаштуйте повідомлення поза робочими годинами.
- Збережіть Action. В особистому чаті бота надішліть
I want to talk to a person.Якщо бот попросить підтвердження, відповідайтеYes. - У Inbox перевірте, що AI більше не призначено. Виберіть Assign to me й надішліть
Hi, this is Alex from Fernway. Which course would you like help with?. Переконайтеся, що повідомлення надійшло в Telegram. - Надішліть ще одну репліку учня, поки розмову веде людина. Підтвердьте, що AI мовчить. Відкрийте меню призначення, виберіть AI Agent, потім надішліть нове запитання про курс і перевірте відновлення автоматичних відповідей.
Запит залишає реальний чат у стані Unassigned, щоб колега міг вибрати Assign to me. Попередня відповідь із брошурою також має згорнуту позначку виклику Action.
Учень залишається в Telegram. Успішне передавання потребує зміни відповідального й доставленої відповіді людини. Виберіть AI Agent у меню призначення, коли автоматизація має відновитися.
Після репліки оператора призначення повертається до AI Agent. Наступне запитання про рівень отримало AI-відповідь, показану в кроці 5.
Відсутній факт може спричинити передавання, як у локальному тесті рівня. Перевіряйте обидва результати окремо: відповідь не має містити здогадок, а заявлене передавання має змінювати відповідального в Inbox. Посібник Human Handoff докладніше пояснює доступність і маршрутизацію.
Докладний урок передавання чату від бота людині додає тести звернень поза робочими годинами й роботи автоматичних відповідей після повторного призначення.
Як бот поводиться в групі Telegram?
Режим приватності визначає, які групові повідомлення Telegram доставляє боту. Підключення власного бота в Quickchat AI обробляє отримані повідомлення; окремого фільтра «відповідати лише на згадки» воно не додає.
Схема охоплює типи повідомлень цього посібника. Telegram також документує службові повідомлення й маршрутизацію команд залежно від контексту.
Для навчальної групи, де бот має відповідати на прямі звернення:
- Надішліть BotFather
/setjoingroups, виберіть бота й увімкніть участь у групах, якщо вона вимкнена. - Надішліть
/setprivacy, виберіть бота й Enable. Залиште його звичайним учасником без прав адміністратора. Якщо ви змінили приватність після додавання, видаліть бота й додайте знову, щоб налаштування набуло чинності. - Додайте бота до невеликої тестової групи під вашим контролем.
- Надішліть звичайне повідомлення, наприклад
See everyone in class tomorrow.За цього налаштування воно не має викликати відповіді. - Надішліть
/schedule@your_bot, замінившиyour_botсправжнім ім’ям користувача. Перевірте відповідь із розкладом, потім застосуйте до неї жест Reply у Telegram і запитайтеWhat does B1 cost?.
Окрема команда /schedule може залежати від того, до якого бота зверталися останнім. Звичайна текстова згадка @mention не є надійною заміною адресованої команди у стандартному режимі приватності. Використовуйте явні форми з тесту вище. Див. правила приватності Telegram.
В окремому груповому тесті нижче використовувався спільний @QuickchatAI_bot, підключений до того самого агента Fernway. Він відповів на адресовану команду розкладу й запитання про ціну, надіслане відповіддю на повідомлення бота. Це показує спільний варіант; власного бота Fernway перевірено в особистому чаті, тож його поведінка в групі ще потребує наведених перевірок.
Вимкнення приватності або призначення бота адміністратором може доставляти агенту звичайну групову бесіду й викликати більше відповідей. Для модерації урок керування групами Telegram пояснює додаткові дозволи й керування Actions.
Група становить одну спільну розмову. Особисті запитання про конкретні курси варто ставити в особистому чаті бота. Якщо в групі спрацьовує Human Handoff, AI призупиняється для всієї групи до повторного призначення; окрема особиста бесіда з цим учнем не створюється.
Чому ваш Telegram-бот не відповідає?
Почніть із найпростішого тесту особистого чату, потім перевірте підключення й тип повідомлення. Робота в групі та доставка файлів додають окремі залежності.
| Симптом | Що перевірити |
|---|---|
| BotFather створив бота, але той мовчить | Завершіть підключення агента. BotFather не надає логіку відповідей. |
| Немає привітання | Відкрийте потрібного бота, надішліть /start, перевірте Enable your own bot і налаштоване Welcome message. |
| Перестав працювати після спроби іншого сервісу | Сервіс міг замінити webhook. Знову підключіть потрібний сервіс; для іншого процесу використовуйте окремого бота. |
| Перестав працювати після зміни токена | Оновіть Bot Token новим токеном і збережіть підключення. |
| Відповідає особисто, але не в групі | Перевірте участь у групі, приватність і справжнє ім’я користувача. Спробуйте /schedule@your_bot або відповідь на повідомлення бота. |
| Відповідає на кожне групове повідомлення | Перевірте, чи не вимкнено приватність і чи не є бот адміністратором. Поверніться до описаного вище тихішого налаштування. |
| Команда є в меню, але відповідь не за темою | Перевірте правило Main Prompt, зокрема адресовану форму. Реєстрація меню сама по собі не визначає поведінку. |
| Каже, що надіслав PDF, але вкладення немає | Перегляньте справжній виклик Action, прямий URL PDF і відповідь Telegram. Тестуйте в Telegram з увімкненим підключенням власного бота. |
| Відповідає до передавання, потім зупиняється | Перевірте призначення в Inbox. Розмова з призначеною людиною або без відповідального чекає працівників чи повторного призначення. |
| Агент не може відповісти або тести перестають запускатися | Перевірте доступні кредити, обробку знань і чи ввімкнено агента. |
| Telegram повертає помилку обмеження частоти | Зменште частоту повідомлень і дотримуйтеся інтервалу повторної спроби, указаного Telegram. |
Перед поширенням бота повторіть в особистому чаті перевірки ціни, невідомого факту, PDF і відповіді людини з власним вмістом. Замініть усі дані й посилання Fernway своїми. Актуальні інструкції інтеграції містяться в документації каналу Telegram.
Чи можуть ChatGPT або Claude допомогти створити цього бота?
AI-клієнт, підключений до вашого облікового запису Quickchat AI, може підготувати агента, знання, інструкції, Actions і тестовий набір. Ви все одно створюєте ідентичність Telegram у BotFather і вводите її токен у панелі підключення власного бота.
Підключіться через перевірену сторінку ChatGPT або сторінку Claude, дотримуючись інструкцій Manage with AI. Передайте асистенту комплект налаштування й цей запит:
Create a separate learning Agent named Fernway Languages from this tutorial kit. Do not change existing Agents. Set its display name and Identity name, add the knowledge article, and copy the Main Prompt and welcome message exactly. Configure send_course_brochure from action.json but leave it inactive. Use only the System Token reference, never ask me to paste my real Telegram token into chat. Create the Fernway course-answer dataset and evaluation criteria. Prepare Human Handoff using the default rules and show me the availability settings to review. Read back the saved configuration. Do not run tests, spend credits, send Telegram messages or activate Actions yet. List the remaining owner steps: create and configure the bot in BotFather, enter its token under Your own bot, review working hours, activate the Action and complete the real-channel checks. Do not use the shared Telegram connection as a substitute for my own bot.
Використане тут підключення для керування обліковим записом окреме від надання агента як інструмента MCP. Воно допомагає налаштувати процес, але не скасовує потреби перевірити справжню відповідь і вкладення в Telegram.
Поширені запитання
Як створити Telegram-бота без програмування?
Відкрийте офіційного BotFather у Telegram, надішліть /newbot і виберіть відображувану назву й унікальне ім’я користувача із закінченням bot. Підключіть отриманий токен до сервісу ботів, наприклад Quickchat AI. Додайте знання й інструкції, увімкніть підключення та перевірте особисте повідомлення. BotFather створює ідентичність; підключений сервіс надає відповіді.
Чи безкоштовне створення Telegram-бота?
Реєстрація Telegram-бота через BotFather безкоштовна. Quickchat AI має план Free для особистого некомерційного навчання з обмеженим запасом AI-кредитів. Для бізнесу потрібен комерційний план. AI-відповіді та Simulation Testing витрачають кредити; створення ідентичності Telegram не включає необмежене використання AI.
Де знайти токен мого Telegram-бота?
Відкрийте офіційного BotFather, надішліть /mybots, виберіть бота й API Token. Вставте ці дані доступу в спеціальне поле Bot Token сервісу ботів. Не розміщуйте їх у промпті, статті знань, публічному репозиторії чи знімку екрана.
Що робити, якщо токен Telegram-бота витік?
Використайте /revoke в BotFather, щоб відкликати розкритий токен, отримайте заміну, потім оновіть підключений сервіс і перевірте відповідь. Видаліть також розкриту копію, але не покладайтеся лише на видалення: кожен, хто зберіг старий токен, міг користуватися ним до відкликання.
Чи можна підключити одного Telegram-бота до двох платформ?
Бот має одну адресу webhook для вхідних оновлень. Якщо друга платформа замінить цей webhook, перша перестане їх отримувати. Кілька систем і далі можуть виконувати вихідні API-виклики, але вхідні повідомлення не копіюються автоматично обом. Для незалежних вхідних процесів використовуйте окремих ботів.
Як додати команди до Telegram-бота?
Надішліть BotFather /setcommands, виберіть бота й укажіть по одній парі команда-опис у рядку, без початкового слеша. Це створює меню. Потрібно також реалізувати поведінку: у цьому посібнику Main Prompt пов’язує /prices, /schedule, /trial і /help із відповідними відповідями або Action.
Чому Telegram-бот відповідає особисто, але не в групі?
Перевірте, що бот є учасником групи, і спробуйте команду з його справжнім ім’ям користувача, наприклад /schedule@your_bot, або відповідайте на його повідомлення. За ввімкненої приватності звичайна групова розмова не доставляється боту без прав адміністратора. Звичайна текстова згадка не є надійною заміною адресованої команди.
Чи можна додати AI або ChatGPT до Telegram-бота?
Можна підключити бота BotFather до AI-сервісу. Цей посібник використовує агента Quickchat AI із власними знаннями, Main Prompt і Actions; він не поєднує вашу особисту розмову ChatGPT з Telegram. Сумісний асистент керування обліковим записом може допомогти підготувати агента, а власник завершує підключення власного бота.
Чи може цей Telegram-бот відповідати на голосові повідомлення?
Інтеграція Quickchat AI з Telegram зараз не транскрибує голосові нотатки для агента. Голосове вкладення може з’явитися в Inbox, але посібник спирається на текстові повідомлення. Попросіть учня написати запитання або людину перевірити вкладення.
Чи автоматизує це мій особистий обліковий запис Telegram?
Ні. Цей посібник створює окрему ідентичність бота з власним ім’ям користувача. Telegram пропонує інші функції автоматизації облікових записів, але описане підключення Quickchat AI обробляє повідомлення, надіслані боту; воно не налаштовує відповіді з вашого особистого профілю.












