Come aggiungere un widget agente IA al tuo sito

• Un agente Prostir pubblicato con channel runtime model esplicito, switch Channels dell'agente attivo e Model Usage Credits positivi per un modello hosted oppure una chiave BYOK salvata.
• L'origin pubblico esatto dove il widget girerà, per esempio https://example.com. Usa HTTPS, il subdomain giusto e non incollare un path tipo /pricing.
• Accesso al website builder, CMS, tag manager o template HTML dove puoi incollare un piccolo script prima di </body> o in un campo custom code globale.

Il pattern è semplice: pubblichi l'agente, crei il canale Web widget, premi Save, copi lo script, lo incolli nel sito e testi dall'origin permesso.

1. 01
   Crea l'agente IA in Prostir.

   Scrivi cosa deve fare il website agent, aggiungi pagine, FAQ, docs, pricing notes, support rules e tools. Scegli il modello prima di mostrarlo ai visitatori.

2. 02
   Pubblica l'agente.

   Il website widget usa il published agent runtime. Se l'agente è ancora solo draft, l'embed script non può servire un website chatbot pubblico affidabile.

3. 03
   Apri Channels e scegli Web widget.

   Attiva lo switch Channels dell'agente e scegli Web widget. Non serve un token esterno, ma il canale resta disattivato finché i controlli runtime non passano.

4. 04
   Aggiungi allowed origins.

   Aggiungi ogni origin HTTPS esatto dove il widget può girare, come https://example.com e https://www.example.com. Prostir blocca origins esterni non elencati, così un altro sito non può riusare il tuo script.

5. 05
   Progetta il chat widget.

   Imposta position, width, height, colors, greeting text, intro text, input placeholder, launcher label e quick actions. Le prime azioni suggerite devono seguire le domande reali: pricing, booking, support, order status o product fit.

6. 06
   Premi Save.

   Save salva le impostazioni e attiva il Web widget solo se superano i controlli su pubblicazione, runtime model esplicito, switch Channels dell'agente, allowed origins, configurazione e crediti hosted o BYOK. Altrimenti resta disattivato con un errore visibile.

7. 07
   Copia l'embed script.

   Copia il widgetEmbedUrl restituito. Usa sempre lo slug pubblicato e il channel id esatto: https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}.

8. 08
   Incolla lo script nel sito.

   Per un sito scritto a mano, incollalo prima di </body>. In Webflow, WordPress, Shopify, Wix, Squarespace, Framer o un altro builder, usa custom code globale, embed code o custom HTML.

9. 09
   Testa dal sito live.

   Apri il dominio permesso reale, non un preview URL a caso. Fai una domanda vera, controlla la risposta e conferma che la conversazione appaia in Channels.

Un buon website AI agent è più di una bolla di chat.

Channels, Web widget, allowed origins, Save.

• Usa il dominio reale inserito negli allowed origins. Se testi da un preview origin diverso, il widget può fail closed per design.
• Fai le domande che farebbe un lead: price, availability, next step, fit, support, refund o implementation time.
• Se la risposta è debole, aggiorna instructions o knowledge in Prostir, pubblica di nuovo e l'embedded widget userà l'agente migliorato senza rebuild del sito.