Telegram AI-чатбот для груп і приватних повідомлень без коду

Telegram AI-чатбот може відповідати зі знань вашої компанії в групі або приватній розмові. Quickchat AI підключає Agent до Telegram через спільного бота: додайте його в групу, підтвердьте зв’язок у панелі керування, і учасники зможуть згадати бота із запитанням. Для цього способу не потрібні код або токен BotFather.

У цьому посібнику створюємо Saltmarsh Sailing School, вигадану школу з групою учасників і приватними зверненнями. Два Agent використовують однакові факти: Saltmarsh Group відповідає публічно, а Saltmarsh Sailing School приймає приватні запити на пробний урок і залучає людину для повернення коштів. Запит передається офісу, але не є підтвердженим бронюванням.

Два Agent розділяють відповідальність. Груповий не має Action для передавання чи приймання запитів; приватний обробляє звернення та відповіді працівників.

Рухайтеся за планом нижче. Google Sheets є необов’язковим розширенням; спочатку можна завершити відповіді та передавання людині.

Завантажте набір Saltmarsh для Telegram з точними знаннями, Main Prompt, рецептом Action, критеріями оцінювання й тестовими повідомленнями. Це редаговані файли для наступних кроків, а не імпорт Agent одним натисканням. Приклади файлів, повідомлення й знімки залишаються англійською, щоб відповідати перевіреному прикладу.

Що потрібно для створення Telegram-чатбота?

Потрібні обліковий запис Quickchat AI, два Agent і Telegram-акаунт із правом додати бота до тестової групи. Для необов’язкового запису запитів також потрібен Google-акаунт, що може надати доступ до Google Sheets.

1. Створіть обліковий запис Quickchat AI і за потреби підтвердьте електронну пошту. Free призначений для особистого некомерційного навчання. Плани застосовуються до кожного Agent, тому бізнесу з двома Agent потрібне відповідне комерційне покриття для обох. Preview і Simulation витрачають AI-кредити. Перегляньте актуальні плани.
2. Створіть Telegram-групу Saltmarsh Members. У тестовій групі перевірте згадки, мовчання й подальші повідомлення, перш ніж запрошувати клієнтів.
3. Використовуйте власний акаунт Telegram для проходження посібника, зокрема для повідомлень відвідувача. Ви також можете працювати з Inbox у Quickchat AI. Перш ніж запрошувати клієнтів, попросіть колегу перевірити досвід з іншого акаунта.
4. Розпакуйте набір. Тримайте приклади фактів школи разом; перед запуском замініть їх власними перевіреними правилами.

Знімки Quickchat App показують локально запущений застосунок із вигаданою конфігурацією Saltmarsh; підписи позначають підготовлені тестові дані підключень. Знімки Telegram і Google Sheets показують справжні відповіді та збережений запит підключеного демо. Особисті дані акаунта обрізані або явно приховані. За фінальним списком повторіть перевірки з власними знаннями та підключеними акаунтами.

Крок 1: як навчити Telegram-чатбота знань про ваш бізнес?

Бізнес-факти додайте до Knowledge Base, а робочі інструкції до Main Prompt. Так легше виправити відповідь, не змінюючи поведінку Agent.

Ціни та правила є фактами з джерел. Стислість, визнання невизначеності та спрямування є інструкціями.

Створіть Agent і додайте знання

1. У новому акаунті виберіть Set up manually. У наявному спочатку Add new AI Agent, потім ручне налаштування.
2. На Identity введіть Saltmarsh Group у Name your AI Agent. Вставте group-main-prompt.txt з набору в Describe what you want your agent to do.
3. Продовжте без підключення зовнішніх застосунків. Завершіть вибір плану; для навчального акаунта можна скористатися Skip for now.
4. Відкрийте Knowledge Base > Add Article. У Create custom article введіть Courses and trial enquiries, виберіть Create article, вставте saltmarsh-courses.txt у Content, потім Save.
5. Повторіть для Weather, parking and personal enquiries із файлом saltmarsh-policies.txt. Дочекайтеся Ready для обох статей.
6. Для Saltmarsh Group відкрийте Actions & MCPs. Залиште Human Handoff вимкненим і не додавайте Action для пробних уроків.
7. Виберіть Add new AI Agent і повторіть ручне налаштування для Saltmarsh Sailing School з main-prompt.txt та тими самими двома файлами знань. Другий Agent обслуговуватиме приватні розмови. Перед зміною налаштувань виберіть потрібний Agent у перемикачі акаунта.

