landing-chatbot
Skill0 starsChanged 48 days agoMITView on GitHub
Use when a landing page or site needs an AI consultant, a chat widget, answers to visitor questions, an FAQ bot, or a way to catch visitors who are not ready to leave a phone — «чат-бот на сайт», «консультант с ИИ», «виджет чата», «бот отвечает на вопросы», «FAQ-бот», «онлайн-консультант». Works with the vibemarketolog MCP server (chatbot_* tools) or the Agent API (/chatbots).
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- llms.txtllms.txt
- ad-matchSkill
- brand-to-systemSkill
- design-systemSkill
- hypothesis-labSkill
- landing-abSkill
- landing-briefSkill
- landing-law-ruSkill
- landing-mediaSkill
- landing-mobileSkill
- motionSkill
- semanticsSkill
The file
Files
Чат-бот с ИИ на лендинге
Часть посетителей рекламы не готова оставить телефон, но готова спросить. Консультант с ИИ отвечает им по базе знаний страницы, зовёт живого оператора и забирает контакт. На лендинге для A/B-теста он ставится одинаково в обоих вариантах, иначе станет вторым отличием и испортит тест.
Главное правило
На странице — ТОЛЬКО наш консультант с ИИ (chatbot_create_site → chatbot_learn → chatbot_widget).
Самодельный «FAQ-бот» скриптом в HTML не ставь никогда: он не отвечает на свободный вопрос, не зовёт
человека, не забирает контакт в кабинет и Telegram, его разговоров никто не видит. Ответы нашего бота
платные по факту (от 2 ₽) — это НЕ повод заменить его самоделкой: такие траты идут после запуска, по
одной на вопрос посетителя, в бюджет сборки не входят и ограничены дневным лимитом подключения
(меняется на https://lk.vibemarketolog.ru/agent). Скажи это человеку одной строкой в смете.
Чек-лист «бот под ключ» — пройти ВСЁ
| Раздел | Что сделать | Где |
| Роль | instructions: кто он, границы, «цену заказа не называю — зову оставить телефон в форме», честное «не знаю» | chatbot_create_site |
| Приветствие | welcome — первое сообщение в окне: польза за 1 строку и вопрос | chatbot_create_site / chatbot_widget |
| Знания | FAQ, цены «от», условия, сроки — ИЗ СТРАНИЦЫ; сайт компании есть — chatbot_learn_site | chatbot_learn |
| Лицо | avatar — лицо консультанта (генерация портрета или маскота бренда, vm-gen:ID), logo + show_logo — логотип бренда в шапке окна (из brand_profile, по ссылке через upload_file) | chatbot_widget |
| Цвета | color и trigger_background — цвет главной кнопки стиля; trigger_foreground — её текст; шапка: header_color СВЕТЛЫЙ тон фона страницы с header_text_color = цвет текста стиля (тёмная шапка уходит в светлый градиент окна — быстрые вопросы становятся нечитаемы) | chatbot_widget |
| Напоминание | bubble — короткий вопрос-приглашение у кнопки до 80 знаков: «Подскажу цену за минуту», «Есть вопрос про подключение?» — виден, пока окно закрыто | chatbot_widget |
| Быстрые вопросы | quick_questions — 3–6 самых частых вопросов из FAQ страницы | chatbot_widget |
| Контакт | collect_contact: true (и collect_email, если продажа по почте); telegram_link / whatsapp_link / phone — реальные, если человек их дал | chatbot_widget |
| Место | position — противоположная липкой кнопке заявки на телефоне | chatbot_widget |
| Одинаково в A и Б | один embed_code в оба варианта; условия, которыми варианты различаются, в знания не класть | landing_update variant: both |
| Проверка | preview: 2–3 вопроса из FAQ и один «чужой»; chatbot_status — знания обучены | — |
Картинки бота — только свои: vm-gen:ID готовой генерации или адрес из upload_file; чужие ссылки
сервер отклонит. Бот уже стоит на запущенной странице — поменяй оформление chatbot_widget, код на
странице трогать не нужно: он подтягивает настройки сам.
Маршрут (MCP)
- Смета и согласие. Создать бота бесплатно. Платно: обучение (пункт FAQ или текст — 5 ₽, одна страница сайта — 10 ₽, весь сайт — 4 ₽ за каждую прочитанную страницу, до 30 страниц) и ответы посетителям (от 2 ₽ за ответ, по модели бота; у бота для сайта абонплаты нет). Назови цену до вызова и жди «да».
- Создать —
chatbot_create_site:title,instructions,welcome. Инструкция — это роль, границы и следующий шаг: «Ты консультант <компания>. Отвечай коротко, только по базе знаний. Цену конкретного заказа не называй — предложи <бесплатный замер/консультацию> и попроси оставить телефон в форме на странице. Не обещай того, чего нет в базе знаний». Для демо-страницы — честно «это демонстрационный бот». - Научить —
chatbot_learn: до 20 пунктов за вызов, парыquestion+content(или толькоcontentдля текста: цены, доставка, гарантия, противопоказания). Бери ИХ из страницы: блок вопросов, цены, условия — бот не должен знать больше, чем обещает лендинг. Можноdry_run: true— только смета. Сайт уже есть —chatbot_learn_site(url,whole_site). Обучение идёт сразу: знания попадают в ответы после вызова. - Вид и код —
chatbot_widgetпо чек-листу выше: лицо (avatar,logo), цвета стиля, напоминаниеbubble,quick_questions, контакты. Возвращаетembed_code— одну строку<script defer …>— иpreview(ссылка, где бота можно проверить сразу). - Вставить
embed_codeперед</body>вindex.htmlИ вb.html— одинаково. Наlanding_launchвиджет работает (страницы/w/*открыты для него, паспорт его скрипт пропускает). Проверь:landing_check→ ok. - Проверить — открой
preview, задай 2–3 вопроса из FAQ и один «чужой» (бот должен честно сказать, что не знает, и предложить оставить контакт). Потомchatbot_statusиchatbot_conversations— разговор виден. - Работа с диалогами —
chatbot_conversations: список, переписка (conversation_id), ответ посетителю от имени оператора (reply). Владелец получает уведомление в кабинет и Telegram, когда посетитель зовёт человека или оставляет почту с вопросом.
REST-двойники (Agent API, право write или chatbot)
POST /chatbots/site → POST /chatbots/{id}/knowledge (по одному пункту) → POST /chatbots/{id}/train
(без тела — векторы; с url и single — обучение по странице или сайту) → PATCH /chatbots/{id}/widget
→ GET /chatbots/{id}/embed. Диалоги: GET /chatbots/{id}/conversations[/{cid}], POST …/reply.
Статьи базы знаний (POST /chatbots/{id}/articles, бесплатно) видны посетителю во вкладке FAQ
виджета и сразу становятся знанием бота — он отвечает по ним без отдельного train. Для
коротких фактов (цены, адреса, часы) по-прежнему удобнее knowledge — по одному пункту.
Как бот дружит с A/B-тестом
- Виджет одинаковый в A и Б — это ось
fixed, а не гипотеза. - Бот нейтрален к оси теста: условия, которыми различаются варианты (оффер, цена, гарантия), в базу знаний НЕ клади. Иначе посетитель варианта A спросит бота и узнает оффер Б — тест тихо испортится. Про эти условия бот отвечает «подробности на странице и у менеджера» и зовёт оставить контакт.
- Хочешь проверить сам бот («с консультантом / без») — это отдельная гипотеза: вариант Б
с виджетом, A без, всё остальное одинаково. Итог смотри по заявкам с формы (
landing_status), а разговоры бота — отдельно (chatbot_conversations): это разные метрики. - Бот не заменяет форму: главная цель страницы — заявка. Инструкция бота всегда ведёт к форме.
Частые ошибки
- Обучили тексты, но не вызвали обучение — бот «ничего не знает» (MCP
chatbot_learnделает оба шага сам; в REST послеknowledgeобязателенtrain). - Бот знает больше страницы: обещает скидки и сроки, которых нет на лендинге — модерация рекламы и клиент увидят расхождение. База знаний = содержимое страницы.
- Разные виджеты в A и Б — тест сравнивает не то.
- Цвет виджета «на глаз» — бери цвет главной кнопки из токенов, чтобы кнопка чата не спорила с кнопкой заявки; позицию — противоположную липкой кнопке на телефоне.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

