Documentação

Documentação

Como integrar o FlashAI com seu site

Início Rápido

Adicionar o FlashAI ao seu site leva apenas 3 passos.

1

Peça seu bot

Vá para flashai.pl, clique em "Pedir" e configure seu assistente de IA — nome, personalidade, base de conhecimento.

2

Cole o código

Adicione uma linha ao seu site, logo antes da tag de fechamento </body>:

HTML
<script src="https://flashai.pl/widget.js" data-ai="TWOJE_BOT_ID"></script>

Pronto!

O widget de chat aparecerá no canto inferior direito do seu site. Seu assistente de IA está pronto para conversar com os visitantes.

Configuração do Widget

Personalize o comportamento do widget usando atributos HTML na tag de script.

Atributo Descrição
data-ai (obrigatório) Seu ID do bot
data-name Nome de exibição no cabeçalho do chat
data-color Cor de destaque (hex)
data-auto-open Abrir chat automaticamente ao carregar a página
data-fullscreen Modo tela cheia
data-lang Forçar idioma da interface

Exemplo completo

HTML
<script src="https://flashai.pl/widget.js"
  data-ai="twoje_bot_id"
  data-name="Asystent Sklepu"
  data-color="#ff6b00"
  data-auto-open="true"></script>

API JavaScript

Controle o widget programaticamente a partir do código do seu site.

Método Descrição
FlashAI.open() Abre a janela de chat
FlashAI.close() Fecha a janela de chat
FlashAI.toggle() Alterna entre chat aberto/fechado
FlashAI.send("text") Envia uma mensagem imediatamente
FlashAI.setInput("text") Define o texto de entrada sem enviar
FlashAI.isOpen Verifica se o chat está aberto

Exemplos de uso

HTML
<!-- Button that opens the chat -->
<button onclick="FlashAI.open()">Chat with us</button>

<!-- Button that sends a specific question -->
<button onclick="FlashAI.send('I want to book an appointment')">Book now</button>

<!-- Link that pre-fills the input -->
<a href="#" onclick="FlashAI.open().setInput('Pricing')">Ask about pricing</a>

Abrindo chat via link

Adicione #flashai-open a qualquer URL e o chat abrirá automaticamente. Perfeito para códigos QR, links de e-mail ou botões.

URL
https://your-website.com/#flashai-open

Configuração Avançada

Para controle total, use o objeto de configuração JavaScript antes de carregar o script do widget.

HTML + JavaScript
<script>
window.FlashAI = {
  botId: "twoje_bot_id",
  config: {
    agentName: "Asystent",
    primaryColor: "#00f5ff",
    position: "bottom-right",
    languages: ["pl", "en"],
    trigger: {
      type: "delay",
      delay: 5
    },
    teaser: {
      enabled: true,
      delay: 3,
      message: "Hi! Need help?"
    }
  }
};
</script>
<script src="https://flashai.pl/widget.js"></script>

Tipos de Gatilho

"immediate" O widget aparece imediatamente
"delay" Aparece após segundos especificados
"scroll" Aparece após rolar % especificado
"engagement" Aparece após engajamento do usuário
"exit" Aparece na intenção de saída
"manual" Apenas via chamada de API

Precisa de ajuda?

Verifique nossa Referência de API ou junte-se à Comunidade.

Hi! 👋 I'm FlashAI. How can I help you boost your sales today?

FlashAI Assistant

Online

Powered by SymfoniX