Telegram AI чатбот може да отговаря от знанията на бизнеса ви в група или личен разговор. Quickchat AI свързва Agent с Telegram чрез споделен бот: добавете го в групата, потвърдете връзката в таблото и членовете могат да го споменат с въпрос. За този път не са нужни код или токен от BotFather.
В ръководството създаваме Saltmarsh Sailing School, измислена школа с група за членове и лични запитвания. Два Agent-а споделят едни факти: Saltmarsh Group отговаря публично, а Saltmarsh Sailing School приема лични заявки за пробен урок и включва човек при възстановяване на суми. Заявката е запитване до офиса, не потвърдена резервация.
Два Agent-а разделят отговорността. Груповият няма Action за предаване или приемане на заявки; личният обработва запитванията и отговорите на служителите.
Следвайте пътя по-долу. Google Sheets е незадължително разширение; първо можете да завършите отговарянето и предаването на човек.
| Какво изграждате | Контролна точка |
|---|---|
| 1. Знания и инструкции | Agent знае цената на курса и не измисля липсващи факти. |
| 2. Свързване на групата | Отговаря при споменаване, мълчи при обикновен разговор. |
| 3. Личен чат | Пълната връзка отваря разговор с правилния Agent. |
| 4. Незадължителни заявки за урок | Задължителните данни стават ред за последваща работа от офиса. |
| 5. Human Handoff | Човек поема разговора и AI спира. |
| 6. Тестване | Проверявате отделно отговорите, насочването и външните ефекти. |
Изтеглете пакета Saltmarsh за Telegram с точните знания, Main Prompt, рецептата за Action, критериите за оценка и тестовите съобщения. Това са файлове за редактиране в следващите стъпки, не импорт на Agent с едно щракване. Примерните файлове, съобщения и снимки остават на английски, за да съвпадат с проверения пример.
Какво е нужно за Telegram чатбот?
Нужни са Quickchat AI акаунт, два Agent-а и Telegram акаунт с право да добави бот в тестова група. Незадължителният запис на заявки изисква и Google акаунт, който може да разреши Google Sheets.
- Създайте Quickchat AI акаунт и при нужда потвърдете имейла. Free е за лично, нетърговско обучение. Плановете важат за всеки Agent, затова бизнес с два Agent-а се нуждае от подходящо търговско покритие и за двата. Preview и Simulation използват AI кредити. Вижте актуалните планове.
- Създайте Telegram група
Saltmarsh Members. В тестовата група проверете споменаванията, мълчанието и последващите съобщения, преди да поканите клиенти. - Използвайте своя Telegram акаунт за ръководството, включително за съобщенията на посетителя. Можете също да работите с Inbox на Quickchat AI. Преди да поканите клиенти, помолете колега да провери преживяването от друг акаунт.
- Разархивирайте пакета. Дръжте примерните факти заедно; преди внедряване ги заменете със свои проверени правила.
Снимките от Quickchat App показват локално работещо приложение с измислената конфигурация Saltmarsh; подписите посочват тестовите данни за състоянието на връзките. Снимките от Telegram и Google Sheets показват действителните отговори и записаното запитване от свързаната демонстрация. Личните данни на акаунта са изрязани или изрично скрити. Използвайте финалния списък, за да повторите проверките със своите знания и свързани акаунти.
Стъпка 1: Как да научите Telegram чатбота за бизнеса си?
Поставете бизнес фактите в Knowledge Base, а работните инструкции в Main Prompt. Така можете да поправите отговор, без да променяте поведението на Agent.
Цените и правилата са факти от източници. Краткостта, несигурността и насочването са инструкции.
Създайте Agent и добавете знанията
- В нов акаунт изберете Set up manually. В съществуващ първо Add new AI Agent, после ръчна настройка.
- В Identity въведете
Saltmarsh Groupв Name your AI Agent. Поставетеgroup-main-prompt.txtот пакета в Describe what you want your agent to do. - Продължете без външни приложения. Завършете избора на план; за учебен акаунт можете да използвате Skip for now.
- Отворете Knowledge Base > Add Article. Въведете
Courses and trial enquiriesв Create custom article, изберете Create article, поставетеsaltmarsh-courses.txtв Content, после Save. - Повторете за
Weather, parking and personal enquiriesсъсsaltmarsh-policies.txt. Изчакайте и двете статии да показват Ready. - В Saltmarsh Group отворете Actions & MCPs. Оставете Human Handoff изключен и не добавяйте Action за пробни уроци.
- Изберете Add new AI Agent и повторете ръчната настройка за
Saltmarsh Sailing Schoolсmain-prompt.txtи същите два файла със знания. Вторият Agent обслужва личните разговори. Преди промени изберете правилния Agent от превключвателя на акаунта.
Два кратки източника показват ясно какво знае Agent. Проверете Ready преди теста за знания.
| Знания | Точни факти в примера |
|---|---|
| Курсове | Start Sailing: два дни, EUR 240. Day Skipper theory: пет вечери, EUR 310. Частен урок: 90 минути, EUR 95. |
| Дати | Сезон от април до октомври; датите се публикуват месец по-рано. Няма текуща наличност или следваща дата. |
| Екипировка | Водоустойчиво яке, обувки без следи и дрехи за преобличане. Школата осигурява помощни жилетки за плаване. |
| Време | Над 25 възела или гръмотевични бури: преместване на следваща свободна дата без доплащане. Инструкторът решава същата сутрин. |
| Паркиране | Безплатно при клуба. Кодът за портата се изпраща предишния ден; самият код липсва. |
| Пробни уроци | Съберете име, предпочитан ден от седмицата и опит с ветроходство. Офисът потвърждава наличност и цена. |
Наемът на неопренови костюми умишлено липсва. Правилният отговор признава, че не може да потвърди, вместо да измисли да или не. Правилото за времето не дава днешна прогноза, а цената на частния урок не определя тази на пробния.
Настройте Main Prompt и проверете отговор
- При всеки Agent отворете Identity > Main Prompt и проверете съответния Saltmarsh prompt. Груповият отговаря на общи въпроси и насочва към закачената лична връзка; личният събира запитвания и използва Human Handoff.
- Отворете AI Preview и попитайте
How much is Start Sailing?. Проверете два дни и EUR 240. - Попитайте
Do you rent wetsuits?. Отговорът трябва да признае липсата на информация.
Prompt-ът на личния Agent определя приемането и предаването. Груповият използва отделен prompt и има двете Actions изключени.
Два откъса от истинските настройки на груповия Agent. Отговаря от знанията, но няма Action за заявки или предаване.
Два Agent-а правят насочването ясно. Груповият не може случайно да предаде разговор; личният може да предаде искане за възстановяване, без да спира групата. Preview проверява фактите на школата, а следващите стъпки връзките с Telegram.
Стъпка 2: Как да добавите AI чатбот в Telegram група?
Отворете External Apps > Telegram, добавете общия бот в групата и в Quickchat AI изберете Confirm. До потвърждението Agent мълчи в групата.
Членството в Telegram и потвърждението в Quickchat AI са отделни стъпки.
- Изберете Saltmarsh Group. Отворете External Apps, изберете Telegram и намерете Quickchat AI bot.
- Изберете Add to a Telegram group. В Telegram изберете
Saltmarsh Membersи разрешете добавянето на бота. - Върнете се в Quickchat AI. Под Waiting for your confirmation проверете името на групата и Added by.
- За правилната група изберете Confirm. Тя трябва да премине в Connected chats с включен превключвател.
- В Telegram въведете
@и изберете бота от списъка за споменаване. ПопитайтеHow much is Start Sailing?. Общият бот обикновено е@QuickchatAI_bot; използвайте действителното име във вашата група. - Отговорете директно на съобщението с
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 в общия бот, така че клиентите да пишат лично без добавяне в група.
Групата е общ разговор. Преместете личните данни и предаването на служител в лични съобщения.
- Изберете личния Agent Saltmarsh Sailing School. В External Apps > Telegram включете Direct message link. Оставете груповите връзки празни.
- Копирайте създадената връзка. Запазете параметъра
start=; обикновената връзка към общия бот не посочва вашия Agent. - Отворете я в Telegram и при нужда натиснете Start.
- Без споменаване попитайте
How much is Start Sailing?. Проверете отговора и намерете разговора в Inbox. - Закачете връзката в приветствието на групата, за да я намират преди споделяне на лични данни.
Използвайте връзката за собствения си Agent. Локалната настройка не е доказателство за доставка в жив Telegram.
Telegram достави приветствието на Saltmarsh след Start. След това проверете отговор от знанията; самият поздрав не тества извличането на информация.
Два изрязани детайла от един и същ Telegram екран показват закачената покана. Стойността start на демонстрационната връзка е пропусната; закачете собствената си пълна генерирана връзка.
Личният чат с общия бот е свързан с един Agent наведнъж. Връзката на друг Agent може да смени това свързване. За собствен Telegram образ и отделна нишка използвайте пътя със собствен бот.
Изключването на Direct message link спира нови връзки през нея. За съществуващ чат използвайте неговия превключвател или Disconnect. Връзката е публичен вход, а не ограничение за достъп до поверителни знания.
Стъпка 4: Как да запишете заявка за пробен урок в Google Sheets?
Интеграцията Google Sheets създава таблица и Action за добавяне на редове. Приспособете я за трите задължителни полета, после проверете истинския ред. Стъпката е незадължителна и работи с общия Telegram бот.
Резултатът е запитване за обработка от човек. Не резервира място и не определя цена на пробен урок.
Свържете Sheets и настройте една Action
- В Saltmarsh Sailing School отворете Actions & MCPs > Add Action > Google Sheets, после Connect Google Sheets. Влезте в правилния Google акаунт и разрешете искания достъп.
- Отворете създадената Quickchat Leads таблица. Запазете името Leads на раздела, защото URL на Action сочи към него.
- Заменете заглавния ред в този ред:
Name,Preferred weekday,Sailing experience,Conversation link,Channel. - В Actions & MCPs редактирайте създадената
log_lead_to_google_sheetAction по рецептата. Променяйте параметрите, тялото и заглавията заедно, така че позициите да съвпадат.
API Action Name
Record trial-lesson request
What to ask the user first
| Format | Name | Description | Required |
|---|---|---|---|
| Text | name | Името, дадено от човека за тази заявка. Ако липсва, попитайте. | Да |
| Text | preferred_weekday | Предпочитан ден от седмицата, например вторник. Това е предпочитание, не потвърдена дата. | Да |
| Text | sailing_experience | Заявеният опит с ветроходство, например начинаещ. При липса попитайте; не предполагайте. | Да |
За трите параметъра задайте No default и премахнете стандартните полета за имейл и запитване. Рецептата пита само за тези три данни. Telegram потребителското име не е задължително и не е надеждно задължително поле за контакт; записаната връзка позволява на персонала да продължи разговора.
Метод и URL: запазете генерирания POST URL. Вече съдържа ID на таблицата, раздел Leads и valueInputOption=RAW. Няма заместващо ID за попълване.
Заглавки: запазете настройката на интеграцията.
| Заглавка | Стойност |
|---|---|
Authorization | Bearer {{google_sheets_access_token}} |
Content-Type | application/json |
В раздел 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 броя редове вместо ненужен отговор от доставчика. Оставете я включена.
Самият ключ е telegram_chat_type. Условието се проверява преди изпращането.
Локална настройка на рецептата. Sheets URL и 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?; обикновен въпрос за курс не трябва да създава ред. Prompt-ът иска един запис на заявка, но рецептата не е идемпотентна резервационна система. Проверете дубликати преди реална употреба.
Стъпка 5: Как да предадете Telegram разговор на човек?
Настройте Human Handoff, после проверете присвояването в Inbox. Указание „офисът ще отговори“ само не прехвърля отговорността и не спира AI.
Контролната точка е промяната на присвояване. Човекът приключва случая; връщането към AI се проверява отделно.
- Изберете Saltmarsh Sailing School, отворете Actions & MCPs > Human Handoff и го включете. На Saltmarsh Group го оставете изключен.
- Под Handoff Rules изберете +. В Rule Name въведете
Private enquiries, в Description поставетеhandoff-rule.txtи включете State. Новите редове са неактивни. Правилото обхваща възстановявания, оплаквания, искания за човек и приемане на човешка помощ при личния Agent. - Изчистете Keywords, изключете готовите правила и запазете само едно активно собствено правило. Групата е изолирана чрез изключения Human Handoff на отделния Agent; правилото описва кога личният Agent предава.
- Задайте Confirmation на
I have passed this private conversation to the Saltmarsh office. A member of staff can reply here.Настройте Human Agents’ availability според реалните работни часове и честно съобщение извън тях. - От личния Telegram чат изпратете
I want a refund for last week. Can I speak to a person?. - В Inbox намерете разговора, проверете присвояването, изберете Assign to me и изпратете
Hi, I’m Alex from the office. I’ll review your request.Проверете пристигането в Telegram. - Докато човекът притежава разговора, изпратете ново клиентско съобщение. AI трябва да мълчи. Операторът довършва случая и го решава в Inbox. Връщането към AI е отделен тест.
State на собственото правило е включен. Готовите задействания са изключени, остава едно правило за проверка.
Искането в реалния Telegram чат задейства Handoff. Присвояването в Inbox и изходящият отговор на оператора бяха проверени отделно.
При реалната проверка разговорът премина в Unassigned, готов да бъде поет от човек. Операторът избра Assign to me, изпрати отговора от офиса и Telegram го прие. Снимката по-горе показва отговора при предаване; тя не показва по-късното съобщение на оператора. При повторение на теста проверете и присвояването, и доставката.
Оставете случая при оператора, докато бъде решен. В нашия локален тест за възстановяване връщането към AI Agent позволи един отговор, преди Handoff да се задейства отново. Връщането към AI изисква собствен успешен последващ тест; то не е част от критериите за завършване на този процес. Ръководството за предаване на човек разглежда по-подробно персонала и отговорността.
Стъпка 6: Как да тествате целия Telegram чатбот?
Използвайте Testing за повтаряеми проверки на отговорите, а живия Telegram и външните ефекти проверявайте отделно. Моделът може да отговори правилно, докато груповата връзка, записът в таблицата или доставката при предаване не работят.
Проверявайте системата, която отговаря за резултата: знанията за факти, Action логовете за заявки, Sheets за редове и Telegram за доставка.
Пуснете повтаряем набор от въпроси
- Отворете Testing, създайте набор
Saltmarsh: knowledge checksи изберете Paste messages. - Поставете
simulation-messages.txt. Запазете отделните разделители---между случаите. - Отворете Evaluation criteria, поставете
evaluation-criteria.txtот пакета и запазете. - Изберете 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.
| Проверка | Съобщение или действие | Очакван резултат |
|---|---|---|
| Споменаване в група | @QuickchatAI_bot How much is Start Sailing? | Кратък отговор с EUR 240; същият разговор в Inbox. |
| Отговор на бот | What should I bring? | Списък на екипировката без ново споменаване. |
| Обикновен разговор | Does anyone know the gate code? без споменаване | Общият бот не отговаря. |
| Липсващо знание | Споменете бота и попитайте Do you rent wetsuits? | Не може да потвърди; без измислено да или не. |
| Лична заявка в група | Споменете бота и поискайте възстановяване | Насочване към личен чат; групата остава при AI. |
| Личен отговор | Отворете целия DM линк и попитайте цената | Правилният Agent отговаря без споменаване. |
| Пълна заявка за урок | Изпратете Alex Morgan съобщението от стъпка 4 | Параметрите на Action съвпадат с истинския ред; без обещание за резервация. |
| Лично предаване | Поискайте възстановяване, после пишете след поемането | Присвояване на човек, доставка от оператора, без допълнителен AI отговор. |
| Правило за времето | What happens if the forecast says 30 knots? | Безплатно преместване и решение от инструктор; без твърдение за жива прогноза. |
Ако проверка се провали, променете една съответна настройка и повторете същото съобщение. Поправете липсващия факт в Knowledge Base; ранна Action в описанието или задължителните полета; тиха група първо чрез проверка на потвърждение и обръщение. Запазете проваления резултат за сравнение.
Кога да създадете собствен бот с BotFather?
Създайте собствен бот за собствено име и снимка, Telegram Bot API Actions или получаване на обикновени групови съобщения. Общият е достатъчен за описаните групови и лични отговори.
Изберете идентичността и поведението на съобщенията, преди да добавите втори бот.
| Изискване | Общ Quickchat AI бот | Собствен бот |
|---|---|---|
| BotFather токен | Не е нужен | Нужен |
| Собствено Telegram име и снимка | Обща идентичност | Идентичност на вашия бот |
| Отговори на групови споменавания и реплики | Да | Да, когато Telegram ги доставя |
| Отговори на обикновени групови съобщения | Общият бот мълчи | Настройте поверителност или администраторски статус |
| Лични разговори | Start връзка за Agent в общия бот | Собствена лична нишка на бота |
| Google Sheets Action | Поддържа се | Поддържа се |
| Telegram модераторски Actions | Общият токен не се разкрива | Собствен токен като System Token |
- В Telegram отворете проверения BotFather акаунт и изпратете
/newbot. - Изберете показвано име, после свободно потребителско име, завършващо на
bot. BotFather връща токен. Пазете го в тайна. - Изберете Saltmarsh Group, ако този бот ще се присъедини към група. Използвайте Saltmarsh Sailing School само за лични разговори. В External Apps > Telegram отворете Your own bot и изберете Connect to Telegram.
- Поставете токена в Bot Token и завършете свързването. Проверете включен Enable your own bot.
- Отворете Telegram връзката на бота, изпратете
/startи същия въпрос за цена. - За обикновени групови съобщения използвайте
/setprivacyв BotFather, изберете бота и Disable, после го премахнете и добавете отново в тестовата група. Администраторски бот също ги получава. Документацията за поверителността в Telegram обяснява доставката.
Поставяйте токена само в Bot Token. Полето е празно, за да не се публикуват данни за достъп.
Дръжте общия и собствения бот в отделни групи. Заедно могат да дават дублирани отговори. За закачане на обяви или модериране следвайте ръководството за управление на Telegram група, включително Action условията само за администратори.
Могат ли ChatGPT или Claude да помогнат с Telegram чатбота?
Свързано приложение за управление на Quickchat AI акаунт може да създава Agent, да добавя знания, да настройва поддържани параметри и да пуска тестове. Когато клиентът предоставя настройка на Telegram, той може да активира връзката за лични съобщения на общия бот. Изборът на група и потвърждението в таблото остават за собственика. При някои клиенти активирането на личната връзка и настройките на Human Handoff също изискват таблото, затова нека асистентът първо провери наличните си инструменти.
Свържете Quickchat AI плъгина за ChatGPT или Claude конектора и подайте файловете с този prompt:
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 разговор в хостван backend на Telegram бота.
Защо Telegram чатботът не отговаря?
Проверете връзката и пътя на съобщението преди пренаписване на prompt. Тези симптоми имат различни причини.
| Симптом | Проверка |
|---|---|
| Групата е в списъка, но мълчи | Потвърдете правилната група, включете я в Connected chats и споменете истинското име или отговорете на бота. |
| Ботът напусна преди първия си отговор | Генерирайте нова връзка Add to a Telegram group, добавете го отново и веднага изберете Confirm за чакащата група в Quickchat AI. |
| Обикновен бот линк отваря грешен Agent | Използвайте целия личен линк с start=. Проверете дали друга Agent връзка е сменила общия личен чат. |
| AI спря след искане за възстановяване | Проверете Inbox присвояването. Предаденият разговор остава спрян до съзнателно пренасочване. |
| Няма ред в Sheets | Проверете включена Action, всички полета, личен чат и URL към Leads. Прегледайте извикването и Google връзката. |
| Собствен бот пропуска обикновени съобщения | Проверете поверителността и правата; след промяна премахнете и добавете отново. |
| Отговорът твърди неподадена дата или услуга | Проверете записаните Ready знания и инструкцията за несигурност. Повторете точния неуспешен въпрос. |
| Тестовете спряха да отговарят | Проверете AI кредитите и неуспешната заявка; изчерпан лимит не е оценка на prompt. |
Преди да поканите клиенти, заменете измислените факти, прегледайте разделянето на груповите и личните разговори и осигурете персонал за предадените случаи. Като последна проверка преди пускане помолете колега да тества публичните входове от друг акаунт. За друг общностен канал ръководството за 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 изисква свой prompt и тестове.