Dokumentacja

Dokumentacja

Jak zintegrować Flash AI ze swoją stroną

Szybki Start

Dodanie Flash AI do Twojej strony zajmuje tylko 3 kroki.

1

Zamów bota

Wejdź na flashai.pl, kliknij "Zamów" i skonfiguruj swojego asystenta AI — imię, osobowość, bazę wiedzy.

2

Wklej kod

Dodaj jedną linijkę na swoją stronę, tuż przed zamykającym tagiem </body>:

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

Gotowe!

Widget czatu pojawi się w prawym dolnym rogu Twojej strony. Twój asystent AI jest gotowy do rozmów z odwiedzającymi.

Konfiguracja widgetu

Dostosuj zachowanie widgetu za pomocą atrybutów HTML na tagu script.

Atrybut Opis
data-ai (wymagane) ID Twojego bota
data-name Nazwa wyświetlana w nagłówku czatu
data-color Kolor akcentu (hex)
data-auto-open Automatyczne otwarcie czatu po załadowaniu strony
data-fullscreen Tryb pełnoekranowy
data-lang Wymuszony język interfejsu

Pełny przykład

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

Steruj widgetem programistycznie z kodu Twojej strony.

Metoda Opis
FlashAI.open() Otwiera okno czatu
FlashAI.close() Zamyka okno czatu
FlashAI.toggle() Przełącza czat (otwiera/zamyka)
FlashAI.send("text") Wysyła wiadomość natychmiast
FlashAI.setInput("text") Wpisuje tekst bez wysyłania
FlashAI.isOpen Sprawdza czy czat jest otwarty

Przykłady użycia

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>

Otwieranie czatu przez link

Dodaj #flashai-open do dowolnego URL, a czat otworzy się automatycznie. Idealne do kodów QR, linków w mailach lub przycisków.

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

Zaawansowana konfiguracja

Dla pełnej kontroli użyj obiektu konfiguracyjnego JavaScript przed załadowaniem skryptu widgetu.

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>

Typy wyzwalaczy

"immediate" Widget pojawia się natychmiast
"delay" Pojawia się po określonej liczbie sekund
"scroll" Pojawia się po przewinięciu określonego %
"engagement" Pojawia się po zaangażowaniu użytkownika
"exit" Pojawia się przy zamiarze opuszczenia strony
"manual" Tylko przez wywołanie API

Potrzebujesz pomocy?

Sprawdź nasze API Reference lub dołącz do Społeczności.

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

FlashAI Assistant

Online

Powered by SymfoniX