개발자
임베드 코드 한 줄로 서비스에 연결하세요
프로젝트를 만든 뒤 공유 메뉴에서 임베드 코드를 복사해 웹사이트에 붙이세요. 고객 정보를 함께 전달하면 대화 기록을 고객별로 확인할 수 있어요.
웹사이트에 임베드
프로젝트의 공유 메뉴 → «임베드 코드»에서 복사한 코드예요. 마이크 권한이 포함돼 있어 페이지 안에서 바로 음성 대화를 할 수 있어요.
«YOUR_SHARE_HOST»와 «PROJECT_ID»는 프로젝트 공유 메뉴에 나오는 실제 값으로 바뀌어요. 직접 만들지 말고 복사해 쓰세요.
<iframe
src="https://YOUR_SHARE_HOST/embed-new-pc/PROJECT_ID?streaming=1&customerId=USER_ID&customerName=USER_NAME"
width="100%" height="720" style="border:0"
allow="microphone; camera; autoplay; clipboard-write"
allowfullscreen></iframe> 공유 링크
임베드 없이 링크만 보내도 대화를 시작할 수 있어요. 메일, 메신저, QR 코드, 키오스크 화면에 쓰세요.
https://YOUR_SHARE_HOST/new-pc/PROJECT_ID?streaming=1&customerId=user%40example.com&customerName=%ED%99%8D%EA%B8%B8%EB%8F%99 고객 식별 파라미터
링크나 임베드 코드에 아래 파라미터를 붙이면 대화 기록에서 누가 대화했는지 보이고, 아바타가 고객 이름을 불러 줘요.
| 파라미터 | 설명 |
|---|---|
customerId | 고객 이메일 또는 회원 ID(최대 120자). 대화 기록에 표시돼요. |
customerName | 고객 이름(최대 60자). 대화 기록에 표시되고, 아바타가 이 이름으로 고객을 불러요. |
연동 팁
- iframe의 allow 속성에서 microphone을 빼면 음성 대화가 되지 않아요.
- customerId에는 개인정보 대신 회원 번호처럼 내부 식별자를 쓰는 것을 권장해요.
- 대화 언어·답변 모델·웹 검색은 프로젝트 설정에서 바꾸고, 코드는 그대로 둬도 돼요.
API·SDK 준비 중
전용 REST API, SDK, 웹훅, 함수 호출은 준비 중이에요. 지금 연동이 필요하다면 요구 사항을 알려 주세요.