Как да създадете Telegram бот с BotFather и да добавите AI

Piotr Grudzień
Публикувано 18 мин четене
Създаване на Telegram бот с BotFather и Quickchat AI до реален разговор на Fernway с отговори за курсове, PDF прикачен файл и човешки отговор

За да създадете Telegram бот, отворете BotFather, изпратете /newbot, изберете име и потребителско име и копирайте токена в услугата, която ще управлява бота. В този урок това е Quickchat AI: услугата предоставя AI Agent, който отговаря от вашите знания, без писане на код или поддържане на сървър.

Ще създадете Fernway Languages, измислена онлайн школа по английски. Курсистът може да отвори нейния Telegram бот, да провери цените, да натисне /schedule, да поиска PDF ръководство за курсовете и разговор с човек. Цялото взаимодействие остава в Telegram чата на курсиста; екипът ви управлява знанията, Actions и разговорите в Quickchat AI.

Fernway Languages в Telegram отговаря за цените и графика на курсовете и след това доставя поисканото PDF ръководство

Готовият бот в Telegram. Отговорите за курсовете идват от знанията му, а брошурата пристига като истински PDF прикачен файл.

Основната настройка започва със създаването на бота и завършва с тестването на отговорите. След това добавете доставка на PDF и предаване на човек. Разделът за групов чат обяснява как отговорите да останат предвидими в споделен разговор.

Изтеглете пакета за настройка на Fernway със знанията, Main Prompt, списъка с команди, тестовия лист, аватара и примерния PDF. Файловете са редактируеми примери за поставяне в таблото, а не автоматичен импорт на Agent.

Снимките на екрана, имената на елементите в интерфейса и примерните материали за копиране остават на английски, за да можете да възпроизведете показания пример.

Какво ви трябва, за да създадете Telegram бот без код?

Трябват ви Telegram акаунт, Quickchat AI акаунт и нов бот за упражнението. BotFather създава Telegram идентичността; Quickchat AI изпълнява Agent-а зад нея.

  1. Влезте в Telegram на телефон или компютър. Използвайте официалния BotFather от връзката в стъпка 1, а не акаунт с подобно име.
  2. Създайте Quickchat AI акаунт и потвърдете имейла, ако бъде поискано. Планът Free позволява лично, нетърговско обучение в рамките на включения лимит. За реално бизнес внедряване използвайте търговски план. AI отговорите и Simulation Testing изразходват кредити; вижте актуалните планове и лимити.
  3. Оставете двете приложения отворени. Използвайте нов тестов бот, за да не променя упражнението съществуващ канал за поддръжка. Втори Telegram акаунт е полезен за проверка на първото посещение.

Telegram не таксува регистрирането на бот. Услугата, която генерира AI отговорите му, има собствен лимит за използване. За тази настройка не ви трябва отделен API ключ за модел.

Какво прави BotFather и какво прави AI?

BotFather управлява идентичността и настройките на бота. Свързаният Agent решава как да отговори чрез знанията и инструкциите си. Самото създаване на бота не му дава информация за курсовете или програма, която отговаря на съобщения.

Диаграма, разделяща настройките за идентичност в BotFather от съобщенията в Telegram и отговорите на Quickchat AI Telegram доставя съобщението на курсиста до свързаната услуга. Отговорът на Agent-а се връща в същия чат.

ЧастКакво настройватеКакво вижда курсистът
BotFatherИме, потребителско име, профилна снимка, описание, меню с команди и режим на поверителностИдентичността на бота и начините за започване на контакт
Quickchat AIKnowledge Base, Main Prompt, приветствие и ActionsОтговори за курсовете, поискания PDF и предаване
Вашият екипТочни данни за курсовете и наблюдаван InboxЧовешки отговор, когато разговорът го изисква

Стъпка 1: Как създавате Telegram бот в BotFather?

Изпратете /newbot на официалния BotFather, след това посочете показвано име и уникално потребителско име.

  1. Отворете @BotFather в Telegram и изберете Start.
  2. Изпратете /newbot.
  3. Когато бъде поискано име, изпратете Fernway Languages. Това е показваното име, което курсистите виждат.
  4. Когато бъде поискано потребителско име, изберете например fernway_lessons_yourname_bot. Заменете yourname с уникална част. Използвайте от 5 до 32 латински букви, цифри или долни черти; регистърът на буквите няма значение. За тази стандартна безплатна настройка използвайте име, завършващо на bot. Ако е заето, опитайте друга част. За отговарящи на условията Premium акаунти BotFather предлага и други окончания.
  5. BotFather връща връзката към бота и токена му за удостоверяване. Запазете връзката; чрез нея ще отворите чата за курсистите. Пазете токена в тайна за стъпка 4.

