Можете да добавите AI чатбот към сайта си, като предоставите на Агент информация за бизнеса си, настроите отговорите му и инсталирате чат уиджет чрез плъгин или предоставения скрипт. Чатботът за уебсайт на Quickchat AI обединява знанията, настройките на разговорите и Inbox на екипа. Посетителите задават въпроси на сайта ви, без да създават акаунт.
В това ръководство изграждаме пример за Kestrel Kitchens, измислен бизнес за проектиране на кухни. Посетител пита колко време отнема ремонтът, проверява ориентировъчната цена за кухня с размери 3 на 4 метра и след това иска оферта. Агентът отговаря въз основа на информацията за фирмата, събира данните за проекта и позволява на дизайнер да продължи разговора.
Завършеното преживяване на сайта. Kestrel Kitchens и информацията за бизнеса са измислени; уиджетът и отговорите му работят през реалното локално приложение.
Основната настройка не изисква програмиране. Следвайте стъпките за знания и инструкции, събиране на запитвания и предаване към човек, след което инсталирайте уиджета. Незадължително API Action изпраща пълните запитвания към друга система.
Изтеглете комплекта за настройване на Kestrel Kitchens, който съдържа примерния сайт, знанията, Main Prompt, настройките и тестовите съобщения. Това са редактируеми файлове, които да следвате в таблото, а не импорт на Агент с едно щракване.
Екранните снимки и копируемите артефакти от комплекта, промпта и конфигурацията остават на английски, за да можете да възпроизведете тествания пример.
Какво ще прави чатботът на сайта?
Чатботът отговаря на въпроси въз основа на съдържанието ви, записва данните за поискан последващ контакт и предава разговори на екипа, когато е необходим човек.
За всеки резултат е нужна различна проверка. Правилният ценови диапазон идва от Knowledge Base. Запитването за оферта изисква данни за контакт и за проекта в Inbox. Предаването изисква човек да поеме разговора и да изпрати отговор, който достига до посетителя.
Пътят на посетителя в примера. Запитването за оферта регистрира интерес; дизайнерът все още трябва да потвърди цената и свободните дати.
| Въпрос на посетителя | Задача на Агента | Какво да проверите |
|---|---|---|
| Колко време отнема ремонтът? | Да обясни публикуваните срокове за проектиране и монтаж | Отговорът запазва условията за тези срокове |
| Колко струва кухня с размери 3 на 4 метра? | Да посочи ориентировъчния диапазон и да обясни какво установява огледът | Няма измислена фиксирана оферта или цена на квадратен метър |
| Мога ли да поискам оферта? | Да събере име, имейл, пощенски код и тип проект | Полетата се появяват в записаните данни на разговора |
| Предлагате ли финансиране? | Да признае, че предоставените знания не съдържат тази информация | Няма измислено предложение за финансиране |
| Мога ли да говоря с дизайнер? | Да използва Human Handoff според работното време на екипа | Дизайнер може да отговори от Inbox и посетителят получава отговора |
Какво ви е нужно, преди да добавите чатбот?
Нужни са ви Quickchat AI акаунт, проверима информация за бизнеса и достъп до настройките за плъгини или персонализиран код на сайта.
- Създайте Quickchat AI акаунт и завършете регистрацията. Използвайте отделен Агент за упражнението, за да не повлияят примерните му данни на съществуващо обслужване на клиенти.
- Подгответе страниците си за услуги, често задавани въпроси и правила или използвайте измислените знания от комплекта. Заменете измислените цени и района на обслужване, преди да внедрите решението за реален бизнес.
- Проверете дали планът на сайта позволява съответния метод за инсталиране. WordPress изисква достъп до плъгини; някои хоствани платформи изискват платен план за персонализиран код в целия сайт.
- Осигурете човек, който да следи тестовия Inbox, когато изпробвате предаването към човек. Подгответе настолен браузър и телефон за финалните проверки на сайта.
Free е за лично обучение с нетърговска цел. Планът Free включва 50 AI кредита месечно. Бизнес внедряването изисква търговски план, а тестовете използват същия лимит за отговори като другите AI разговори. Абонаментите за платформата на сайта и разходите за външни API са отделни. Разделът за разходите разграничава тези разходи.
Стъпка 1: Как да обучите чатбот със съдържанието на сайта си?
Добавете страниците, които съдържат отговорите за бизнеса ви, в Knowledge Base, след което проверете импортираното съдържание преди тестването. Това дава на Агента справочен материал за отговорите му.
Създайте учебния Агент
- На първия екран за настройване изберете Set up manually. От съществуващо табло използвайте + до AI Agent (Add new AI Agent), за да създадете отделен Агент, след което изберете Set up manually.
- В Identity въведете
Kestrel Kitchensв Name your AI Agent. Поставетеmain-prompt.txtот комплекта в Describe what you want your agent to do. Това става Main Prompt на Агента, обяснен в стъпка 2. Изберете Next. - Засега оставете Knowledge Base празна и изберете Next. Продължете през External apps, без да избирате връзка. В Deployment изберете Chat widget, след това Next.
- В Choose your plan използвайте Skip for now, за да продължите личното учебно упражнение, или изберете подходящ търговски план за бизнес употреба. Завършете или отхвърлете всяко незадължително предложение, показано след това.
- В таблото потвърдете името на Агента в Identity, след което отворете Knowledge Base. Изберете собствените си страници или предоставената примерна статия по-долу.
Identity съдържа името на Агента и Main Prompt. Следващите места в това ръководство са Knowledge Base, Actions & MCPs и Your Website.
Импортирайте собствените си страници
- В Knowledge Base изберете Add Website. Изберете отделна страница или опцията за импорт на сайт според необходимия обем.
- Въведете публичния URL. При импорт на сайт прегледайте откритите страници и изберете тези за услуги, цени, процес и често задавани въпроси, които трябва да служат за основа на отговорите.
- Прегледайте импортирания текст. Потвърдете правилната валута и данъчното третиране на цените и се уверете, че стари промоции или несвързани страници не са станали източници.
- Изчакайте обработката да завърши. Приложете или публикувайте всички чакащи промени в знанията, показани в таблото, преди да тествате инсталирания уиджет.
Започнете с няколко ясни страници. Сайтът може да показва привлекателна ценова карта, а условията към нея да са другаде; Агентът се нуждае и от двете. Импортът само на началната страница може да пропусне условията за монтаж, географските ограничения или правилата за възстановяване на суми, които правят отговора полезен.
Използвайте източника за Kestrel Kitchens
За да възпроизведете примера, без първо да хоствате сайт, добавете информацията му директно:
- В Knowledge Base изберете Add Article. Това създава статия Untitled и отваря Edit Article.
- Въведете
Kestrel Kitchens: services, prices and processв Title. Под Content изберете Plain Text и поставетеknowledge.txtот комплекта. - Изберете Save и изчакайте статията да стане Ready. Уверете се, че заглавието ѝ се появява в списъка на Knowledge Base.
Knowledge Base е в навигацията на Агента. За примера е нужна една статия; използвайте Add Website за собствените си публикувани страници.
Записаната статия запазва условията за цените и сроковете. Измислената информация съответства на примерния сайт.
Копирайте пълните примерни знания
Kestrel Kitchens is a fictional kitchen design and renovation business used in this tutorial. It serves Bristol, Bath and addresses within 25 miles of central Bristol.
Services: kitchen design, supply and full installation. A full kitchen renovation typically costs £18,000 to £45,000 including VAT. This is a planning range, not a quote. The final price depends on the survey, layout, cabinetry, appliances and building work. Room dimensions alone are not enough to calculate a firm price.
Timelines: survey and design normally take 2 to 3 weeks. Installation usually takes 4 to 8 weeks after all materials are available. These are typical durations, not a promised start date or completion date.
Process: discuss the project, arrange a site survey, agree the design and receive a written quote, then schedule work once the quote is accepted and materials are available. The chatbot cannot book a survey or confirm availability.
The design team works Monday to Friday, 09:00 to 17:00, Europe/London. Quote enquiries need the visitor's full name, email, postcode and project type. A preferred timeline is helpful but optional. The team follows up by email. Do not promise a response deadline.
Източникът умишлено не уточнява финансирането. Това дава полезен тест за начина, по който Агентът се справя с реална липса на информация. За реален сайт поддържайте изходните страници актуални и използвайте поддържаните настройки за обновяване, когато са налични; ръководството за Knowledge Base обяснява как да организирате и тествате тези източници.
Стъпка 2: Какво да казва чатботът и какво никога да не обещава?
Използвайте Main Prompt, за да определите как Агентът прилага знанията: първо да отговаря, да дава полезна информация и да оставя решения като окончателната оферта на екипа.
При Kestrel размерите на помещението показват мащаба на проекта. Те не определят шкафовете, уредите или строителните работи. Агентът трябва да обясни посочения в източника ориентировъчен диапазон от £18,000 до £45,000 с ДДС, без да изчислява по-точна цена от площта на пода.
Тези цени са измислени учебни данни. Целта е да запазите разликата между фактите от източника и решението, което екипът ви все още трябва да вземе.
- В Identity изберете Edit в картата Main Prompt.
- Поставете целия промпт по-долу. Изчакайте записването, след което отворете редактора отново, за да потвърдите съхранения текст.
- Дръжте информацията за бизнеса в Knowledge Base. Използвайте промпта за стила на отговорите, поведението при събиране на данни и решенията, изискващи човек.
Main Prompt е полето за инструкции. Пълният текст по-долу и в комплекта е версията за копиране.
Копирайте целия Main Prompt
You are the website assistant for Kestrel Kitchens. Help visitors understand our services, indicative prices and process using the Knowledge Base.
Answer the visitor's question before asking for contact details. Keep replies concise, usually two to four sentences. Use the visitor's language.
Treat prices as planning ranges. Never calculate a firm quote from room dimensions, invent a discount, promise a start date, confirm a survey booking or claim financing is available. If the Knowledge Base does not answer a question, say that a designer must confirm it.
When a visitor wants a quote or follow-up, collect their full name, email, postcode and project type in conversation. Ask one or two relevant questions at a time. Ask about their preferred timeline only after the required details, and accept a refusal without pressure. Do not ask for payment information.
Offer Human Handoff when the visitor asks for a designer or needs information you cannot confirm. Respect the configured working hours. Never claim that a designer is connected or a quote is booked. If the team is unavailable, offer an email follow-up.
Acknowledge the details the visitor has provided. Do not claim CRM delivery or a confirmed booking. The design team reviews enquiries in the Inbox.
Отворете AI Preview и попитайте How long does a full kitchen renovation take?. В локалния контролен тест Агентът отговори с 2 до 3 седмици за оглед и проектиране, след това 4 до 8 седмици за монтаж след осигуряване на материалите. И срокът, и условието са от значение.
Започнете нов разговор и попитайте Do you offer financing?. Правилният отговор признава, че източникът не потвърждава такова предложение, и насочва въпроса към дизайнер. По-уверената формулировка в промпта не би добавила липсващия факт за бизнеса.
Известен отговор, включително условието материалите да са налични.
Реално липсващ факт. Източникът не съдържа условия за финансиране.
Стъпка 3: Как да събирате запитвания за оферти в чата?
Smart Data Gathering пита за избрана информация по време на разговора и записва предоставеното от посетителя. За запитване за оферта събирайте само нужното на дизайнера за последващ контакт.
Тук включвате и редактирате вградените действия. В примера картата на Smart Data Gathering се казва Quote enquiries.
- Отворете Actions & MCPs, включете Smart Data Gathering и изберете Edit Action. Задайте Name на
Quote enquiriesи Description наCapture contact and project details for a kitchen design enquiry.Записаното име става заглавие на картата. - Под Data to collect добавете редовете по-долу. Запазете тези английски имена на Data point, когато възпроизвеждате примера; имената за контакт имат специални съответствия с полетата за посетителя в Inbox.
- Задайте Reason for collecting information на
So a Kestrel Kitchens designer can assess your project and follow up by email. - Задайте When to ask for data на After exchanging a few messages, а How to ask for data на Subtle.
- Запазете действието. В AI Preview задайте полезен въпрос за услугите, преди да поискате оферта, и прегледайте записаните данни в Inbox.
| Поле за данни (Data point) | Въпрос за задаване | Формат или примерни стойности |
|---|---|---|
Full name | What is your full name? | Full name |
Email | What email can our designer use? | |
Postcode | What is the property postcode? | Text |
Project type | What kitchen work do you need? | Text |
Timeline | When would you like to start? | Text |
Въпросите описват информацията за събиране. Настройките за момент и стил насочват кога да се задават; тествайте и самия разговор.
Име, имейл, пощенски код и тип проект са задължителните данни за пълно запитване в този пример. Срокът е незадължителен, както обяснява Main Prompt. Това бизнес изискване е отделно от настройките за събиране в разговор; стъпка 8 налага задължителните полета, преди да бъде изпратена CRM заявка.
Агентът трябва да отговаря на общ въпрос за цената, без да поставя предоставянето на имейл като условие за отговор. Посетителят може и да откаже събирането на данни. Използвайте I am only researching. I do not want to leave contact details., за да проверите дали разговорът остава полезен без многократни искания.
Къде отиват събраните данни?
Отворете разговора в Inbox. Стандартните данни за контакт се появяват в полетата за посетителя; другите събрани стойности остават прикрепени към разговора и могат да бъдат експортирани чрез Export Gathered Data.
Посетителят предоставя данни за контакт и за проекта в чата.
Записаните полета са доказателството за събирането. Сравнете всяка стойност с предоставеното от посетителя.
Под Where to send data настройката Email new leads уведомява всеки администратор на Агента при първото събиране на имейл адрес или телефонен номер. Само име не изпраща имейла. Preview и Simulation не изпращат тези известия, затова проверете собствената си администраторска поща с контролиран тест на инсталирания уиджет, преди да разчитате на доставката по имейл. В локалния пример изпращането на външни имейли остава изключено.
Документацията за Smart Data Gathering описва събирането, известията и експорта. За собствения си сайт обяснете защо искате информацията и добавете връзка към уведомлението си за поверителност в уиджета. Ръководството за защита на данните при чатботове помага да прегледате по-широкия поток от данни.
Стъпка 4: Как да позволите на човек да поеме чата?
Human Handoff предава разговор на екипа ви; след това човек го поема в Inbox и отговаря на същия посетител.
Подгответе предаването, преди да публикувате уиджета. Човек, който иска дизайнер, не бива първо да е длъжен да попълни формуляра за оферта, а Агентът не бива да внушава, че някой е онлайн извън работното време на екипа.
- В Actions & MCPs включете Human Handoff и отворете Edit Action.
- Оставете стандартните правила Media Message, User Frustration, Customer Support Suggestion и Lack Of Knowledge включени; оставете Irrelevant Advice изключено. Main Prompt вече обяснява кога да предложи дизайнер. Тестваният пример използва тези стандартни правила без добавяне на персонализирани правила.
- Настройте съобщенията и наличността по-долу, след което запазете. Оставете Email notifications изключено за учебното упражнение и проверете предаването директно в Inbox.
| Настройка | Стойност за Kestrel Kitchens |
|---|---|
| Question | Would you like me to connect you with a kitchen designer? |
| Confirmation | I have passed your chat to our design team. A designer will reply here when available. |
| Human Agents’ availability | On |
| Your time zone | Europe/London |
| Working hours | Monday to Friday, 09:00 to 17:00 |
| Message outside working hours | Our design team is available Monday to Friday, 9am to 5pm UK time. Leave your name and email so a designer can follow up. |
Използвайте часове, в които човек действително следи Inbox. Измисленият график не е обещание за незабавен отговор.
В работното време на екипа попитайте Can I speak to a designer? от сайта. Изпълнете всяко потвърждение за предаване, което Агентът поиска. В Inbox отворете разговора и изберете Assign to me, когато не е възложен, или Take over, когато се показва този контрол. Изпратете човешки отговор и потвърдете, че посетителят го получава. Използвайте Reassign to AI, когато AI трябва да продължи.
Inbox събира на едно място разговора, контрола за поемане и данните за посетителя. Изберете разговора на посетителя, преди да отговорите.
Проверете кой отговаря за разговора и дали човешкият отговор е доставен, а не само предложението на Агента за предаване.
Същото предаване от страната на посетителя. Maya Patel е измисленият дизайнер, използван за локалния тест.
Повторете в нов разговор извън зададените часове. Агентът трябва да обясни наличността и да предложи посочения начин за последващ контакт. Ако временно промените графика за тази проверка, след това възстановете реалния график. Документацията за Human Handoff обяснява настройките и процеса в Inbox.
Ръководството за предаване на разговор от чатбот към човек включва отделни проверки за това кой отговаря за разговора, връщането му към AI и неуспешните сценарии извън работно време.
Стъпка 5: Как да съобразите уиджета с облика на сайта?
Настройте външния вид и фиксирания текст в Channels → Your Website. Поздравът трябва да е достатъчно конкретен, за да обяснява какво може да пита посетителят.
Трите раздела отделят инсталирането, външния вид и фиксирания текст. Appearance съдържа също аватара и етикета на бутона за отваряне.
Външен вид
- Отворете Appearance. За Kestrel изберете тема Custom с бял фон, тъмнозелена заглавна лента и акцент (
#315448) и бял текст на заглавната лента. Запазете стандартния размер на текста и заоблените контроли. - В Branding → AI Agent Avatar щракнете върху иконата за качване на аватара, изберете
website/kestrel-avatar.pngот комплекта и изберете Upload в диалога за изрязване. - Задайте Widget window max width на 400px и Widget window max height на 520px. Изберете Small за размера на бутона за отваряне, разположете го вдясно и използвайте
Ask about your kitchenкато етикет. Етикетът е наличен при малкия бутон. Прегледайте позицията спрямо банера за бисквитки или други плаващи контроли на сайта. - Оставете Auto-open Widget изключено. Отварянето на уиджета при всяко зареждане на страница прекъсва разглеждането, особено на телефон.
Проверявайте прегледа, докато избирате цветове. Тестът на реалния сайт остава важен, защото бутонът за отваряне споделя място с контролите на сайта.
Текстово съдържание
Отворете Text Content и използвайте следните стойности:
| Настройка | Стойност |
|---|---|
| Header | Kestrel Kitchens |
| Welcome message | Hello, I can help with kitchen costs, timelines and quote enquiries. What are you planning? |
| Conversation starters | How long does a renovation take? / What does a kitchen cost? / Can I request a quote? |
| Disclaimer text | AI assistant. Prices are indicative. A designer confirms your quote after a survey. |
Началните въпроси трябва да отварят полезни задачи. Уточнението показва на посетителите кои решения все още изискват дизайнер.
Агентът може да отговаря на езика на посетителя. Преводът на фиксирания поздрав и етикетите на уиджета е отделна настройка в Other languages, налична при платените планове. За многоезичен сайт тествайте и отговора, и фиксирания текст на интерфейса; ръководството за многоезични чатботове обяснява тази разлика.
Промените във външния вид може да отнемат няколко минути, за да достигнат до кешираните сесии на посетителите. Презаредете, преди да заключите, че записаната промяна е неуспешна. Hide Quickchat AI Branding изисква Professional или по-висок план; ръководството за премахване на брандирането обхваща и другите места за проверка.
Стъпка 6: Как да инсталирате чатбота на сайта си?
Инсталирайте Widget в общия шаблон на сайта или използвайте поддържаната интеграция за платформата. Плаващият Widget трябва да работи в страницата, която посетителят разглежда.
- Отворете Channels → Your Website → Install.
- Включете Widget & Embed access за публичния уиджет.
- Изберете метода за инсталиране за сайта си и копирайте показания за този Агент фрагмент или Scenario ID.
- Публикувайте промяната, отворете публичния сайт и задайте въпрос, за който знаете, че има отговор в Knowledge Base.
Копирайте от екрана Install на този Агент. Неговият Scenario ID е публичен идентификатор на уиджета, а не частен API ключ.
Всеки сайт: поставете фрагмента за Widget преди затварящия таг body
Изберете Install manually with code и копирайте фрагмента за Widget. Текущият зареждащ код има следния вид:
<script>
(function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat");
_quickchat("init", "YOUR_SCENARIO_ID");
</script>
Заменете YOUR_SCENARIO_ID със стойността от Install. Поставете целия фрагмент веднъж, непосредствено преди </body> в общия шаблон или използвайте полето на платформата за футър в целия сайт. Този код вмъква скрипт в тялото на страницата, затова поставянето му в head, преди да съществува body, може да попречи на зареждането.
Мястото е важно. HTML блок, базиран на iframe, е отделна страница и не е подходящ за този плаващ Widget.
Отделната опция Embed поставя чат в контейнер на страницата. Използвайте генерирания ѝ фрагмент, ако искате вградена чат секция. HTML блок, който вмъква код директно в страницата, може да поддържа този подход; блок на платформа, който изолира кода в iframe, е различен случай. Вижте документацията за канала Website.
WordPress: инсталирайте официалния плъгин
- В WordPress отворете Plugins → Add New, потърсете Quickchat AI Agent, след което изберете Install Now и Activate.
- Отворете Settings → Quickchat AI Agent.
- Поставете Scenario ID от екрана Install на Quickchat AI и изберете Save Changes.
- Отворете публична страница и проверете уиджета. Използвайте или плъгина, или ръчен фрагмент, за да не инсталирате зареждащия код два пъти.
Нужни са ви WordPress инсталация и план, които позволяват плъгини. Ръководството за чатбот в WordPress показва интерфейса на плъгина и проверките, специфични за WordPress.
Squarespace: използвайте вмъкване на код във футъра
- Отворете панела Code Injection на сайта. Използвайте търсенето на настройки в таблото, ако навигацията в акаунта ви се различава.
- Поставете целия фрагмент за Widget във Footer и запазете.
- Отворете публикуваната страница в отделен раздел на браузъра и тествайте отговор.
Squarespace предлага Code Injection при Core, Plus, Advanced и някои стари планове. Вмъкването във футъра поставя кода преди </body> в целия сайт. Използвайте това място за плаващия уиджет; iframe блок на отделна страница не е еквивалентен. Този персонализиран код не обхваща страниците за плащане на Squarespace.
Wix: използвайте персонализиран код в Body - end
- В таблото на сайта отворете Settings → Custom Code, след това + Add Custom Code.
- Поставете фрагмента за Widget и го наречете
Quickchat AI widget. - Приложете го към All pages и изберете Body - end, след това Apply.
- Тествайте публикувания сайт, включително преминаването към друга страница.
Wix изисква публикуван сайт със свързан домейн за персонализиран код. Използвайте настройката Custom Code за целия сайт за този плаващ уиджет.
Webflow: използвайте код във футъра и публикувайте
- Отворете Site settings → Custom code.
- Поставете фрагмента за Widget във Footer code и изберете Save changes.
- Използвайте Publish за желания домейн, след което тествайте публикувания URL.
Настройките за персонализиран код на Webflow изискват подходящ платен Workspace или активен Site план. Самото запазване на настройката не я публикува.
Shopify: изберете фрагмента за съществуващия Агент или приложението Shopify
За вече създадения Агент Kestrel добавете фрагмента му за Widget непосредствено преди </body> в Online Store → Themes → Edit code → layout/theme.liquid, след което запазете и прегледайте магазина. Направете резервно копие на темата преди редактиране и проверете инсталацията отново след смяна на теми. Този подход показва избрания Агент; той не настройва действия за продукти или поръчки.
За Агент, насочен към магазин, настройването на приложението Quickchat AI за Shopify свързва магазина чрез собствен начален процес. След свързването използвайте Enable Widget in Shopify Theme Editor или отворете Online Store → Themes → Edit theme → App embeds. Включете Quickchat AI Widget и запазете. Документацията на Shopify за вграждане на приложения обяснява контролите на темата; включете вграждането отново, когато сменяте публикуваната тема.
Описаните пътища в платформите са проверени спрямо официалната документация. Екранните снимки от примера показват сайта на Kestrel и реалния локален уиджет; те не са снимки от удостоверени акаунти във всяка платформа.
Проверете фрагмента, преди да търсите проблем в Агента
Тези незадължителни проверки работят с предоставените от вас стойности:
- Проверете фрагмент за Widget. Проверете поставения код спрямо предоставения Scenario ID. Това не извлича сайта ви.
- Сравнете методите за внедряване. Проверете декларираните канали, достъпа до сайта и необходимите функции спрямо възможностите за настройване на Quickchat AI. Това не преглежда сайта или акаунта ви.
В съвместим браузър тези проверки са налични и като инструменти на сайта. Връзките отварят стандартните формуляри.
Стъпка 7: Как да тествате чатбота преди посетителите?
Тествайте отговора, съхранените данни и доставения отговор поотделно. AI Preview и Simulation Testing помагат за оценяване на поведението; публикуваният сайт доказва, че посетителят може да използва инсталирания уиджет.
Изпълнете независими въпроси в Simulation Testing
Отворете Testing → Create Dataset, наречете набора Kestrel Kitchens: website launch checks и изберете Paste messages. Добавете въпросите за срок, цена и финансиране по-долу, разделени с ред, съдържащ --- между въпросите. Само нов ред запазва текста като едно тестово съобщение. Задайте Evaluation criteria, за да проверяват фактите и краткостта на отговорите, след което изберете Run → Start Run. Комплектът включва точните съобщения и критерии.
Всеки ред от набора започва отделен разговор. Използвайте Simulation за тези независими въпроси; изпълнете многостъпковите проверки за оферта и поемане от човек в един разговор в AI Preview или на сайта. Прегледайте дневника на действието и получателя отделно, защото оценителят на транскрипцията не може да провери външната доставка.
Отворете завършено изпълнение и прегледайте отговорите му. Този отговор за цена запазва ориентировъчния диапазон; оценката му не доказва доставка към друга система.
Същият тест за цена, отворен като разговор в Inbox. Прегледайте пълния отговор, включително защо само размерите не определят окончателна оферта, вместо да разчитате само на оценката.
| Тестово съобщение или последователност | Очакван резултат | Какво да прегледате |
|---|---|---|
How long does a full kitchen renovation take? | 2 до 3 седмици за оглед/проектиране; 4 до 8 седмици за монтаж след осигуряване на материалите | Отговора и източника |
How much would a 3 by 4 metre kitchen cost? | £18,000 до £45,000 с ДДС като ориентировъчен диапазон; нужен е оглед за окончателна оферта | Няма измислена фиксирана цена |
Do you offer financing? | Агентът не може да го потвърди от източника и предлага контакт с дизайнер | Отговора, след това предаването, ако е поискано |
Can I get a quote? My name is Sam Taylor. | Пита за липсващата информация; все още не изпраща действието за пълно запитване | Записано име; няма получена CRM заявка |
My email is sam@example.com. The postcode is BS6 7AB and it is a full kitchen renovation. | Записва предоставените имейл, пощенски код и тип проект | Полетата в Inbox; по желание дневника на действието и получателя |
I have not decided when to start. | Приема неопределен срок | Няма измислена дата или задължителен срок |
I am only researching. I do not want to leave contact details. | Продължава да отговаря без многократни искания за данни | Следващия полезен отговор |
Can I speak to a designer? | Следва зададения път в работното време или извън него | Кой отговаря за разговора и доставката на човешкия отговор |
¿Cuánto suele durar una reforma de cocina? | Отговаря на испански, като запазва същите срокове и условия | И фактите, и езика |
Използвайте нов разговор между независимите случаи. Презареждането на страницата може да възобнови съществуващ разговор, затова използвайте контрола за нов чат на уиджета, когато ви е нужен нов тест.
Проверете сайта на телефон
На екрани под 768 CSS пиксела отвореният уиджет използва оформление на цял екран. Проверете дали можете да го отворите, да пишете при видима клавиатура, да превъртате разговора и да го затворите, за да се върнете към сайта.
Отвореният уиджет на тесен екран. Оставете Auto-open изключено за този сайт, предназначен за разглеждане.
Завършете с реален човек, който отговаря от Inbox. Добрият AI отговор не доказва, че пътят за човешка поддръжка работи. Повтаряйте малък набор от тези проверки след промяна на източници, промптове, действия или темата на сайта.
Стъпка 8: Как да изпратите пълно запитване към CRM?
Незадължително API Action може да изпрати записаните полета към HTTP получател, след като разговорът съдържа цялата задължителна информация. Основният чатбот за сайта вече е използваем без това разширение.
Важно е да разграничавате събран контакт от пълно запитване. Quickchat AI задава lead_captured, когато току-що е събрал стандартно поле за контакт, включително име. Самият флаг не доказва наличието на имейл, пощенски код или тип проект.
Платформата проверява всяко условие. Моделът събира информацията; условията определят кога заявката може да бъде изпратена.
Подгответе получателя
Използвайте CRM или крайна точка за автоматизация под ваш контрол, която приема JSON тялото по-долу. Комплектът включва малък локален демонстрационен получател за читатели, които искат да прегледат заявката, преди да свържат CRM. Инструкциите му за настройване създават частен токен и обясняват как да осигурите временна HTTPS крайна точка. Изпращайте само измислени тестови данни към демонстрационния получател.
За управлявана интеграция вместо това следвайте ръководството за отчети в Google Sheets или ръководството за собствен CRM. Не включвайте два процеса, които създават едно и също запитване.
Настройте едно автоматично API Action
- Отворете Actions & MCPs → Custom Actions → Add Action → API Action. Изберете Create manually, ако се отвори конструкторът по описание.
- Задайте API Action Name на
Send quote enquiry. - Оставете What to ask the user first празно. Това действие чете полетата, вече записани от Smart Data Gathering; то не иска от модела да попълни втори набор от параметри.
- Под API Endpoint изберете
POSTи въведете HTTPS URL на получателя си с път/enquiries. - Добавете заглавките, тялото и условията по-долу, след което запазете и активирайте действието.
| Ключ на заглавка (Headers: Key) | Стойност |
|---|---|
Content-Type | application/json |
Authorization | Bearer YOUR_RECEIVER_TOKEN |
Въведете токена само в настройката за заглавки на действието. Не го включвайте в промпта, фрагмента за сайта или разговора с посетителя. README на демонстрационния получател обяснява как да го генерирате; за реална интеграция използвайте удостоверяването, описано в документацията на CRM.
В раздела Body изберете JSON и въведете:
{
"conversation_id": "{{conversation_id}}",
"name": "{{metadata_visitor_name}}",
"email": "{{metadata_visitor_email}}",
"postcode": "{{metadata_postcode}}",
"project_type": "{{metadata_project_type}}"
}
Използвайте Add AI Data, за да вмъкнете съответните вградени стойности и стойности от метаданните. conversation_id идентифицира разговора. Другите стойности идват от записаните полета; английските имена за контакт съответстват на visitor_name и visitor_email, а Project type става project_type. Документацията за променливите обяснява тези съответствия.
Реалният редактор с примерни данни за връзка. Въведете собствената си крайна точка по-горе, данните за удостоверяване в Headers и JSON в Body; цветните елементи обозначават динамични стойности. Този пример само за конфигуриране остана неактивен.
Под When to run изберете When metadata matches. В Run when добавете всичките пет реда; условията за метаданни се комбинират с AND:
| Ключ на метаданни | Условие |
|---|---|
lead_captured | is true |
visitor_name | is true |
visitor_email | is true |
postcode | is true |
project_type | is true |
За тези текстови полета is true отхвърля както празните стойности, така и текст, интерпретиран като false. exists проверява само наличието на ключ; записан празен низ може да премине проверката. Тестовете по-долу показват защо по-строгото условие е важно. Това проверява дали е предоставен използваем текст, а не дали самоличността на посетителя или данните за имота са независимо потвърдени.
Използвайте следното API Action Description:
Send a quote enquiry to the design team when the visitor has provided their full name, email, postcode and project type. This records an enquiry only; it does not book a survey or confirm a price.
Първите две от пет записани условия. Добавете всеки ред от таблицата; When metadata matches ги проверява след AI ход, без Агентът да избира действието.
Изпълнението на действието се опитва веднъж на разговор, когато всички условия са изпълнени. То не се изпълнява отново, когато пристигне незадължителен срок, а неуспешна изпратена заявка не се повтаря автоматично в този разговор. Запазете срока в Inbox за дизайнера или изградете изрична интеграция за създаване и обновяване, ако CRM се нуждае от последващи промени.
Заявката се изпълнява след AI хода и отговорът ѝ не се вмъква в чата. Затова Main Prompt потвърждава предоставените от посетителя данни, без да твърди, че CRM ги е приел. Проверете доставката в дневника на действието и при получателя. Документацията за автоматични действия описва това поведение при изпълнение.
Тествайте частични данни, след това пълното запитване
Първата версия използваше exists за задължителните текстови полета. Sam предостави име, а после имейл в следващото съобщение. Smart Data Gathering вече беше създал празни стойности за пощенски код и тип проект, затова тези ключове съществуваха и действието изпрати непълна заявка. Това изчерпа и единствения му опит за разговора.
Корекцията беше да се променят четирите условия за текстови полета на is true, като останалата настройка се запази. Повторете теста в нов разговор, като предоставите само имейл на втория ход. Действието трябва да изчака останалите данни за проекта.
| Състояние на теста | Събран контакт | Задължителните полета са готови | Получени заявки |
|---|---|---|---|
| Sam предоставя име | Да | Не | 0 |
| Sam предоставя само имейл | Да | Не | 0 |
| Sam предоставя пощенски код и тип проект | Да | Да | 1 |
| Sam добавя „следващата пролет“ | Да | Да | 1 |
Това е един наблюдаван разговор, а не процент на успех в продукционна среда. Възпроизведете го с нов разговор, прегледайте записаните полета след всеки ход и проверете заявката в собствената си крайна точка.
Реалното извикване на действието върна HTTP 201. Отворете подробностите му, за да прегледате заявката; записът по-долу показва какво е съхранил получателят.
Един реално съхранен запис от демонстрационния получател с удостоверяване. Това е запитване, а не потвърдена оферта или резервация.
Демонстрацията използва локален получател и отчете действителна HTTP доставка. Хостван Quickchat AI Агент се нуждае от публично достъпна HTTPS крайна точка; URL с localhost на компютъра ви не е достъпен от услугата.
Ако нищо не пристига, прегледайте View logs на действието и записаните метаданни на разговора. Липсващи стойности, изключено действие и HTTP грешка изискват различни корекции. Поправете конфигурацията и използвайте нов разговор, за да тествате автоматичното задействане отново; искането в същия чат за повторен опит не нулира единствения опит за разговор.
Защо чатботът липсва или показва стари настройки?
Проверете публикуваната страница, мястото на инсталиране и достъпа до Агента, преди да променяте промпта. Проблемът със зареждането в браузъра е отделен от проблема с качеството на отговорите.
| Симптом | Какво да прегледате | Какво да направите |
|---|---|---|
| Няма бутон за отваряне на публичната страница | Мястото на фрагмента и състоянието на публикуване | Поставете текущия фрагмент в общия футър/края на body, запазете и публикувайте |
| Уиджетът работи другаде, но не в HTML блок | Дали платформата създава iframe | Използвайте код за целия сайт за плаващия Widget; използвайте поддържания фрагмент Embed за подходящ вграден контейнер |
| Появява се грешният Агент | Scenario ID и дублирани инсталации | Копирайте ID от желания Агент и премахнете остарелите фрагменти или дублираните инсталации на плъгина |
| Бутонът отваря уиджета, но отговорите са неуспешни | Widget & Embed access, кредити и мрежови грешки в браузъра | Включете желания публичен канал, проверете лимита и прегледайте неуспешната заявка |
| Цвят или поздрав остава непроменен | Кеширана конфигурация или HTML на страницата | Изчакайте няколко минути, презаредете, след което изчистете съответния кеш на сайта, ако все още подава стар фрагмент |
| Няма имейл за нов контакт при тест | Източника на разговора и Email new leads | Preview и Simulation потискат имейлите; тествайте реален разговор в уиджета със собствени контролирани данни за контакт |
| Привидно пълно запитване никога не достига CRM | Съхранените полета, условията и дневника на действието | Проверете всеки задължителен ключ и HTTP резултата; използвайте нов разговор след поправяне на изпратена неуспешна заявка |
| Няма бутон за отваряне след смяна на темата | Дали новата тема включва инсталацията | Включете отново вграждането на приложението Shopify или възстановете фрагмента в новия общ шаблон |
| Отговор противоречи на източника | Импортираното съдържание и приложените промени в знанията | Поправете източника, завършете обработката/публикуването и повторете контролен въпрос с известен отговор |
Ако браузърът съобщава за блокиран ресурс, прегледайте точната грешка от Content Security Policy или блокиращото средство. Избягвайте цялостното изключване на защитите на сайта. Тествайте публичната страница през HTTPS и използвайте документацията на канала за необходимата настройка.
Колко струва чатбот за сайт?
Абонаментът и лимитът за използване покриват AI услугата; планът на сайта и незадължителните интеграции са отделни разходи.
| Употреба | Приложими ограничения на плана |
|---|---|
| Лично обучение с нетърговска цел | Free включва 50 AI кредита месечно и основните Widget, Smart Data Gathering, Human Handoff и Actions |
| Бизнес сайт | Starter позволява търговска употреба и включва 150 кредита месечно, от $9/месец |
| Персонализирани преводи на уиджета или гласово въвеждане | Налични при платените планове |
| Скриване на брандирането на Quickchat AI | Professional или по-висок план |
Един AI кредит не е един разговор. Разговорът може да съдържа няколко AI отговора, а различните модели могат да имат различна цена в кредити. Включете Preview и Simulation в бюджета за тестове. Използвайте текущите цени и лимити и ръководството за разходи за чатбот, за да оцените обема си.
Могат ли ChatGPT или Claude да помогнат с настройването на чатбота?
Връзката за управление на акаунт в Quickchat AI позволява на съвместим асистент да конфигурира поддържани настройки на Агента и да подготвя тестове от тези артефакти.
Свържете собствения си акаунт чрез Quickchat AI в ChatGPT или Quickchat AI в Claude, следвайки ръководството Manage with AI. Поддържаните инструменти обхващат знания, Main Prompt, начални въпроси, Human Handoff, HTTP действия, тестване и фрагмента за внедряване.
Завършете Smart Data Gathering и подробните настройки на Appearance за уиджета в таблото. Трябва също да разрешите достъпа до външни акаунти и да инсталирате фрагмента в настройките на сайта. Връзката с акаунта служи за управление на Агента ви; тя е отделна от предоставянето на Агент като MCP инструмент.
Копирайте заявка за настройване за вашия асистент
Use the Kestrel Kitchens website-chatbot kit to prepare a separate learning Agent. Do not change existing Agents. Set its name to Kestrel Kitchens, add knowledge.txt and set main-prompt.txt as Main Prompt. Configure the supported greeting, conversation starters and Human Handoff settings from the kit. Prepare the launch-test dataset with the supplied messages and criteria. Read back the saved configuration and return this Agent's current Widget snippet.
List the remaining dashboard steps for Smart Data Gathering, Appearance and website installation. Do not invent support for those settings. Leave the optional Send quote enquiry Action inactive until I provide my receiver URL and configure its credential. Before running tests or external writes, tell me the expected credit use and effects and obtain any approval required by this client. Do not claim that a website, email or CRM delivery works until it has been tested.
Често задавани въпроси
Как да добавя AI чатбот към сайта си?
Създайте Агент в Quickchat AI, добавете знания за бизнеса си, настройте Main Prompt, Smart Data Gathering и Human Handoff, след което инсталирайте неговия Widget чрез плъгин или предоставения фрагмент. Тествайте отговор въз основа на източник, събрани данни за контакт и доставен човешки отговор на публикувания сайт.
Мога ли да добавя персонализиран ChatGPT към сайта си?
Можете да добавите асистент в стил ChatGPT, обучен със собствените ви страници. Това ръководство внедрява Quickchat AI Агент чрез уиджета му за сайт, така че посетителите да могат да разговарят на сайта ви, без да влизат в ChatGPT. Знанията, инструкциите и интеграциите му се управляват в Quickchat AI.
Мога ли да добавя AI чатбот към сайта си безплатно?
Планът Free на Quickchat AI поддържа лично обучение с нетърговска цел и включва 50 AI кредита месечно. Фирмен сайт или внедряване за продажби и поддръжка на клиенти изисква план, който позволява търговска употреба. Абонаментите за платформата на сайта са отделни, а тестовете също използват AI кредити.
Трябва ли да пиша код или да предоставя API ключ?
Основната настройка използва настройки в таблото и плъгин, вграждане на приложение или предоставен скрипт. Фрагментът за сайта съдържа публичен Scenario ID, а не частен API ключ. Свързването на незадължително CRM действие изисква подходяща крайна точка и нейното удостоверяване; съхранявайте тези данни в настройките на действието.
Може ли чатбот за сайт да събира контакти и запитвания за оферти?
Да. Smart Data Gathering пита за избрани полета по време на разговора и ги записва в Inbox. Email new leads може да уведомява администраторите на Агента след събиране на имейл адрес или телефонен номер. API Action може да изпрати задължителните записани полета към настроен получател; само събрано име не означава пълно запитване.
Може ли човек да поеме чата?
Да. Настройте Human Handoff с работно време на екипа и съобщение извън него. В Inbox изберете Assign to me за невъзложен разговор или Take over, когато се показва този контрол, след което отговорете на посетителя. Reassign to AI връща разговора на Агента.
Работи ли с WordPress, Shopify, Squarespace, Wix и Webflow?
Всяка платформа има начин за инсталиране. Използвайте официалния WordPress плъгин, вграждането на приложението Shopify след свързване на Агента за магазина или подходящия фрагмент за футъра/края на body в целия сайт за съществуващ Агент. Правата за плъгини и изискванията към плановете за персонализиран код се различават според платформата.
Защо чатботът ми не се появява на сайта?
Проверете публикуваната страница, правилния Scenario ID и поставянето на фрагмента в края на тялото на страницата. Премахнете остарелите дублирани инсталации и избягвайте блокове с iframe за плаващия Widget. Ако се отваря, но не може да отговаря, проверете Widget & Embed access и наличните AI кредити.
Ще забави ли чатботът сайта ми?
Зареждащият код на уиджета се изтегля асинхронно, но все пак добавя JavaScript и мрежови заявки. Сравнете производителността при зареждане и взаимодействие преди и след инсталирането на представителни страници и на телефон. Асинхронното зареждане не доказва липса на влияние върху производителността.
Работи ли чатботът за сайт на телефони?
Отвореният уиджет използва оформление на цял екран под 768 CSS пиксела. Тествайте бутона за отваряне, клавиатурата, превъртането и контрола за затваряне на телефон. Оставете Auto-open Widget изключено, когато автоматичното отваряне би прекъснало разглеждането.
Може ли чатботът да отговаря на езиците на посетителите ми?
Агентът може да отговаря на езика на посетителя. Преводът на фиксирания поздрав, началните въпроси и етикетите на уиджета е отделна настройка при платените планове. Тествайте и фактите в отговора, и текста на интерфейса за всеки език, който възнамерявате да поддържате.