Вы можете добавить AI-чатбота на свой сайт, загрузив в Агента информацию о компании, настроив ответы и установив виджет чата с помощью плагина или готового скрипта. Чатбот для сайта Quickchat AI объединяет знания, настройки разговора и командный Inbox. Посетители задают вопросы на вашем сайте без создания аккаунта.
В этом руководстве мы создадим чатбота для Kestrel Kitchens, вымышленной компании по проектированию кухонь. Посетитель спрашивает, сколько длится ремонт, уточняет ориентировочную стоимость кухни размером 3 на 4 метра, затем запрашивает расчёт. Агент отвечает на основе информации компании, собирает данные о проекте и позволяет дизайнеру продолжить разговор.
Готовый сценарий на сайте. Kestrel Kitchens и сведения о компании вымышлены; виджет и его ответы работают через настоящее локальное приложение.
Для базовой настройки программирование не требуется. Настройте знания и инструкции, сбор заявок и передачу человеку, затем установите виджет. Необязательное действие API Action отправляет полные заявки в другую систему.
Скачайте комплект настройки Kestrel Kitchens с примером сайта, знаниями, Main Prompt, настройками и тестовыми сообщениями. Это редактируемые файлы для настройки через панель, а не импорт Агента одним нажатием. Скриншоты и копируемые материалы комплекта, промпт и конфигурация остаются на английском, чтобы можно было воспроизвести проверенный пример.
Что будет делать чатбот на сайте?
Чатбот отвечает на вопросы по вашим материалам, сохраняет данные для запрошенного обратного контакта и передаёт разговоры команде, когда нужен человек.
Каждый из этих результатов нужно подтверждать отдельно. Правильный диапазон цен берётся из Knowledge Base. Для заявки на расчёт в Inbox должны быть контактные данные и сведения о проекте. Для передачи разговора человек должен взять его на себя и отправить ответ, который дойдёт до посетителя.
Путь посетителя в примере. Заявка на расчёт фиксирует интерес; цену и доступность по-прежнему подтверждает дизайнер.
| Вопрос посетителя | Задача Агента | Что проверить |
|---|---|---|
| Сколько длится ремонт? | Объяснить опубликованные сроки проектирования и монтажа | Ответ сохраняет условия, от которых зависят эти сроки |
| Сколько стоит кухня размером 3 на 4 метра? | Назвать ориентировочный диапазон и объяснить, что выясняется при обследовании объекта | Нет выдуманной фиксированной цены или цены за квадратный метр |
| Можно запросить расчёт стоимости? | Собрать имя, email, почтовый индекс и тип проекта | Поля появляются в сохранённых данных разговора |
| Предлагаете ли вы финансирование? | Признать, что в загруженных знаниях этого не указано | Нет выдуманного предложения финансирования |
| Можно поговорить с дизайнером? | Использовать Human Handoff с учётом рабочих часов команды | Дизайнер может ответить из Inbox, и посетитель получает ответ |
Что нужно перед добавлением чатбота?
Вам понадобятся аккаунт Quickchat AI, проверяемая информация о компании и доступ к настройкам плагинов или пользовательского кода сайта.
- Создайте аккаунт Quickchat AI и завершите регистрацию. Используйте отдельного Агента для этого упражнения, чтобы вымышленные сведения не повлияли на действующую службу поддержки.
- Подготовьте страницы услуг, FAQ и правила либо используйте вымышленные знания из комплекта. Перед внедрением для реального бизнеса замените вымышленные цены и территорию обслуживания.
- Убедитесь, что тариф сайта допускает нужный способ установки. Для 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. При импорте сайта просмотрите найденные страницы и выберите страницы услуг, цен, процесса работы и FAQ, которые должны служить источниками ответов.
- Проверьте импортированный текст. Убедитесь, что в ценах верно указаны валюта и налоги, а старые акции и посторонние страницы не попали в источники.
- Дождитесь завершения обработки. Перед проверкой установленного виджета примените или опубликуйте все ожидающие изменения знаний, которые показывает панель.
Начните с нескольких понятных страниц. На сайте может быть привлекательная карточка с ценой, а её условия могут находиться в другом месте; Агенту нужно и то и другое. Если импортировать только главную страницу, можно упустить условия монтажа, географические ограничения или правила возврата, без которых ответ будет неполным.
Используйте источник 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 запрашивает выбранную информацию во время разговора и сохраняет данные посетителя. Для заявки на расчёт собирайте только то, что нужно дизайнеру для обратной связи.
Здесь включают и редактируют встроенные Actions. В примере карточка 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 |
Вопросы описывают информацию, которую нужно собрать. Настройки времени и стиля задают, когда спрашивать; проверьте и сам разговор.
Имя, email, почтовый индекс и тип проекта обязательны для полной заявки в этом примере. Желаемый срок необязателен, как объясняется в Main Prompt. Это бизнес-требование существует отдельно от настроек сбора в разговоре; на шаге 8 проверяются обязательные поля перед отправкой запроса в CRM.
Агент должен отвечать на общий вопрос о стоимости, не требуя email в качестве условия для ответа. Посетитель также может отказаться от сбора данных. Используйте I am only researching. I do not want to leave contact details., чтобы проверить, что разговор остаётся полезным без повторных запросов.
Куда попадают собранные данные?
Откройте разговор в Inbox. Стандартные контактные данные появляются в полях посетителя; остальные собранные значения остаются прикреплёнными к разговору и доступны для экспорта через Export Gathered Data.
Посетитель сообщает контактные данные и сведения о проекте в чате.
Сохранённые поля подтверждают сбор данных. Сравните каждое значение с тем, что сообщил посетитель.
В Where to send data настройка Email new leads уведомляет каждого администратора Агента, когда впервые собран email или номер телефона. Одно имя не запускает отправку письма. Preview и Simulation не отправляют эти уведомления, поэтому, прежде чем полагаться на доставку email, проверьте собственный почтовый ящик администратора контролируемым тестом установленного виджета. В локальном примере доставка внешних писем отключена.
В документации 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.
В пошаговом руководстве по передаче диалога от чат-бота человеку отдельно проверяются назначение ответственного за разговор, возврат к ИИ и сбои вне рабочих часов.
Шаг 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. Подпись доступна для маленькой кнопки. Проверьте расположение рядом с баннером cookie и другими плавающими элементами сайта. - Оставьте 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. |
Conversation starters должны начинать полезные сценарии. Дисклеймер объясняет посетителям, какие решения по-прежнему принимает дизайнер.
Агент может отвечать на языке посетителя. Перевод фиксированного приветствия и подписей виджета настраивается отдельно в Other languages и доступен на платных планах. Для многоязычного сайта проверяйте и ответ, и фиксированный текст интерфейса; в руководстве по многоязычным чатботам объясняется это различие.
Изменения внешнего вида могут доходить до кешированных сессий посетителей несколько минут. Перезагрузите страницу, прежде чем решать, что сохранённое изменение не применилось. Hide Quickchat AI Branding требует плана Professional или выше; в руководстве по white label разобраны другие места, которые нужно проверить.
Шаг 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
- В панели сайта откройте 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, затем сохраните и проверьте витрину. Перед редактированием сделайте резервную копию темы, а после смены темы повторно проверьте установку. Этот способ отображает выбранного Агента; он не настраивает Actions для товаров или заказов.
Для Агента, ориентированного на магазин, настройка приложения Quickchat AI для Shopify подключает магазин через отдельный процесс первоначальной настройки. После подключения используйте Enable Widget in Shopify Theme Editor либо откройте Online Store → Themes → Edit theme → App embeds. Включите Quickchat AI Widget и сохраните. Документация Shopify по app embed объясняет элементы управления темы; при смене опубликованной темы включите встраивание приложения заново.
Указанные выше пути в конструкторах сверены с официальной документацией. Скриншоты показывают сайт-пример 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. | Сохранить указанные email, почтовый индекс и тип проекта | Поля 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 не доказывает, что путь поддержки человеком работает. Повторяйте небольшой набор этих проверок после изменения источников, промптов, Actions или темы сайта.
Шаг 8. Как отправить полную заявку в CRM?
Необязательное действие API Action может отправить сохранённые поля HTTP-сервису после того, как в разговоре собрана вся обязательная информация. Базовый чатбот для сайта уже пригоден к использованию без этого расширения.
Нужно различать сохранение контакта и полноту заявки. Quickchat AI устанавливает lead_captured, когда впервые сохраняет стандартное контактное поле, в том числе имя. Сам флаг не подтверждает наличие email, почтового индекса или типа проекта.
Платформа проверяет каждое условие. Модель собирает информацию; условия определяют, когда запрос можно отправить.
Подготовьте принимающий сервис
Используйте контролируемый вами эндпоинт 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-адрес/enquiriesсвоего принимающего сервиса. - Добавьте заголовки, тело и условия ниже, затем сохраните и активируйте действие.
| Заголовки: ключ | Значение |
|---|---|
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 их приняла. Проверяйте доставку в журнале действия и принимающем сервисе. Это поведение описано в документации автоматических Actions.
Проверьте частичные данные, затем полную заявку
В первой версии для обязательных текстовых полей использовалось exists. Sam Taylor сообщил имя, затем email в следующем сообщении. Smart Data Gathering уже создал пустые значения почтового индекса и типа проекта, поэтому ключи существовали и действие отправило неполный запрос. При этом была израсходована единственная попытка для разговора.
Исправление состояло в замене условий четырёх текстовых полей на is true без изменения остальной настройки. Повторите тест в новом разговоре, указав во втором сообщении только email. Действие должно дождаться оставшихся сведений о проекте.
| Состояние теста | Контакт сохранён | Обязательные поля готовы | Получено запросов |
|---|---|---|---|
| Sam Taylor сообщает имя | Да | Нет | 0 |
| Sam Taylor сообщает только email | Да | Нет | 0 |
| Sam Taylor сообщает почтовый индекс и тип проекта | Да | Да | 1 |
| Sam Taylor добавляет «следующей весной» | Да | Да | 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/месяц |
| Пользовательские переводы виджета или голосовой ввод | Доступны на платных планах |
| Hide Quickchat AI Branding | Professional или выше |
AI-кредит не равен разговору. В разговоре может быть несколько ответов AI, а разные модели могут расходовать разное количество кредитов. Включите Preview и Simulation в бюджет тестирования. Используйте актуальные цены и лимиты и руководство по стоимости чатбота, чтобы оценить свой объём.
Могут ли ChatGPT или Claude помочь настроить чатбота?
Подключение для управления аккаунтом Quickchat AI позволяет совместимому ассистенту настроить поддерживаемые параметры Агента и подготовить тесты по этим материалам.
Подключите собственный аккаунт через Quickchat AI в ChatGPT или Quickchat AI в Claude, следуя руководству Manage with AI. Поддерживаемые инструменты охватывают знания, Main Prompt, Conversation starters, Human Handoff, HTTP Actions, тестирование и код установки.
Завершите настройку 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 Action нужен подходящий эндпоинт и его аутентификация; храните эти учётные данные в настройках действия.
Может ли чатбот на сайте собирать лиды и заявки на расчёт стоимости?
Да. Smart Data Gathering запрашивает выбранные поля во время разговора и сохраняет их в Inbox. Email new leads может уведомлять администраторов Агента после сохранения email или номера телефона. 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 выключенным, если автоматическое открытие мешает просмотру сайта.
Может ли чатбот отвечать на языках посетителей?
Агент может отвечать на языке посетителя. Перевод фиксированного приветствия, начальных вопросов и подписей виджета настраивается отдельно на платном плане. Для каждого языка, который вы собираетесь поддерживать, проверяйте и факты в ответе, и текст интерфейса.