Интерфейсът с команди е достатъчен за този урок. BotFather може да предлага и Mini App за управление на ботове; ако екранът ви се различава, използвайте командите по-долу.

Разговор с потвърдения BotFather с командата newbot, името Fernway Languages и потвърждение за създаване, със скрити потребителско име и токен

BotFather създава идентичността и връща връзката и данните за достъп. Тестовото потребителско име и целият токен са скрити.

Къде намирате токена на Telegram бота си?

Изпратете /mybots на BotFather, изберете бота и отворете API Token. Токенът удостоверява заявките от името на този бот. Поставяйте го само в специалното поле за данни за достъп на услугата, не в prompt-а на Agent-а, знанията, чат с поддръжката или снимка на екрана.

Ако токенът бъде разкрит, изпратете /revoke на BotFather, изберете бота и получете заместващ токен. Обновете свързаната услуга и тествайте отговор. Старият токен спира да работи; смяна на името на бота или изтриване на снимката не го обезсилва.

Webhook има една крайна точка. Свързването на същия бот с друга услуга може да замени webhook, който доставя входящите съобщения до Quickchat AI. Отделни услуги могат да правят изходящи API заявки със същия токен, но не получават автоматично всяка копие от входящите актуализации. Telegram не позволява и периодично извличане чрез getUpdates, докато е настроен webhook. За отделен входящ процес използвайте отделен бот. Документацията на Telegram за доставяне на актуализации обяснява двата механизма.

Стъпка 2: Как добавяте снимка, описание и меню с команди?

Използвайте профилните команди на BotFather, за да е разпознаваем ботът още преди първото съобщение на курсиста. След всяка команда изберете бота и изпратете посочената стойност.

Изпратете на BotFatherПосле посочетеКъде се показва
/setnameFernway 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; иначе няколко позиции могат да се превърнат в едно дълго описание на команда.

Менюто на Fernway Languages в Telegram с prices, schedule, trial и help под настроеното приветствие

Готовото меню има четири отделни позиции. Приветствието над него се настройва в Quickchat AI в стъпка 3.

Диаграма на команда: BotFather добавя позиция в менюто, Telegram изпраща текста, а Main Prompt определя значението му Добавянето на /schedule в менюто не реализира извличане на график. Следващата стъпка казва на Agent-а какво означава съобщението.

Стъпка 3: Как карате Telegram бота да отговаря от вашите знания?

Създайте Agent, добавете фактите за школата в Knowledge Base, после поставете правилата за отговор в Main Prompt. Разделянето на факти и инструкции улеснява промяната на цена, без да променяте поведението на бота.

При избор снимките се отварят в пълен размер. Точният текст и стойностите на заявките са в блоковете за копиране.

Добавете информацията за курсовете

  1. В Quickchat AI създайте нов Agent с име Fernway Languages. В Identity задайте същото име.
  2. Отворете Knowledge Base, изберете Add Article и въведете Fernway Languages course guide като Title.
  3. Поставете следния текст в Content, после изберете Save. Изчакайте обработката да приключи и статията да стане Ready. Преди тест на реалния канал изпълнете всяка показана стъпка за публикуване или прилагане.

Редакторът на статията със знания Fernway с нейното заглавие, цени на курсовете и седмичен график Добавете фактите в 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.

Липсващият праг за определяне на ниво ви дава смислен тест. Agent-ът може да отговори за цената на B1 от източник, но не трябва да измисля резултата, необходим за записване.

Задайте значението на командите

Отворете Identity, изберете картата Main Prompt, обозначена с Edit, и поставете целия prompt по-долу. Изчакайте автоматичното запазване, после го отворете отново и проверете записания текст.

Страницата Identity на Fernway Languages с Name и редактируемата карта Main Prompt Отворете Main Prompt от Identity. Правилата му определят значението на Telegram командите.

Копирайте целия 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.

