Tài liệu

Tài liệu

Cách tích hợp Flash AI với trang web của bạn

Bắt đầu nhanh

Thêm Flash AI vào trang web của bạn chỉ mất 3 bước.

1

Đặt bot của bạn

Truy cập flashai.pl, nhấp "Đặt" và cấu hình trợ lý AI của bạn — tên, tính cách, cơ sở kiến thức.

2

Dán mã

Thêm một dòng vào trang web của bạn, ngay trước thẻ đóng </body>:

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

Xong!

Widget trò chuyện sẽ xuất hiện ở góc dưới bên phải của trang web của bạn. Trợ lý AI của bạn đã sẵn sàng trò chuyện với khách truy cập.

Cấu hình Widget

Tùy chỉnh hành vi widget bằng cách sử dụng thuộc tính HTML trên thẻ script.

Thuộc tính Mô tả
data-ai (bắt buộc) ID bot của bạn
data-name Tên hiển thị trong tiêu đề trò chuyện
data-color Màu nhấn (hex)
data-auto-open Tự động mở trò chuyện khi tải trang
data-fullscreen Chế độ toàn màn hình
data-lang Buộc ngôn ngữ giao diện

Ví dụ đầy đủ

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

Kiểm soát widget theo chương trình từ mã trang web của bạn.

Phương thức Mô tả
FlashAI.open() Mở cửa sổ trò chuyện
FlashAI.close() Đóng cửa sổ trò chuyện
FlashAI.toggle() Chuyển đổi trạng thái chat mở/đóng
FlashAI.send("text") Gửi tin nhắn ngay lập tức
FlashAI.setInput("text") Đặt văn bản đầu vào mà không gửi
FlashAI.isOpen Kiểm tra xem chat có đang mở không

Ví dụ sử dụng

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>

Mở trò chuyện qua liên kết

Thêm #flashai-open vào bất kỳ URL nào và trò chuyện sẽ tự động mở. Hoàn hảo cho mã QR, liên kết email hoặc nút bấm.

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

Cấu hình nâng cao

Để có toàn quyền kiểm soát, hãy sử dụng đối tượng cấu hình JavaScript trước khi tải tập lệnh 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>

Loại kích hoạt

"immediate" Widget xuất hiện ngay lập tức
"delay" Xuất hiện sau số giây được chỉ định
"scroll" Xuất hiện sau khi cuộn đến % được chỉ định
"engagement" Xuất hiện sau khi người dùng tương tác
"exit" Xuất hiện khi có ý định thoát
"manual" Chỉ qua lệnh gọi API

Cần giúp đỡ?

Kiểm tra Tài liệu API của chúng tôi hoặc tham gia Cộng đồng.

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

FlashAI Assistant

Online

Powered by SymfoniX