Два короткі джерела чітко показують, які факти має Agent. Перед тестом знань перевірте Ready.

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

Налаштуйте Main Prompt і перевірте відповідь

1. Для кожного Agent відкрийте Identity > Main Prompt і перевірте відповідний промпт Saltmarsh. Груповий відповідає на загальні питання й спрямовує до закріпленого приватного посилання; приватний збирає запити й використовує Human Handoff.
2. Відкрийте AI Preview і запитайте How much is Start Sailing?. Перевірте два дні та EUR 240.
3. Запитайте Do you rent wetsuits?. Відповідь має визнавати брак інформації.

Промпт приватного Agent визначає збір даних і передавання. Груповий має окремий промпт і обидві Actions вимкнено.

Два фрагменти справжніх налаштувань групового Agent. Він відповідає зі знань, але не має Action для запитів або передавання.

Два Agent роблять спрямування явним. Груповий не може випадково передати розмову; приватний може передати повернення коштів, не зупиняючи групу. Preview перевіряє факти школи, наступні кроки перевіряють кожне Telegram-підключення.

Крок 2: як додати AI-чатбота до Telegram-групи?

Відкрийте External Apps > Telegram, додайте спільного бота до групи й у Quickchat AI виберіть Confirm. До підтвердження Agent мовчить у групі.

Участь у Telegram і підтвердження в Quickchat AI є окремими кроками.

1. Виберіть Saltmarsh Group у перемикачі Agent. Відкрийте External Apps, виберіть Telegram і знайдіть Quickchat AI bot.
2. Виберіть Add to a Telegram group. У Telegram виберіть Saltmarsh Members та схваліть додавання бота.
3. Поверніться до Quickchat AI. Під Waiting for your confirmation перевірте назву групи й Added by.
4. Для потрібної групи виберіть Confirm. Вона має перейти до Connected chats з увімкненим перемикачем.
5. У Telegram введіть @ і виберіть бота зі списку згадок. Запитайте How much is Start Sailing?. Ім’я спільного бота зазвичай @QuickchatAI_bot; використовуйте фактичне ім’я у вашій групі.
6. Відповідайте безпосередньо на його повідомлення: What should I bring?. Потім окремо, без згадки, надішліть Does anyone know the gate code?. Спільний бот має відповісти на перше й промовчати на звичайне повідомлення.

Виберіть Saltmarsh Members у Telegram, потім поверніться до Quickchat AI, щоб підтвердити підключення.

Справжній локальний інтерфейс із підготовленою тестовою групою показує місце Confirm. Він ілюструє керування, а не доводить приєднання до живої Telegram-групи.

Підтверджена група отримала очікувану відповідь про курс. Згадуйте бота за його справжнім ім’ям користувача.

Відповідь на повідомлення бота працює без повторної згадки. У відповіді перелічено надані відомості про спорядження.

Підтвердження важливе, бо дані запрошення з’являються у групі. Quickchat AI вимагає рішення з акаунта, перш ніж вважати групу призначенням Agent. Не підтверджуйте незнайому групу. Документація Telegram-підключення пояснює ту саму межу.

Завершіть підтвердження, перш ніж виходити з налаштування. Якщо бот залишить непідтверджену групу, створіть нове посилання Add to a Telegram group, додайте його знову й одразу підтвердьте групу, що очікує, у Quickchat AI. Додавання бота через пошук учасників у Telegram не замінює цей процес підключення.

Позначка Admin показує статус бота в Telegram. Для звичайних відповідей спільного бота вона не потрібна. Адміністраторські права теж не змінюють правило відповідати на згадки або прямі відповіді.

Крок 3: як увімкнути приватні Telegram-чати?

Увімкніть Direct message link і поширте повний згенерований URL. Посилання вибирає ваш Agent у спільному боті, тож клієнти можуть писати приватно без додавання до групи.

Група є спільною розмовою. Особисті дані й передавання працівнику перенесіть у приватні повідомлення.

