쇼핑몰 연동 가이드

install.md · llms.txt

# dlinglive 라이브 위젯 설치 (AI agent 용)

웹사이트 모든 페이지 우하단에 라이브 버튼을 띄운다. 버튼을 누르면 라이브 플레이어·채팅 패널이 열린다. 방송 중이면 버튼에 LIVE 배지가 붙는다.

입력값: 채널 slug(예: `test-a`). 사용자가 주지 않았으면 물어본다.

## 1. 사이트 종류를 판별하고 하나만 적용한다

### A. HTML 을 직접 수정할 수 있는 사이트 (정적 HTML, 서버 템플릿, PHP, Rails, Django 등)

공통 레이아웃의 `</body>` 직전에 넣는다.

```html
<script async src="https://dling.live/widget/v1/loader.js" data-channel="CHANNEL_SLUG"></script>
```

### B. Next.js (App Router)

`app/layout.tsx` 의 `<body>` 안에 넣는다.

```tsx
import Script from "next/script";

<Script
  src="https://dling.live/widget/v1/loader.js"
  data-channel="CHANNEL_SLUG"
  strategy="afterInteractive"
/>;
```

Pages Router 는 `pages/_app.tsx` 에 같은 `<Script>` 를 넣는다.

### C. React·Vue·Svelte 등 SPA (Vite, CRA, Nuxt 등)

`index.html`(Nuxt 는 `app.head.script`)에 A 의 태그를 넣는다. 라우트가 바뀌어도 위젯은 유지된다. 특정 화면에서만 띄우려면 그 화면 진입 시 `window.DlingLive("boot", { channel: "CHANNEL_SLUG" })`, 이탈 시 `window.DlingLive("destroy")` 를 호출하고 태그에서 `data-channel` 을 뺀다.

### D. 쇼핑몰 빌더 (코드를 직접 못 고치는 경우)

빌더의 "커스텀 코드 / 스크립트 삽입 / body 하단 코드" 설정에 A 의 태그를 붙여넣는다. 아임웹·식스샵·고도몰·메이크샵·카페24·Shopify(theme.liquid)·WordPress(테마 footer 또는 코드 삽입 플러그인)·Wix·Webflow·Framer 모두 이 경로가 있다. 직접 할 수 없으면 사용자에게 붙여넣을 위치와 태그를 안내한다.

## 2. CSP 를 쓰는 사이트

`Content-Security-Policy` 헤더나 meta 가 있으면 아래를 추가한다.

- `script-src https://dling.live`
- `connect-src https://chat.dling.live`
- `frame-src https://dling.live`

## 3. 확인

페이지를 열어 우하단에 원형 버튼이 보이는지, 누르면 패널이 열리는지 확인한다. 콘솔에 `[dlinglive]` 오류가 없어야 한다.

## API

| 호출                                       | 동작                        |
| ------------------------------------------ | --------------------------- |
| `DlingLive("boot", { channel })`           | 위젯 표시(이미 있으면 교체) |
| `DlingLive("open")` / `DlingLive("close")` | 패널 열기·닫기              |
| `DlingLive("destroy")`                     | 위젯 제거                   |

스크립트가 로드되기 전에 호출하려면 태그 앞에 넣는다.

```html
<script>window.DlingLive=window.DlingLive||function(){(DlingLive.q=DlingLive.q||[]).push(arguments)}</script>
```

위치는 CSS 변수 `--dl-x`, `--dl-y` 를 `#dlinglive-widget` 에 지정해 바꾼다.