Documentazione

Documentazione

Come integrare Flash AI con il tuo sito web

Avvio rapido

Aggiungere Flash AI al tuo sito web richiede solo 3 passaggi.

1

Ordina il tuo bot

Vai su flashai.pl, clicca "Ordina" e configura il tuo assistente AI — nome, personalità, base di conoscenza.

2

Incolla il codice

Aggiungi una riga al tuo sito web, proprio prima del tag di chiusura </body>:

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

Fatto!

Il widget di chat apparirà nell'angolo in basso a destra del tuo sito web. Il tuo assistente AI è pronto per parlare con i visitatori.

Configurazione widget

Personalizza il comportamento del widget utilizzando gli attributi HTML sul tag script.

Attributo Descrizione
data-ai (richiesto) Il tuo ID bot
data-name Nome visualizzato nell'intestazione della chat
data-color Colore di accento (hex)
data-auto-open Apertura automatica della chat al caricamento della pagina
data-fullscreen Modalità schermo intero
data-lang Forza lingua dell'interfaccia

Esempio 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>

JavaScript API

Controlla il widget in modo programmatico dal codice del tuo sito web.

Metodo Descrizione
FlashAI.open() Apre la finestra di chat
FlashAI.close() Chiude la finestra di chat
FlashAI.toggle() Attiva/disattiva chat aperta/chiusa
FlashAI.send("text") Invia un messaggio immediatamente
FlashAI.setInput("text") Imposta il testo di input senza inviare
FlashAI.isOpen Controlla se la chat è aperta

Esempi di utilizzo

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>

Apertura chat tramite link

Aggiungi #flashai-open a qualsiasi URL e la chat si aprirà automaticamente. Perfetto per codici QR, link email o pulsanti.

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

Configurazione avanzata

Per un controllo completo, utilizza l'oggetto di configurazione JavaScript prima di caricare lo script del 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>

Tipi di trigger

"immediate" Il widget appare immediatamente
"delay" Appare dopo i secondi specificati
"scroll" Appare dopo aver fatto scorrere la percentuale specificata
"engagement" Appare dopo l'interazione dell'utente
"exit" Appare all'intenzione di uscita
"manual" Solo tramite chiamata API

Hai bisogno di aiuto?

Controlla la nostra Riferimento API o uniti alla Community.

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

FlashAI Assistant

Online

Powered by SymfoniX