1. Виберіть приватний Agent Saltmarsh Sailing School. В External Apps > Telegram увімкніть Direct message link. Групові підключення залиште порожніми.
2. Скопіюйте створене посилання. Збережіть параметр start=; звичайне посилання на спільного бота не визначає ваш Agent.
3. Відкрийте його в Telegram і за потреби натисніть Start.
4. Без згадки бота запитайте How much is Start Sailing?. Перевірте відповідь школи та знайдіть розмову в Inbox.
5. Закріпіть посилання у привітанні групи, щоб учасники знайшли його до публікації особистих даних.

Використовуйте посилання для власного Agent. Показана локальна конфігурація не є доказом доставки до живого Telegram.

Telegram доставив привітання Saltmarsh після Start. Далі перевірте відповідь зі знань; саме привітання не тестує пошук інформації.

Два вирізані фрагменти одного екрана Telegram показують закріплене запрошення. Значення start демонстраційного посилання пропущено; закріпіть власне повне згенероване посилання.

Приватний чат зі спільним ботом одночасно прив’язаний до одного Agent. Посилання іншого Agent може змінити цю прив’язку. Для власного Telegram-образу й окремої гілки використовуйте шлях із власним ботом.

Вимкнення Direct message link блокує нові підключення через нього. Наявний чат зупиніть його перемикачем або Disconnect. Посилання є публічним входом, а не обмеженням доступу до конфіденційних знань.

Крок 4: як зберегти запит на пробний урок у Google Sheets?

Інтеграція Google Sheets створює таблицю й Action додавання рядків. Пристосуйте її для трьох обов’язкових полів і перевірте справжній рядок. Цей необов’язковий крок працює зі спільним Telegram-ботом.

Результат є запитом для опрацювання людиною. Він не резервує місце й не встановлює ціну пробного уроку.

Підключіть Sheets і налаштуйте одну Action

1. На Saltmarsh Sailing School відкрийте Actions & MCPs > Add Action > Google Sheets, потім Connect Google Sheets. Увійдіть потрібним Google-акаунтом і надайте запитаний доступ.
2. Відкрийте створену таблицю Quickchat Leads. Залиште назву вкладки Leads, бо на неї вказує URL Action.
3. Замініть заголовки у такому порядку: Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. В Actions & MCPs змініть створену Action log_lead_to_google_sheet за рецептом нижче. Параметри, тіло запиту й заголовки змінюйте разом, щоб збігався порядок.

API Action Name

Record trial-lesson request

What to ask the user first

Для всіх трьох параметрів виберіть No default, видаліть стандартні поля електронної пошти й запитання. Рецепт питає лише ці три речі. Ім’я користувача Telegram необов’язкове й не є надійним обов’язковим контактом; посилання розмови дозволяє працівникам повернутися до запиту.

Метод і URL: залиште згенерований POST URL. Він уже містить ID таблиці, вкладку Leads і valueInputOption=RAW. Жодного шаблонного ID заповнювати не потрібно.

Заголовки: збережіть конфігурацію інтеграції.

На вкладці Body в API Endpoint використайте:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Через Add AI Data вставте параметри й змінні розмови. Перші три значення надходять із розмови, останні два надає Quickchat AI.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

Відкрийте Advanced settings > Run only when і додайте telegram_chat_type equals private. Використовуйте сам ключ метаданих без metadata_ і фігурних дужок. Це не дасть надіслати HTTP-запит для групового повідомлення, навіть якщо модель спробує. Документація умов виконання пояснює перевірку.

Задайте Response filter як $.updates.updatedRows, щоб Action повертала кількість рядків замість зайвої відповіді постачальника. Залиште Action увімкненою.

Сам ключ називається telegram_chat_type. Умову перевіряють до надсилання запиту.

Локальне налаштування рецепта. URL Sheets і дозвіл OAuth мають походити з вашого Google-підключення.

Перевірте рядок, потім неповний запит

Через приватне Telegram-посилання Agent надішліть:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Перевірте три місця: відповідь описує запит, картка Action в Inbox показує надані значення, а справжня вкладка Leads має відповідний рядок. Упевнена відповідь або високий бал Simulation не доводять запису в Sheets.

Agent записав надане ім’я, побажання щодо вівторка й початковий рівень досвіду. Наявність місць і точну ціну ще має підтвердити офіс.

