Como adicionar um widget de agente IA ao seu site

• Um agente Prostir publicado com channel runtime model explícito, o switch Channels do agente ligado e Model Usage Credits positivos para modelo hospedado ou uma chave BYOK salva.
• O origin público exato onde o widget vai rodar, por exemplo https://example.com. Use HTTPS, o subdomínio correto e não cole um caminho como /pricing.
• Acesso ao website builder, CMS, tag manager ou template HTML onde você pode colar um script pequeno antes de </body> ou em um campo de custom code global.

O padrão é simples: publique o agente, crie o canal Web widget, aperte Save, copie o script, cole no site e teste a partir do origin permitido.

1. 01
   Crie o agente IA no Prostir.

   Escreva o que o website agent deve fazer, adicione páginas, FAQs, docs, pricing notes, support rules e tools. Escolha o modelo antes de expor a visitantes.

2. 02
   Publique o agente.

   O website widget usa o published agent runtime. Se o agente estiver só em draft, o embed script não consegue servir um website chatbot público confiável.

3. 03
   Abra Channels e escolha Web widget.

   Ligue o switch Channels no agente e selecione Web widget. Não é necessário token externo, mas o canal fica desativado até passar nas verificações de runtime.

4. 04
   Adicione allowed origins.

   Adicione cada origin HTTPS exato onde o widget pode rodar, como https://example.com e https://www.example.com. O Prostir bloqueia origins externos fora da lista para outro site não reutilizar seu script.

5. 05
   Desenhe o chat widget.

   Configure position, width, height, colors, greeting text, intro text, input placeholder, launcher label e quick actions. As primeiras ações sugeridas devem refletir perguntas reais: pricing, booking, support, order status ou product fit.

6. 06
   Aperte Save.

   Save guarda as configurações e ativa o Web widget somente quando passam as verificações de publicação, runtime model explícito, switch Channels do agente, allowed origins, configuração e créditos hospedados ou BYOK. Caso contrário, fica desativado com erro visível.

7. 07
   Copie o embed script.

   Copie o widgetEmbedUrl retornado. Ele sempre usa o slug publicado e o channel id exato: https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}.

8. 08
   Cole o script no site.

   Em um site com HTML próprio, cole antes de </body>. Em Webflow, WordPress, Shopify, Wix, Squarespace, Framer ou outro builder, use custom code global, embed code ou custom HTML.

9. 09
   Teste no site real.

   Abra o domínio permitido real, não um preview URL qualquer. Faça uma pergunta real, revise a resposta e confirme que a conversa aparece em Channels.

Um bom website AI agent é mais do que uma bolha de chat.

Channels, Web widget, allowed origins, Save.

• Use o domínio real listado em allowed origins. Se testar de outro preview origin, o widget pode fail closed por design.
• Pergunte o que um lead perguntaria: price, availability, next step, fit, support, refund ou implementation time.
• Se a resposta estiver fraca, atualize instructions ou knowledge no Prostir, publique de novo e o widget incorporado usa o agente melhorado sem rebuild do site.