Този prompt включва незадължителните стъпки за брошура и предаване, които ще настроите по-късно. Завършете ги, преди да споделите бота като пълна услуга за обслужване на курсисти. Prompt може да поиска 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 с приветствието на Fernway и предложения за команди Общото поле Welcome message е под Your Website → Text Content; Telegram го използва за /start.

Интеграцията със собствен бот изпраща това настроено приветствие, когато посетител изпрати /start. То е отделно от описанието на BotFather преди чата и от AI отговор на въпрос за курс.

Стъпка 4: Как свързвате токена с Quickchat AI?

Свържете се през Your own bot, за да използвате току-що създадената Telegram идентичност.

  1. Отворете External Apps, изберете Telegram, после Your own bot.
  2. Изберете Connect to Telegram, поставете токена от BotFather в Bot Token, после изберете Connect to Telegram в диалога, за да го изпратите.
  3. Включете Enable your own bot, после изберете Save.
  4. Отворете връзката t.me на бота в Telegram. Изберете Start или изпратете /start, за да проверите приветствието.

Настройките за Telegram в Quickchat AI със свързания Fernway бот под Your own bot и включено Enable your own bot Панелът на реалната връзка показва идентичността на бота и включеното му състояние. За идентичността, създадена в BotFather, използвайте Your own bot.

Диалогът Connect to Telegram в Quickchat AI с празно поле Bot Token Въведете данните за достъп в това поле. Снимката умишлено не съдържа токен.

Споделената опция Quickchat AI bot в таблото е различна настройка. Тя предоставя връзка към чат за конкретния Agent без създаване на собствен бот; основният урок използва ваша идентичност и токен. Споделеният вариант е описан в ръководството за Telegram AI чатбот.

Ако диалогът за свързване описва изключване на поверителността за групи, оставете я включена за адресираните команди в този урок. Личните чатове работят независимо от груповата настройка за поверителност. Разликата е обяснена в раздела за групи.

Стъпка 5: Как тествате своя Telegram бот?

Проверете и отговора на Agent-а, и съобщението, доставено в 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?

Редът с адресирана команда използва примерно потребителско име, за да провери правилото в prompt-а. За реалния 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, вместо да третирате следващия ред от набора като следваща реплика.

Шест завършени теста Fernway Simulation с отговори за цени и команди и резултата на въпроса за ниво Реални локални резултати от 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?Без измислен праг или решение за прием; екипът трябва да потвърди

Fernway Languages в Telegram отказва да определи прием в B1 от резултат 62 на тест за ниво

Реалният отговор оставя решението за нивото на екипа. По-ранната брошура и човешкият отговор остават видими в същия разговор.

Inbox на Quickchat AI със същия Telegram въпрос за ниво, отговора на Agent-а и разговор Unassigned Съответният изглед на Inbox показва както отговора, така и състоянието Unassigned на разговора.

В реалния тест Agent-ът не изведе ниво от резултата. След това Inbox показа разговора като Unassigned, при включено предаване Lack Of Knowledge. Проверявайте отговора и отговорника поотделно; оценителят на отговор не може да установи кой води чата. Изпълнете тази проверка след другите разговорни тестове или изберете AI Agent в менюто за отговорник в Inbox, преди да продължите автоматичните отговори.

Ако отговорът е грешен, прегледайте съответната статия със знания и записания prompt, променете едно нещо и повторете същото съобщение в нов разговор. При неработеща команда проверете точното ѝ правило; при грешна цена проверете извличането на знания и публикуването. Записвайте действителния отговор, вместо да приемате настройката за успешна само защото връзката е зелена.

Наборът от шест съобщения е начална точка. Ръководството за тестване на AI Agent за поддръжка показва как преди старта да го разширите с реалистични случаи на грешки и критерии за оценяване.

Стъпка 6: Как карате бота да изпраща PDF?

Добавете една API Action, която изпраща фиксирано ръководство за курсовете в текущия Telegram чат. Agent-ът решава дали курсистът го е поискал; интеграцията предоставя данните за достъп и получателя.

Диаграма на трите фиксирани източника за документната Action: System Token, метаданните на канала за текущия чат и публичен PDF URL Курсистът не предоставя токен или ID на чат. Action няма параметри, попълвани от модела.

Изтеглете fernway-course-guide.pdf от пакета, за да разгледате примера. Настройката използва публичния му URL на този сайт. За собствен файл използвайте директен HTTPS URL, от който Telegram може да получи PDF без вход и с правилния тип съдържание. Документите, извличани по URL, трябва да са под 20 MB. Telegram разграничава извличането по URL от качването на файлове в документацията за изпращане на файлове.

