Prostir

Praxisleitfaden

So fügst du ein KI-Agenten-Widget zu deiner Website hinzu

Schritt-für-Schritt-Artikel: So fügst du ein KI-Agenten-Widget zu deiner Website hinzu. Du erstellst und veröffentlichst den Prostir-Agenten, öffnest Channels, wählst Web widget, fügst den exakten HTTPS-Origin deiner Website hinzu, gestaltest das Chat Widget, drückst Save, kopierst das Embed Script, fügst es auf deiner Website ein und testest den Website Chatbot auf der Live-Seite.

01

Was du vor dem Start brauchst

  • Einen veröffentlichten Prostir-Agenten mit explizitem Channel-Runtime-Modell, aktiviertem Channels-Schalter auf Agent-Ebene und positiven Model Usage Credits für ein Hosted-Modell oder einem gespeicherten BYOK-Key.
  • Den exakten öffentlichen Origin, auf dem das Widget laufen soll, zum Beispiel https://example.com. Nutze HTTPS, die richtige Subdomain und keinen Pfad wie /pricing.
  • Zugriff auf Website Builder, CMS, Tag Manager oder HTML Template, wo du ein kleines Script vor </body> oder in ein globales Custom-Code-Feld einfügst.
02

So fügst du das KI-Agenten-Widget hinzu

Das Muster ist einfach: Agent veröffentlichen, Web widget Channel erstellen, Save drücken, Script kopieren, auf der Website einfügen und vom erlaubten Origin testen.

  1. 01
    Erstelle den KI-Agenten in Prostir.

    Beschreibe, was der website agent tun soll, und füge Seiten, FAQs, docs, pricing notes, support rules und tools hinzu. Wähle das Modell, bevor Besucher ihn sehen.

  2. 02
    Veröffentliche den Agenten.

    Das website widget nutzt den published agent runtime. Wenn der Agent nur draft ist, kann das embed script keinen zuverlässigen öffentlichen website chatbot ausliefern.

  3. 03
    Öffne Channels und wähle Web widget.

    Aktiviere den Channels-Schalter des Agenten und wähle Web widget. Ein externer Token ist nicht nötig, aber der Channel bleibt deaktiviert, bis die Runtime-Prüfungen bestehen.

  4. 04
    Füge allowed origins hinzu.

    Füge jeden exakten HTTPS-Origin hinzu, auf dem das Widget laufen darf, etwa https://example.com und https://www.example.com. Prostir blockiert nicht gelistete externe Origins, damit keine andere Website dein Widget Script wiederverwendet.

  5. 05
    Gestalte das Chat Widget.

    Setze position, width, height, colors, greeting text, intro text, input placeholder, launcher label und quick actions. Die ersten Vorschläge sollten zu echten Fragen passen: pricing, booking, support, order status oder product fit.

  6. 06
    Drücke Save.

    Save speichert die Einstellungen und aktiviert das Web widget nur nach erfolgreichen Prüfungen von Veröffentlichung, explizitem Runtime-Modell, Channels-Schalter des Agenten, allowed origins, Konfiguration und Hosted-Credits oder BYOK. Sonst bleibt es mit sichtbarem Fehler deaktiviert.

  7. 07
    Kopiere das Embed Script.

    Kopiere die zurückgegebene widgetEmbedUrl. Sie nutzt immer den veröffentlichten Slug und die exakte channel id: https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}.

  8. 08
    Füge das Script auf deiner Website ein.

    Bei einer handgeschriebenen Website fügst du es vor </body> ein. In Webflow, WordPress, Shopify, Wix, Squarespace, Framer oder einem anderen Builder nutzt du global custom code, embed code oder custom HTML.

  9. 09
    Teste von der Live-Website.

    Öffne die echte erlaubte Domain, nicht irgendeine Preview URL. Stelle eine echte Frage, prüfe die Antwort und bestätige, dass das Gespräch in Channels erscheint.

03

Was du vor Save vorbereitest

Ein guter website AI agent ist mehr als eine Chat-Blase.

docagent instructionsWas das Widget beantwortet, was es ablehnt und wann ein Mensch übernehmen soll.
docwebsite knowledgePricing, services, FAQs, docs, policies, booking details, support rules und source pages.
codeembed scriptDas einzeilige Script aus Prostir: <script src="https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}" async></script>.
04

Letzter Schritt in Prostir: Web widget, Save, Script

Channels, Web widget, allowed origins, Save.

Prostir Studio

Ich habe meinen support agent veröffentlicht und will ihn als AI chatbot widget auf meine Website setzen.

Öffne den Agenten in Prostir, gehe zu Channels, wähle Web widget und füge den exakten HTTPS-Origin deiner Website hinzu.

Das Widget soll unten rechts erscheinen und mit Fragen zu pricing, booking und support starten.

Setze position, launcher label, greeting text, quick actions und colors. Drücke Save und kopiere dann das embed script.

Prostir

Web widget gespeichert. Der Channel wird erst nach allen Runtime-Prüfungen aktiviert; sonst bleibt er mit sichtbarem Fehler deaktiviert.

Live

Website chatbot connected · embed script copied · Gespräche sichtbar in Channels

05

Teste das Widget auf der Website

  • Nutze die echte Domain aus allowed origins. Wenn du von einem anderen Preview Origin testest, kann das Widget absichtlich fail closed gehen.
  • Stelle Fragen, die ein Lead stellen würde: price, availability, next step, fit, support, refund oder implementation time.
  • Wenn die Antwort schwach ist, aktualisiere instructions oder knowledge in Prostir, veröffentliche erneut, und das eingebettete Widget übernimmt den verbesserten Agenten ohne Website-Rebuild.

Was veröffentlicht wird

Am Ende lädt deine Website einen Prostir-KI-Agenten über das Widget Embed Script. Besucher öffnen das Chat Widget, stellen Fragen, und derselbe veröffentlichte Agent antwortet aus instructions, knowledge, tools, Modell und Channel-Einstellungen.

Lösungen

KI-Verkaufsagent für Websites mit einem klaren nächsten Schritt

Bette ein kontrolliertes Agent Web Widget ein, übergib nur sicheren Seitenkontext und zeig Antwort, Tool Activity, Approval Cards und passenden CTA.

Lösungen

Das erste Website-Gespräch planen

Nenn Seite, typische Einwände und gewünschte nächste Aktion. Wir helfen bei einem kontrollierten Website Agent.