Documentație

Documentație

Cum să integrați Flash AI cu site-ul dumneavoastră

Start rapid

Adăugarea Flash AI pe site-ul tău durează doar 3 pași.

1

Comandă-ți botul

Accesează flashai.pl, apasă pe "Comandă" și configurează asistentul tău AI — nume, personalitate, bază de cunoștințe.

2

Copiază codul

Adaugă o linie pe site-ul tău, chiar înainte de tag-ul de închidere </body>:

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

Gata!

Widget-ul de chat va apărea în colțul din dreapta jos al site-ului tău. Asistentul tău AI este gata să vorbească cu vizitatorii.

Configurare widget

Personalizează comportamentul widget-ului folosind atribute HTML pe tag-ul script.

Atribut Descriere
data-ai (obligatoriu) ID-ul bot-ului tău
data-name Nume afișat în antetul chat-ului
data-color Culoare de accent (hex)
data-auto-open Deschidere automată a chat-ului la încărcarea paginii
data-fullscreen Mod ecran complet
data-lang Forțează limba interfeței

Exemplu complet

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

Controlează widget-ul programatic din codul site-ului tău.

Metodă Descriere
FlashAI.open() Deschide fereastra de chat
FlashAI.close() Închide fereastra de chat
FlashAI.toggle() Comută chat-ul deschis/închis
FlashAI.send("text") Trimite un mesaj imediat
FlashAI.setInput("text") Setează textul de intrare fără a trimite
FlashAI.isOpen Verifică dacă chat-ul este deschis

Exemple de utilizare

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>

Deschiderea chat-ului prin link

Adaugă #flashai-open la orice URL și chat-ul se va deschide automat. Perfect pentru coduri QR, link-uri email sau butoane.

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

Configurare Avansată

Pentru control complet, folosește obiectul de configurare JavaScript înainte de a încărca script-ul widget-ului.

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>

Tipuri de declanșare

"immediate" Widget-ul apare imediat
"delay" Apare după un număr specificat de secunde
"scroll" Apare după derularea unui % specificat
"engagement" Apare după implicarea utilizatorului
"exit" Apare la intenția de ieșire
"manual" Doar prin apel API

Ai nevoie de ajutor?

Verifică Referința API sau alătură-te Comunității.

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

FlashAI Assistant

Online

Powered by SymfoniX