Отворете Actions & MCPs, изберете Add Action, после редактора за API Action и настройте тези полета. Ако редакторът предложи генериран проект, преди активиране сравнете действителната заявка с дадената конфигурация.

Редакторът на API Action с POST sendDocument, препратка към Telegram System Token и метаданните на текущия чат в JSON тялото Елементът за токена е в URL; елементът за метаданните на чата е в Body. URL на PDF е фиксиран.

API Action Name

send_course_brochure

What to ask the user first

FormatNameDescriptionRequired
Без параметриНямаОставете раздела празен. Всички стойности на заявката идват от връзката или фиксираната конфигурация.Неприложимо

API Endpoint: метод и URL

Изберете POST и въведете:

https://api.telegram.org/bot{{telegram_bot_token}}/sendDocument

Използвайте Add AI Data, за да вмъкнете telegram_bot_token от System Tokens. Това е препратка към данните за достъп на свързания бот, а не място за поставяне на самия токен.

Headers

КлючСтойност
Content-Typeapplication/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.

Проверете файла, не само отговора

  1. В Telegram изпратете How much is the B1 English course?. Проверете дали получавате цената без непоискан файл.
  2. Изпратете Can you send me the brochure?.
  3. Потвърдете, че пристига PDF прикачен файл и отваря ръководството за курсовете Fernway.
  4. В Inbox отворете разговора и разгънете картата на извиканата Action. На картата на Action в Actions & MCPs отворете View logs, за да проверите заявката и резултата. Преди споделяне на снимка токенът трябва да е скрит.
  5. Потвърдете, че получателят е текущият чат и за заявката е изпратен един документ.

В реалния тест send_course_brochure върна HTTP 200 с отговор от Telegram ok: true. Началната снимка показва получения fernway-course-guide.pdf в чата на курсиста. Резултатът от заявката и полученият файл заедно доказват доставката; само потвърждението на Agent-а не е достатъчно.

Изпълнете теста за доставка в Telegram. Разговорите в Simulation нямат контекста на действителния токен на Telegram бота. Използвайте Simulation за проверка на отговори и реалния Telegram чат за проверка на доставката на файла.

Стъпка 7: Как предавате Telegram чат на човек?

Включете Human Handoff, така че искане за човек да променя отговорника за разговора, после нека колега отговори от Inbox.

  1. Отворете Actions & MCPs, включете Human Handoff и изберете Edit Action.
  2. Запазете стандартните Handoff Rules с включени Media Message, User Frustration, Customer Support Suggestion и Lack Of Knowledge и изключено Irrelevant Advice. Main Prompt вече свързва /help с искане за човек; този пример не добавя собствено правило за предаване.
  3. За упражнението под наблюдение оставете Human Agents’ availability изключено и осигурете колега в Inbox по време на теста. Оставете Email notifications изключено. Тези настройки са използвани в примера; неограниченото предаване не означава, че човек винаги е на разположение.
  4. Преди старта включете графика за наличност и задайте часовата зона и работните часове според действителното присъствие на екипа. Настройте съответно съобщението извън работно време.
  5. Запазете Action. В личния чат на бота изпратете I want to talk to a person. Ако ботът поиска потвърждение, отговорете Yes.
  6. В Inbox проверете, че AI вече не е назначен. Изберете Assign to me и изпратете Hi, this is Alex from Fernway. Which course would you like help with?. Проверете дали съобщението пристига в Telegram.
  7. Изпратете още едно съобщение от курсиста, докато човекът води чата. Потвърдете, че AI не отговаря. Отворете менюто за отговорник и изберете AI Agent, после изпратете нов въпрос за курс, за да проверите възстановяването на автоматичните отговори.

Реален Telegram разговор в Inbox на Quickchat AI с искане за човек, статус Unassigned и бутон Assign to me Искането оставя реалния чат Unassigned, готов колега да избере Assign to me. По-ранният отговор с брошурата също има свит маркер за извикване на Action.

Цикъл на предаване на човек от AI отговори за курсове през спряна автоматизация, отговор на служител от Inbox и повторно назначаване Курсистът остава в Telegram. Успешното предаване изисква промяна на отговорника и доставен човешки отговор. Изберете AI Agent в менюто за отговорник, когато автоматизацията трябва да продължи.

