Как создать Telegram-бота через BotFather и добавить AI

Piotr Grudzień
Опубликовано Время чтения: 16 мин
Создание Telegram-бота через BotFather и Quickchat AI рядом с реальным диалогом Fernway с ответами о курсах, PDF-вложением и ответом человека

Чтобы создать Telegram-бота, откройте BotFather, отправьте /newbot, выберите название и имя пользователя и скопируйте токен в сервис, который будет запускать бота. В этом уроке используется Quickchat AI: он предоставляет боту AI-агента, отвечающего по вашим знаниям, без написания кода и запуска сервера.

Вы создадите Fernway Languages, вымышленную онлайн-школу английского языка. Ученик сможет открыть её Telegram-бота, проверить цены, нажать /schedule, запросить PDF с описанием курсов и попросить человека. Всё взаимодействие остаётся в Telegram-чате ученика; ваша команда управляет знаниями, Actions и разговорами в Quickchat AI.

Fernway Languages в Telegram отвечает на вопросы о ценах и расписании курсов, затем доставляет запрошенный PDF

Готовый бот в Telegram. Ответы о курсах основаны на его знаниях, а брошюра приходит настоящим PDF-вложением.

Основная настройка охватывает шаги от создания бота до проверки ответов. Затем добавьте отправку PDF и передачу человеку. Раздел о групповых чатах объясняет, как сохранить предсказуемое поведение в общем разговоре.

Скачайте комплект настройки Fernway со знаниями, Main Prompt, списком команд, листом тестов, аватаром и примером PDF. Это редактируемые примеры для вставки в панель управления, а не автоматический импорт агента.

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

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

Вам нужны аккаунт Telegram, аккаунт Quickchat AI и новый бот для упражнения. BotFather создаёт идентичность в Telegram; Quickchat AI запускает стоящего за ней агента.

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

Telegram не берёт плату за регистрацию бота. У сервиса, генерирующего AI-ответы, есть собственный лимит использования. Для этой настройки отдельный API-ключ модели не нужен.

За что отвечает BotFather, а за что AI?

BotFather управляет идентичностью и настройками бота. Подключённый агент выбирает ответ по своим знаниям и инструкциям. Само создание бота не даёт ему сведений о курсах или программы, отвечающей на сообщения.

Схема, отделяющая настройки идентичности BotFather от сообщений Telegram и ответов Quickchat AI Telegram доставляет сообщение ученика подключённому сервису. Ответ агента возвращается в тот же чат.

КомпонентЧто вы настраиваетеЧто видит ученик
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-бота?

Отправьте BotFather /mybots, выберите бота и откройте API Token. Токен аутентифицирует запросы от имени этого бота. Вставляйте его только в специальное поле сервиса для данных доступа, а не в промпт агента, знания, чат поддержки или скриншот.

Если токен раскрыт, отправьте BotFather /revoke, выберите бота и получите замену. Обновите токен в подключённом сервисе и проверьте ответ. Старые данные доступа перестанут работать; переименование бота или удаление скриншота их не аннулирует.

У 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 в меню не реализует поиск расписания. Следующий шаг объясняет агенту смысл этого сообщения.

Шаг 3: Как научить Telegram-бота отвечать по вашим знаниям?

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

При выборе скриншоты открываются в полном размере. Точный текст и значения запросов находятся в копируемых блоках.

Добавьте информацию о курсах

  1. Создайте в Quickchat AI нового агента с названием 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.

Отсутствие порогового балла даёт содержательный тест. Агент может назвать цену B1 по источнику, но не должен выдумывать результат, нужный ученику для зачисления.

Задайте смысл команд

Откройте Identity, выберите карточку Main Prompt с пометкой Edit и вставьте полный промпт ниже. Дождитесь автосохранения, затем откройте его снова и проверьте сохранённый текст.

Страница 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.

Промпт включает необязательные шаги отправки брошюры и передачи человеку, которые вы настроите позже. Завершите их перед тем, как предложить бота как полноценную поддержку учеников. Промпт может запросить 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 в панели представляет другую настройку. Он даёт ссылку на чат конкретного агента без создания собственного бота; основной урок использует вашу идентичность и токен. Общий вариант описывает руководство по 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, а не считайте следующую строку набора следующей репликой.

Шесть завершённых тестов 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, ответом агента и разговором Unassigned Соответствующий вид Inbox показывает и ответ, и состояние разговора Unassigned.

В реальном тесте агент не вывел уровень из балла. После этого Inbox показывал разговор как Unassigned при включённой передаче Lack Of Knowledge. Проверяйте ответ и назначение отдельно: оценщик ответа не может установить, кто ведёт чат. Выполните проверку уровня после остальных тестов разговора либо выберите AI Agent в меню назначения Inbox, прежде чем продолжать автоматические ответы.

Если ответ неверен, проверьте нужную статью знаний и сохранённый промпт, измените что-то одно и повторите то же сообщение в новом разговоре. При сбое команды проверьте её точное правило; при неверной цене курса проверьте поиск знаний и публикацию. Записывайте реальный ответ, а не признавайте настройку успешной лишь по зелёному состоянию подключения.

Набор из шести сообщений служит отправной точкой. Руководство по тестированию AI-агента поддержки показывает, как перед запуском дополнить его реалистичными ошибочными сценариями и критериями оценки.

Шаг 6: Как научить бота отправлять PDF?

Добавьте одну API Action, отправляющую фиксированный справочник курсов в текущий Telegram-чат. Агент решает, попросил ли его ученик; интеграция предоставляет данные доступа и получателя.

Схема трёх фиксированных источников для Action отправки документа: System Token, метаданные канала текущего чата и публичный URL PDF Ученик не предоставляет токен или 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 в чате ученика. Вместе результат запроса и полученный файл подтверждают доставку; одного текста подтверждения агента недостаточно.

Проводите тест доставки в 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. Отправьте BotFather /setjoingroups, выберите бота и включите участие в группах, если оно выключено.
  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. Он ответил на адресованную команду расписания и на вопрос о цене, отправленный ответом на сообщение бота. Это иллюстрирует общий вариант; собственный бот Fernway проверен в личном чате, поэтому его поведение в группе ещё требует указанных проверок.

Fernway Study Group с общим ботом Quickchat AI, отвечающим на адресованную команду расписания и ответ с вопросом о цене B1

Эта группа использует общего @QuickchatAI_bot. Собственный бот 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 обрабатывает сообщения, отправленные боту; оно не настраивает ответы от вашего личного профиля.

Quickchat AI Quickchat AI Ask Quickchat AI a question