Два фрагменти того самого збереженого рядка залишають усі п’ять стовпців читабельними. Посилання на розмову в конкретному акаунті приховане; інші чотири значення не змінено.

Окремий тест почніть із I would like a trial lesson. Перед Action Agent має запитувати відсутні поля по одному. Спробуйте й How much is Start Sailing?; звичайне питання про курс не повинно створювати рядок. Промпт просить один запис на звернення, але рецепт не є ідемпотентною системою бронювання. Перед робочим використанням перевірте дублікати.

Крок 5: як передати Telegram-розмову людині?

Налаштуйте Human Handoff, потім перевірте призначення в Inbox. Інструкція «офіс відповість» сама не передає відповідальність і не зупиняє AI.

Контрольна точка є зміною призначення. Людина завершує справу; повернення AI перевіряється окремо.

1. Виберіть Saltmarsh Sailing School, відкрийте Actions & MCPs > Human Handoff і ввімкніть. На Saltmarsh Group залиште цю Action вимкненою.
2. У Handoff Rules натисніть +. До Rule Name введіть Private enquiries, до Description вставте handoff-rule.txt і ввімкніть State. Нові рядки неактивні. Правило приватного Agent охоплює повернення, скарги, прохання про людину й прийняття людської допомоги.
3. Очистьте Keywords, вимкніть готові правила й збережіть лише одне активне власне правило. Групу ізолює вимкнений Human Handoff на окремому Agent; правило описує, коли передає приватний.
4. У Confirmation задайте I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Налаштуйте Human Agents’ availability за реальними годинами роботи та правдиве повідомлення поза ними.
5. Із приватного Telegram-чату надішліть I want a refund for last week. Can I speak to a person?.
6. В Inbox знайдіть розмову, перевірте призначення, виберіть Assign to me і надішліть Hi, I’m Alex from the office. I’ll review your request. Перевірте отримання в Telegram.
7. Коли розмова належить людині, надішліть наступне клієнтське повідомлення. AI має мовчати. Оператор завершує справу й вирішує її в Inbox. Повернення до AI тестуйте окремо.

State власного правила увімкнено. Готові тригери вимкнені; залишається одне правило для перевірки.

Справжній запит у Telegram запустив Handoff. Призначення в Inbox і вихідну відповідь оператора перевірено окремо.

Під час живої перевірки розмова перейшла в Unassigned, готова до того, щоб її взяла людина. Оператор вибрав Assign to me, надіслав відповідь офісу, і Telegram її прийняв. Знімок вище показує відповідь під час передавання; пізнішого повідомлення оператора на ньому немає. Повторюючи тест, перевірте і призначення, і доставку.

Залиште цей випадок оператору, доки його не буде вирішено. У нашому локальному тесті повернення коштів перемикання на AI Agent дозволило одну відповідь, після чого Handoff спрацював знову. Повернення до AI потребує власного успішного подальшого тесту; воно не входить до критеріїв завершення цього процесу. Посібник із передавання людині докладніше розглядає персонал і відповідальність.

Крок 6: як протестувати весь Telegram-чатбот?

Використовуйте Testing для повторюваних перевірок відповідей, а живий Telegram і зовнішні дії перевіряйте окремо. Модель може відповісти правильно, коли груповий зв’язок, запис таблиці чи доставка при передаванні не працюють.

Перевіряйте систему, відповідальну за результат: знання для фактів, журнали Action для запитів, Sheets для рядків, Telegram для доставки.

Запустіть повторюваний набір питань

1. Відкрийте Testing, створіть набір Saltmarsh: knowledge checks і виберіть Paste messages.
2. Вставте simulation-messages.txt. Збережіть окремі розділювачі --- між випадками.
3. Відкрийте Evaluation criteria, вставте evaluation-criteria.txt із набору та збережіть.
4. Виберіть Run > Start Run, потім перевірте окремі відповіді й бали.

Змінюючи одну інструкцію, залишайте ті самі питання для корисного порівняння.

Читайте відповіді, а не лише бал. Це локальні тести знань, не доставки в Telegram.

Оцінювачу потрібні факти школи для перевірки точності. Він має знати, що текст розмови не доводить рядка таблиці, Telegram-доставки чи зміни призначення. Стандартна текстова Simulation не надає Telegram-метаданих; їх відсутність не означає несправності умови лише для приватних чатів. Залежні від каналу перевірки проводьте в реальній приватній розмові.