Разговор Fernway в Telegram с искане за човек, потвърждение за предаване, отговор на оператора Alex и последващо съобщение на курсиста

Отговорът на оператора от Inbox пристига в същия Telegram чат. Курсистът може да продължи без смяна на приложения.

Inbox на Quickchat AI с отговора на оператора, последващото съобщение на курсиста и разговора, назначен отново на AI Agent След репликата на оператора отговорникът отново е AI Agent. Следващият въпрос за ниво получи AI отговора, показан в стъпка 5.

Липсващ факт може да доведе до предаване, както при локалния тест за ниво. Проверете двата резултата отделно: отговорът не трябва да гадае, а всяко заявено предаване трябва да променя отговорника в Inbox. Ръководството Human Handoff обяснява по-подробно наличността и насочването.

Подробният урок за предаване от чатбот на човек добавя тестове за заявки извън работно време и за продължаването на автоматичните отговори след повторно назначаване.

Как се държи ботът в Telegram група?

Режимът на поверителност определя кои групови съобщения Telegram доставя на бота. Връзката със собствен бот в Quickchat AI обработва получените съобщения; не добавя отделен филтър „отговаряй само на споменавания“.

Диаграма за групова доставка: адресираните команди и отговорите достигат бота при включена поверителност; обикновеният чат достига при изключена поверителност или бот администратор Диаграмата обхваща типовете съобщения в този урок. Telegram документира и служебните съобщения и зависимото от контекста насочване на команди.

За учебна група, в която ботът трябва да отговаря на директни заявки:

  1. Изпратете /setjoingroups на BotFather, изберете бота и разрешете членство в групи, ако е изключено.
  2. Изпратете /setprivacy, изберете бота и Enable. Оставете го обикновен член без администраторски права. Ако промените поверителността след добавянето, премахнете и добавете бота отново, за да влезе настройката в сила.
  3. Добавете бота в малка тестова група, която контролирате.
  4. Изпратете обикновено съобщение, например See everyone in class tomorrow. То не трябва да предизвика отговор при тази настройка.
  5. Изпратете /schedule@your_bot, като замените your_bot с реалното потребителско име. Проверете отговора за графика, после използвайте жеста Reply върху него в Telegram, за да попитате What does B1 cost?.

Самостоятелно /schedule може да зависи от последно адресирания бот. Обикновено текстово @mention не е надежден заместител на адресирана команда при стандартен режим на поверителност. Използвайте изричните форми от теста по-горе. Вижте правилата за поверителност на Telegram.

BotFather с включени членство в групи и поверителност за Fernway бота

Запазената настройка в BotFather е Enable. Изпълнете проверките за групови съобщения със собствения си бот, за да потвърдите доставката в тази група.

Отделният групов тест по-долу използва споделения @QuickchatAI_bot, свързан със същия Fernway Agent. Той отговори на адресирана команда за график и на въпрос за цена, изпратен като отговор на бота. Това показва споделената алтернатива; нашият собствен Fernway бот е проверен в личен чат, затова груповото му поведение все още изисква горните проверки.

Fernway Study Group със споделения Quickchat AI бот, който отговаря на адресирана команда за график и на отговор с въпрос за цената на B1

Тази група използва споделения @QuickchatAI_bot. Собственият Fernway бот е идентичността на снимките на личния чат.

Изключването на поверителността или назначаването на бота за администратор може да изпраща обикновената групова дискусия към Agent-а и да предизвиква повече отговори. За модериране урокът за управление на Telegram групи обяснява допълнителните права и контролите на Actions.

Групата е един споделен разговор. Личните въпроси за конкретен курс принадлежат в личния чат на бота. Ако Human Handoff се задейства в групата, AI спира за цялата група до повторно назначаване; не се създава отделен личен разговор с този курсист.

Защо Telegram ботът ви не отговаря?

Започнете с най-простия тест в личен чат, после проверете връзката и типа съобщение. Поведението в групи и доставката на файлове добавят отделни зависимости.

