Prostir

Практичний гайд

Як додати AI-агента з віджетом на свій сайт

Покрокова стаття: як додати AI-агента з віджетом на свій сайт. Ти створюєш і публікуєш агента Prostir, відкриваєш Channels, обираєш Web widget, додаєш точний HTTPS allowed origin свого сайту, налаштовуєш chat widget, тиснеш Save, копіюєш embed script, вставляєш його на сайт і тестуєш website chatbot з живої сторінки.

01

Що потрібно перед стартом

  • Опублікований AI-агент Prostir із явно вибраною channel runtime model, увімкненим перемикачем Channels на рівні агента та або позитивним балансом Model Usage Credits для hosted model, або збереженим BYOK-ключем.
  • Точний public origin сайту, де працюватиме віджет, наприклад https://example.com. Використовуй HTTPS, правильний subdomain і не вставляй path на кшталт /pricing.
  • Доступ до website builder, CMS, tag manager або HTML template, де можна вставити маленький script перед </body> або в site-wide custom-code поле.
02

Як додати AI-агента з віджетом

Патерн простий: публікуєш агента, створюєш Web widget channel, тиснеш Save, копіюєш script, вставляєш на сайт і тестуєш із allowed origin.

  1. 01
    Створи AI-агента в Prostir.

    Опиши, що website agent має робити, додай сторінки, FAQ, docs, pricing notes, support rules і tools, якими він може користуватись. Обери модель до того, як показувати його відвідувачам.

  2. 02
    Опублікуй агента.

    Website widget використовує published agent runtime. Якщо агент лишається draft-only, embed script не може стабільно працювати як public website chatbot.

  3. 03
    Відкрий Channels і обери Web widget.

    На рівні агента ввімкни перемикач Channels і вибери Web widget. Сторонній token не потрібен, але канал лишається disabled, доки runtime-перевірки не пройдені.

  4. 04
    Додай allowed origins.

    Додай кожен точний HTTPS origin, де може працювати віджет, наприклад https://example.com і https://www.example.com. Prostir блокує не вказані external origins, щоб інший сайт не використав твій widget script.

  5. 05
    Налаштуй chat widget.

    Задай position, width, height, colors, greeting text, intro text, input placeholder, launcher label і quick actions. Перші suggested actions мають бути близькі до реальних питань відвідувачів: pricing, booking, support, order status або product fit.

  6. 06
    Натисни Save.

    Save зберігає налаштування й вмикає Web widget лише після успішних перевірок publication, explicit runtime model, agent-level Channels switch, allowed origins, конфігурації та hosted credits або BYOK. Інакше канал лишається disabled із видимою помилкою.

  7. 07
    Скопіюй embed script.

    Скопіюй повернений widgetEmbedUrl. Він завжди містить published slug і точний channel id: https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}.

  8. 08
    Встав script на сайт.

    Для hand-coded сайту встав його перед </body>. У Webflow, WordPress, Shopify, Wix, Squarespace, Framer або іншому builder використовуй site-wide custom code, embed code або custom HTML area.

  9. 09
    Протестуй із live site.

    Відкрий реальний allowed domain, не випадковий preview URL. Постав реальне питання, перевір відповідь і переконайся, що діалог з'явився в Channels.

03

Що підготувати перед Save

Хороший website AI agent - це не тільки launcher bubble.

docagent instructionsНа що віджет відповідає, що має відмовлятись робити і коли просити людину.
docwebsite knowledgePricing, services, FAQs, docs, policies, booking details, support rules і source pages.
codeembed scriptОднорядковий script із Prostir: <script src="https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}" async></script>.
04

Фінальний крок у Prostir: Web widget, Save, script

Channels, Web widget, allowed origins, Save.

Prostir Studio

Я опублікував support agent і хочу поставити його на сайт як AI chatbot widget.

Відкрий агента в Prostir, перейди в Channels, обери Web widget і додай точний HTTPS origin свого сайту.

Віджет має бути bottom-right і починати з питань про pricing, booking і support.

Задай position, launcher label, greeting text, quick actions і colors. Натисни Save, потім скопіюй embed script.

Prostir

Web widget збережено. Канал увімкнено лише після всіх runtime-перевірок; інакше він лишається disabled із видимою помилкою.

Live

Website chatbot connected · embed script copied · діалоги видно в Channels

05

Протестуй віджет на сайті

  • Використовуй реальний domain зі списку allowed origins. Якщо тестуєш з іншого preview origin, widget може fail closed за дизайном.
  • Постав ті самі питання, які поставить lead: price, availability, next step, fit, support, refund або implementation time.
  • Якщо відповідь слабка, онови instructions або knowledge в Prostir, опублікуй ще раз, і embedded widget підхопить кращого агента без перебілду сайту.

Що публікуєш

У фіналі твій сайт завантажує AI-агента Prostir через widget embed script. Відвідувачі відкривають chat widget, ставлять питання, а той самий опублікований агент відповідає зі своїх instructions, knowledge, tools, model і channel settings.

Рішення

ШІ-агент з продажів для сайту, який веде до зрозумілого кроку

Вбудуй контрольований Agent web widget, передавай лише безпечний контекст сторінки й показуй відповідь, tool activity, approval cards та потрібний CTA.

Рішення

Сплануй першу розмову на своєму сайті

Дай сторінку, типові заперечення й бажаний наступний крок. Ми допоможемо скласти контрольований website Agent.