Що змінили локальні тести?

Початковий варіант використовував одного Agent для обох входів. Локальний тест показав, що груповий запит на повернення коштів передає спільну розмову через Human Handoff. Ми розділили Agent-ів і вимкнули Handoff та Actions для приймання запитів у групового Agent. Повторні групові перевірки повернення коштів і пробного уроку тоді спрямували до закріпленого приватного посилання, а розмова залишилася за AI. Саме тому крок 1 використовує і конфігурацію, і інструкції для розділення двох розмов.

Усі десять фінальних локальних перевірок знань отримали по 5/5, а обидва хостовані Agent-и пройшли ті самі десять випадків. Ці невеликі прогони не є оцінкою точності у виробничому середовищі. Справжня група також відповіла на запитання про ціну курсу та спорядження, а потім відмовилася підтверджувати прокат гідрокостюмів. Збережіть випадки з відсутніми фактами під час адаптації набору; самі лише правильні ціни не перевіряють стриманість Agent.

Брак знань дає відповідь «не можу підтвердити». Окреме повідомлення про код воріт не звертається до бота, і на цьому знімку відповіді на нього не видно.

Справжній приватний запит на пробний урок спричинив один успішний виклик Sheets Action з Alex Morgan, Tuesday і beginner. Google повернув HTTP 200 та один оновлений рядок; збережений рядок також містив посилання на розмову й канал telegram. Окремий тест Action із метаданими групового чату не надіслав HTTP-запиту. Адаптуючи умову, перевіряйте і прийнятий приватний запит, і відхилений груповий контекст.

Перевірте канал і його зовнішні наслідки

Власні спостереження записуйте в порожній test-matrix.csv із набору. Знімки вище показують продемонстровані результати; таблиця також містить перевірки для вашої конфігурації. Записуйте час, що минув, коли тестуєте мовчання, і відокремлюйте прийняття розмови людиною від можливого подальшого повернення до AI.

Якщо перевірка не пройшла, змініть одне відповідне налаштування й повторіть повідомлення. Відсутній факт виправте в Knowledge Base; передчасну Action у її описі чи обов’язкових полях; для мовчазної групи спершу перевірте підтвердження й звертання. Збережіть невдалий результат для порівняння.

Коли створювати власного бота через BotFather?

Власний бот потрібен для власного імені й зображення, Telegram Bot API Actions або отримання звичайних групових повідомлень. Для описаних групових і приватних відповідей достатньо спільного бота.

Перед додаванням другого бота виберіть потрібний образ і поведінку повідомлень.

1. У Telegram відкрийте підтверджений акаунт BotFather і надішліть /newbot.
2. Виберіть відображуване ім’я й вільне ім’я користувача із закінченням bot. BotFather поверне токен. Тримайте його в таємниці.
3. Виберіть Saltmarsh Group, якщо цього бота буде додано до групи. Використовуйте Saltmarsh Sailing School лише для приватних чатів. В External Apps > Telegram відкрийте Your own bot, виберіть Connect to Telegram.
4. Вставте токен у Bot Token і завершіть зв’язок. Перевірте ввімкнений Enable your own bot.
5. Відкрийте Telegram-посилання бота, надішліть /start, потім те саме питання про ціну.
6. Для звичайних групових повідомлень використайте /setprivacy у BotFather, виберіть бота й Disable, потім видаліть і додайте його назад до тестової групи. Бот-адміністратор теж отримує такі повідомлення. Документація приватності Telegram пояснює доставку.

Вставляйте токен лише в Bot Token. Поле порожнє, щоб не публікувати облікові дані.

Тримайте спільного й власного бота в окремих групах. Разом вони можуть дублювати відповіді. Для закріплення оголошень чи модерації скористайтеся посібником керування Telegram-групою, включно з умовами Actions лише для адміністраторів.

Чи можуть ChatGPT або Claude допомогти налаштувати Telegram-чатбота?

Підключений застосунок керування Quickchat AI може створити Agent, додати знання, змінити підтримувані налаштування й запустити тести. Якщо клієнт надає налаштування Telegram, він може активувати посилання приватних повідомлень спільного бота. Вибір групи й підтвердження в панелі керування залишаються власнику. Деякі клієнти також потребують панелі керування для активації приватного посилання та налаштувань Human Handoff, тому асистент має спочатку перевірити доступні інструменти.