СимптомКакво да проверите
BotFather създаде бота, но той мълчиДовършете свързването на Agent-а. BotFather не предоставя логика за отговаряне.
Няма приветствиеОтворете правилния бот, изпратете /start, проверете Enable your own bot и настроеното Welcome message.
Спря след проба с друга услуга за ботовеУслугата може да е заменила webhook. Свържете отново желаната услуга; за друг процес използвайте отделен бот.
Спря след смяна на токенаОбновете Bot Token със заместващия токен и запазете връзката.
Отговаря лично, но не в групаПроверете членството, поверителността и реалното потребителско име. Опитайте /schedule@your_bot или отговор на негово съобщение.
Отговаря на всяко групово съобщениеПроверете дали поверителността е изключена или ботът е администратор. Върнете се към описаната по-горе по-тиха конфигурация.
Команда е в менюто, но получава неуместен отговорПроверете правилото в Main Prompt, включително адресираната форма. Самото регистриране на меню не определя поведение.
Казва, че е изпратил PDF, но няма прикачен файлПроверете реалното извикване на Action, директния PDF URL и отговора на Telegram. Тествайте през Telegram с включена връзка със собствен бот.
Отговаря до предаването, после спираПроверете отговорника в Inbox. Разговор с човек или без отговорник чака екип или повторно назначаване.
Agent-ът не може да отговори или тестовете спиратПроверете наличните кредити, обработката на знанията и дали Agent-ът е включен.
Telegram връща грешка за ограничение на честотатаНамалете честотата на съобщенията и спазете интервала за повторен опит, върнат от Telegram.

Преди да споделите бота, повторете проверките за цена, неизвестен факт, PDF и човешки отговор в личен чат със собственото си съдържание. Заменете всички подробности и връзки на Fernway с ваши. За актуалните настройки използвайте документацията на Telegram канала.

Могат ли ChatGPT или Claude да помогнат за създаването на този бот?

AI клиент, свързан с Quickchat AI акаунта ви, може да подготви Agent-а, знанията, инструкциите, 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.

Използваната тук връзка за управление на акаунт е отделна от предоставянето на Agent като 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 на услугата за ботове. Не ги поставяйте в prompt, статия със знания, публично хранилище или снимка на екрана.

Какво да направя, ако токенът на Telegram бота стане публичен?

Използвайте /revoke в BotFather, за да обезсилите разкрития токен, получете заместващ, после обновете свързаната услуга и тествайте отговор. Премахнете и разкритото копие, но не разчитайте само на изтриване: всеки, запазил стария токен, е можел да го използва до отмяната му.

Мога ли да свържа един Telegram бот с две платформи?

Ботът има една крайна точка на webhook за входящи актуализации. Ако втора платформа замени този webhook, първата спира да ги получава. Няколко системи могат да правят изходящи API заявки, но входящите съобщения не се копират автоматично до двете. За независими входящи процеси използвайте отделни ботове.

Как да добавя команди към своя Telegram бот?

Изпратете /setcommands на BotFather, изберете бота и подайте по една двойка команда-описание на ред, без начална наклонена черта. Това създава менюто. Трябва да реализирате и поведението: в този урок Main Prompt свързва /prices, /schedule, /trial и /help със съответните отговори или Action.

Защо Telegram ботът ми отговаря лично, но не в група?

Проверете дали ботът е в групата и опитайте команда, адресирана до реалното му потребителско име, например /schedule@your_bot, или отговорете на негово съобщение. При включена поверителност обикновеният групов разговор не се доставя на бот без администраторски права. Обикновено текстово споменаване не е надежден заместител на адресирана команда.

Мога ли да добавя AI или ChatGPT към Telegram бот?

Можете да свържете BotFather бот с AI услуга. Този урок използва Quickchat AI Agent със собствени знания, Main Prompt и Actions; той не свързва личния ви ChatGPT разговор с Telegram. Съвместим асистент за управление на акаунт може да помогне с подготовката на Agent-а, докато собственикът завършва връзката със собствен бот.

Може ли този Telegram бот да отговаря на гласови съобщения?

Интеграцията на Quickchat AI с Telegram понастоящем не транскрибира гласови бележки за Agent-а. Гласов прикачен файл може да се появи в Inbox, но този урок използва писмени съобщения. Помолете курсиста да напише въпроса или човек да прегледа прикачения файл.

Това автоматизира ли личния ми Telegram акаунт?

Не. Този урок създава отделна бот идентичност със собствено потребителско име. Telegram предлага други функции за автоматизация на акаунти, но описаната тук връзка на Quickchat AI обработва съобщенията до бота; тя не настройва отговори от личния ви профил.

Quickchat AI Quickchat AI Ask Quickchat AI a question