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

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

Как интегрировать 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