Підключіть плагін Quickchat AI для ChatGPT або конектор Claude і надайте файли набору з цим промптом:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

Доступність інструментів залежить від клієнта й прав акаунта. Для входу дотримуйтеся інструкції керування акаунтом. Це з’єднує асистента з Quickchat AI; особиста розмова ChatGPT чи Claude не стає серверною частиною Telegram-бота.

Чому Telegram-чатбот не відповідає?

Перевірте зв’язок і шлях повідомлення перед переписуванням промпта. Ці симптоми мають різні причини.

Перед запрошенням клієнтів замініть вигадані факти, перевірте поділ групових і приватних розмов та забезпечте персонал для черги переданих звернень. Як фінальну перевірку перед запуском попросіть колегу перевірити публічні входи з іншого акаунта. Для іншого каналу спільноти посібник зі створення Discord-чатбота пропонує схожий шлях створення й тестування. Для розмов із персонажами використайте посібник Telegram roleplay.

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

Налаштування Saltmarsh для копіювання

Це повні факти джерел та інструкції посібника. Завантаження містить також рецепт Action, критерії оцінювання й тести.

Груповий Agent: Main Prompt

Вставте в Identity > Main Prompt для Saltmarsh Group. Human Handoff і власні Actions залиште вимкненими.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Приватний Agent: Main Prompt

Вставте в Identity > Main Prompt для Saltmarsh Sailing School. Назва Action має відповідати рецепту.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

Знання: курси й запити на пробні уроки

Вставте в Content першої статті знань.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

Знання: правила й інформація для учасників

Вставте в Content другої статті.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Правило Human Handoff

Вставте під Human Handoff > Handoff Rules і налаштуйте справжню доступність працівників.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

Поширені запитання

Як додати AI-чатбота до Telegram-групи?

У Quickchat AI відкрийте External Apps, виберіть Telegram і Add to a Telegram group. Виберіть групу в Telegram, поверніться до Quickchat AI та підтвердьте через Confirm. Учасники можуть питати, згадуючи спільного бота або відповідаючи на його повідомлення.

Чи відповідає Telegram AI-чатбот на кожне повідомлення?

Спільний Quickchat AI бот відповідає у групі на згадки й відповіді на власні повідомлення. Звичайне обговорення не запускає відповідь. Власний бот може отримувати звичайні повідомлення, коли приватність Telegram вимкнена або бот має права адміністратора. Перевірте це в окремій групі.

Чи потрібні BotFather або токен Telegram-бота?

Для спільного бота й приватного посилання BotFather чи токен не потрібні. Створіть власного бота через BotFather для свого імені й зображення або Actions, що викликають Telegram Bot API. Звичайні Google Sheets Actions працюють зі спільним ботом.

Чи можуть клієнти писати Telegram-чатботу приватно?

Так. Увімкніть Direct message link у Quickchat AI й поширте повне посилання. Клієнт відкриває його й за потреби натискає Start. Воно вибирає ваш Agent у спільному боті. Вимкнення блокує нові підключення; наявні приватні чати мають окремі перемикачі ввімкнення й від’єднання.

Чи безкоштовний Telegram AI-чатбот?

Створення бота через BotFather саме не додає AI-сервісу. Quickchat AI має Free для особистого некомерційного навчання з обмеженими AI-кредитами. Комерційне використання потребує платного плану. Відповіді, Preview і Simulation витрачають кредити, а зовнішні сервіси можуть мати власну вартість.

Чи є в Telegram AI-чатботи?

Telegram підтримує сторонніх AI-ботів та інтеграції. Цей посібник підключає Quickchat AI Agent, який відповідає зі знань вашого бізнесу. BotFather створює образ бота; не надає знань і не налаштовує клієнтську підтримку.

Чи розуміє чатбот фотографії й файли?

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

Чи можна створити Telegram roleplay-бота або персонажа?

Так. Те саме Telegram-підключення може обслуговувати Agent з образом персонажа й відповідними інструкціями. Цей приклад присвячений бізнес-підтримці; roleplay Agent потребує власного промпта й тестів.