Prostir

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

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

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

Перед читанням

Що публікуєш

У фіналі сайт завантажує AI-агента Prostir через скрипт вбудовування. Відвідувачі відкривають віджет чату й ставлять запитання, а той самий опублікований агент відповідає за своїми інструкціями, знаннями, інструментами, моделлю та налаштуваннями каналу.

Кому підходить

Для засновників, агенцій, креаторів, SaaS-команд, консультантів і команд підтримки, які хочуть AI-агента або віджет AI-чатбота на сайті без власного бекенда, API-ключів у браузері й окремої чат-системи.

Де відбувається робота

AI-агент на сайті · Віджет AI-чатбота · Чатбот для сайту · Віджет чату

01

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

  • Опублікований AI-агент Prostir із явно вибраною моделлю виконання каналу, увімкненим перемикачем Channels на рівні агента та позитивним балансом Model Usage Credits для хостованої моделі або збереженим BYOK-ключем.
  • Точний публічний origin сайту, де працюватиме віджет, наприклад https://example.com. Використовуй HTTPS, правильний піддомен і не додавай шлях на кшталт /pricing.
  • Доступ до конструктора сайту, CMS, менеджера тегів або HTML-шаблону, де можна вставити невеликий скрипт перед </body> чи в глобальне поле власного коду.
02

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

Схема проста: опублікуй агента, створи канал Web widget, натисни Save, скопіюй скрипт, встав його на сайт і протестуй із дозволеного origin.

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

    Опиши, що агент на сайті має робити, додай сторінки, FAQ, документацію, примітки про ціни, правила підтримки й дозволені інструменти. Обери модель до того, як показувати агента відвідувачам.

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

    Віджет використовує середовище виконання опублікованого агента. Якщо агент існує лише як чернетка, скрипт вбудовування не може надійно обслуговувати публічний чатбот на сайті.

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

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

  4. 04
    Додай allowed origins.

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

  5. 05
    Налаштуй віджет чату.

    Задай позицію, ширину, висоту, кольори, привітання, вступ, підказку в полі вводу, підпис кнопки й швидкі дії. Перші запропоновані дії мають відповідати реальним питанням: ціна, бронювання, підтримка, статус замовлення або відповідність продукту.

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

    Save зберігає налаштування й вмикає Web widget лише після перевірок публікації, явно вибраної моделі, перемикача Channels, allowed origins, конфігурації та хостованих кредитів або BYOK. Інакше канал лишається вимкненим із видимою помилкою.

  7. 07
    Скопіюй скрипт вбудовування.

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

  8. 08
    Встав скрипт на сайт.

    Для сайту з власним HTML встав його перед </body>. У Webflow, WordPress, Shopify, Wix, Squarespace, Framer або іншому конструкторі використовуй глобальний власний код, код вбудовування чи поле власного HTML.

  9. 09
    Протестуй із живого сайту.

    Відкрий справжній дозволений домен, а не випадкову preview-адресу. Постав реальне запитання, перевір відповідь і переконайся, що діалог з'явився в Channels.

03

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

Хороший AI-агент на сайті — це не лише кнопка запуску чату.

  • docінструкції агентаНа що віджет відповідає, що має відмовлятися робити й коли просити про допомогу людини.
  • docзнання для сайтуЦіни, послуги, FAQ, документація, правила, умови бронювання, правила підтримки й сторінки-джерела.
  • codeскрипт вбудовуванняОднорядковий скрипт із Prostir: <script src="https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}" async></script>.
04

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

Відкрий Channels, обери Web widget, додай дозволені адреси й натисни Save.

Відкрий Channels, обери Web widget, додай дозволені адреси й натисни Save.

Prostir Studio

Я опублікував агента підтримки й хочу додати його на сайт як віджет AI-чатбота.

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

Віджет має бути внизу праворуч і починати з питань про ціни, бронювання та підтримку.

Задай позицію, підпис кнопки, привітання, швидкі дії й кольори. Натисни Save, а потім скопіюй скрипт вбудовування.

Prostir

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

Активний

Чатбот на сайті підключено · скрипт вбудовування скопійовано · діалоги видно в Channels

05

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

  • Використовуй реальний домен зі списку allowed origins. Якщо тестуєш з іншого preview-origin, віджет за задумом може відхилити запит.
  • Постав ті самі запитання, які поставить потенційний клієнт: про ціну, наявність, наступний крок, відповідність, підтримку, повернення коштів або строк упровадження.
  • Якщо відповідь слабка, онови інструкції чи знання в Prostir, опублікуй агента ще раз — і вбудований віджет підхопить покращення без перебудови сайту.

Рішення

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

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

Рішення

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

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