문서

문서

웹사이트에 FlashAI를 통합하는 방법

빠른 시작

웹사이트에 FlashAI를 추가하는 것은 단 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>

링크를 통한 채팅 열기

모든 URL에 #flashai-open을 추가하면 채팅이 자동으로 열립니다. 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