Документація

Документація

Як інтегрувати Flash AI з вашим веб-сайтом

Швидкий старт

Додавання Flash AI на ваш веб-сайт займає лише 3 кроки.

1

Замовіть вашого бота

Перейдіть на flashai.pl, натисніть "Замовити" та налаштуйте вашого AI-асистента — ім'я, особистість, базу знань.

2

Вставте код

Додайте один рядок до вашого веб-сайту, прямо перед закриваючим тегом </body>:

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

Готово!

Чат-віджет з'явиться в нижньому правому кутку вашого веб-сайту. Ваш AI-асистент готовий спілкуватися з відвідувачами.

Налаштування віджета

Налаштуйте поведінку віджета за допомогою HTML атрибутів у тезі скрипту.

Атрибут Опис
data-ai (обов'язковий) ID вашого бота
data-name Ім'я для відображення в заголовку чату
data-color Акцентний колір (hex)
data-auto-open Автоматично відкривати чат при завантаженні сторінки
data-fullscreen Повноекранний режим
data-lang Примусово встановлювати мову інтерфейсу

Повний приклад

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

Керуйте віджетом програмно з коду вашого веб-сайту.

Метод Опис
FlashAI.open() Відкриває вікно чату
FlashAI.close() Закриває вікно чату
FlashAI.toggle() Перемикає стан чату (відкрито/закрито)
FlashAI.send("text") Негайно відправляє повідомлення
FlashAI.setInput("text") Встановлює текст введення без відправки
FlashAI.isOpen Перевіряє, чи відкрито чат

Приклади використання

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>

Відкриття чату через посилання

Додайте #flashai-open до будь-якої URL-адреси, і чат відкриється автоматично. Ідеально для QR-кодів, посилань у листах або кнопок.

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

Розширена конфігурація

Для повного контролю використовуйте об'єкт конфігурації JavaScript перед завантаженням скрипта віджета.

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>

Типи тригерів

"immediate" Віджет з'являється негайно
"delay" З'являється після вказаних секунд
"scroll" З'являється після прокрутки на вказаний відсоток
"engagement" З'являється після взаємодії користувача
"exit" З'являється при намірі покинути сторінку
"manual" Лише через виклик API

Потрібна допомога?

Перевірте нашу довідку API або приєднуйтесь до спільноти.

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

FlashAI Assistant

Online

Powered by SymfoniX