문서

웹사이트에 Ontara를 설치하고 어떤 언어로든 방문자에게 답하는 데 필요한 모든 것.

위젯 설치

로그인해 워크스페이스를 만든 뒤 관리 화면에서 채팅 위젯을 여세요. 코드를 복사해 모든 페이지의 </body> 앞에 붙여 넣으세요:

<script src="https://YOUR-LINGLY-HOST/w.js" data-site="pk_your_site_key" async></script>

위젯은 등록한 도메인과 그 하위 도메인에서만 작동해요(예: example.com은 shop.example.com도 포함). 설치하기 전에 관리 화면에서 테스트 페이지를 열어 사용해 보세요.

WordPress

Ontara WordPress 플러그인을 설치하거나, 헤더·푸터 스크립트 플러그인으로 같은 코드를 붙여 넣으세요.

싱글 페이지 앱

HTML 템플릿에 스크립트를 한 번만 넣으세요. 클라이언트 측 라우트가 바뀌어도 계속 작동해요.

JavaScript API

스크립트가 로드되면 작은 전역 객체를 사용할 수 있어요:

호출하는 일
lingly.open()채팅 창을 엽니다. 예를 들어 직접 만든 “문의하기” 버튼에서 호출하세요.
lingly.close()채팅 창을 닫습니다.
lingly.identify({ userId, email, name, hash })방문자가 누구인지 Ontara에 알려 줍니다. 신원 확인을 참고하세요.
lingly.reset()방문자 정보를 잊습니다. 예를 들어 사용자가 로그아웃할 때 호출하세요.
lingly.shutdown()페이지에서 위젯을 제거합니다.
<button onclick="lingly.open()">채팅 상담</button>

스크립트가 로드되기 전에 로그인한 사용자를 전달하려면 코드 위에 window.linglySettings = { user: { email, name } }를 설정하세요.

번역

팀에서 팀 언어를 설정하세요. 방문자가 다른 언어로 쓰면 메시지가 팀을 위해 번역되고, 원문은 클릭 한 번이면 볼 수 있어요. 답장은 전달되기 전에 방문자의 언어로 번역돼요. 환영 메시지와 자동 답장도 번역돼요.

번역은 자동화에서 켜고 끌 수 있어요. 위젯 자체의 버튼은 방문자의 브라우저 언어(영어, 중국어, 스페인어, 포르투갈어, 프랑스어, 독일어, 일본어, 한국어, 이탈리아어) 또는 직접 고른 언어를 따릅니다.

AI 답변

  1. 지식 베이스에 내용을 추가하세요: 질문과 답변, 웹 페이지 URL, 또는 일반 텍스트.
  2. 같은 페이지의 AI 사용해 보기로 어떻게 답할지 확인하세요.
  3. 자동화에서 AI가 언제 답할지 고르세요: 온라인인 팀원이 없을 때만, 또는 항상 먼저.

AI는 지식 베이스의 내용으로만, 방문자의 언어로 답해요. 답할 수 없거나 방문자가 사람을 찾으면 대화를 팀에게 넘기고 그 대화에서는 더 이상 답하지 않아요. 팀원이 답장해도 바로 멈춥니다.

부재 중일 때

팀과 역할

역할할 수 있는 일
소유자결제를 포함한 모든 것.
관리자설정, 지식 베이스, 웹사이트, 초대, 결제.
상담원대화에 답하고 지식 베이스를 읽기.

팀에서 사람을 초대하세요. 초대받은 이메일 주소로 로그인하면 참여해요. 모든 플랜에서 상담원 수는 무제한이에요.

플랜과 한도

플랜별 포함 내용은 요금을 참고하세요. 월간 한도에 도달해도 실시간 채팅은 계속 작동하고, AI 답변과 번역은 다음 달이나 업그레이드할 때까지 일시 중지돼요. 플랜의 기록 보관 기간보다 오래된 대화는 자동으로 삭제돼요.

신원 확인

방문자가 사이트에 로그인해 있다면, 그 사람이 누구인지 Ontara에 알리고 증명할 수 있어요. 그러면 아무도 사용자를 사칭할 수 없어요.

  1. 채팅 위젯 → 신원 확인에서 기능을 켜고 시크릿을 복사하세요. 시크릿은 서버에만 보관하세요.
  2. 서버에서 hex(HMAC-SHA256(secret, userId))를 계산하세요.
  3. 페이지에서 lingly.identify({ userId, email, name, hash })를 호출하세요.
// Node.js import { createHmac } from "node:crypto"; const hash = createHmac("sha256", process.env.LINGLY_IDENTITY_SECRET).update(user.id).digest("hex"); // PHP $hash = hash_hmac('sha256', $userId, getenv('LINGLY_IDENTITY_SECRET'));

상담원에게는 방문자 옆에 인증됨 배지가 보여요. 잘못된 해시로 호출하면 거부돼요. 채팅에 이메일만 입력한 방문자는 인증된 것으로 표시되지 않아요.

이메일 답장

떠난 방문자에게 답장이 이메일로 전송되면, 방문자는 그 이메일에 그냥 답장하면 돼요. 답장은 같은 대화에 표시되며, 인용문과 서명은 제거돼요.

이 기능에는 수신용 도메인이 필요해요. Cloudflare Email Routing에서 r-*@reply.your-domain.com을 Ontara Worker로 보내도록 설정한 뒤 INBOUND_EMAIL_DOMAIN=reply.your-domain.com을 설정하세요. 방문자 본인의 주소만 해당 대화에 글을 남길 수 있고, 자동 응답과 반송 메일은 무시돼요.

알림

계정 → 브라우저 알림에서 팀원마다 사용 중인 기기의 알림을 켤 수 있어요. 받은편지함이 열려 있지 않을 때 방문자가 메시지를 보내면 알림이 뜨고, 클릭하면 해당 대화가 열려요. 팀의 이메일 알림도 예비 수단으로 계속 작동해요.

React

npm install @lingly/react import { LinglyChat, useLingly } from "@lingly/react"; <LinglyChat siteKey="pk_your_site_key" user={user ? { userId: user.id, email: user.email, hash: user.linglyHash } : null} /> const { open } = useLingly(); // open(), close(), identify(user), reset()

이 컴포넌트는 직접 아무것도 렌더링하지 않아요. 위젯을 한 번 로드하고, 로그인한 사용자와 방문자 정보를 동기화해요. user가 null이 되면 위젯은 방문자 정보를 잊어요.

이 패키지는 아직 npm에 공개되지 않았어요. 공개되기 전까지는 위의 JavaScript API로 어떤 React 앱에서든 같은 일을 할 수 있어요.

WordPress

  1. 플러그인을 다운로드한 뒤 WordPress에서 플러그인 → 새로 추가 → 플러그인 업로드로 이동하세요.
  2. 플러그인을 활성화하고 설정 → Ontara Chat을 여세요.
  3. 사이트 키를 붙여 넣으세요. 신원 확인 시크릿도 붙여 넣으면 로그인한 WordPress 사용자가 인증된 것으로 표시돼요.

REST API

개발자에서 키를 만들고 모든 요청에 함께 보내세요:

curl https://YOUR-LINGLY-HOST/api/v1/conversations?status=open \ -H "Authorization: Bearer lk_your_key"
엔드포인트하는 일
GET /api/v1/sites내 웹사이트 목록.
GET /api/v1/conversations최신순. 필터: site, status(open 또는 closed), limit(최대 100), before(이전 페이지의 nextBefore 값).
GET /api/v1/conversations/:id대화 하나.
GET /api/v1/conversations/:id/messages순서대로 정렬된 메시지. after = 가지고 있는 마지막 seq.
POST /api/v1/conversations/:id/messages팀으로서 답장: {"body": "...", "name": "Bot"}. 답장은 방문자를 위해 번역돼요. 같은 clientId를 다시 보내면 안전하게 재시도할 수 있어요.
POST /api/v1/conversations/:id/close · /reopen종료 또는 다시 열기.
DELETE /api/v1/conversations/:id대화와 메시지를 영구 삭제.
GET /api/v1/visitors/:id인증 여부를 포함한 방문자 정보.

키 하나당 분당 120회 요청할 수 있어요. 오류는 {"error": "not_found"} 같은 JSON과 해당 HTTP 상태 코드로 반환돼요.

웹훅

개발자에서 https 엔드포인트를 추가하고 원하는 이벤트를 고르세요: conversation.created, conversation.closed, conversation.reopened, message.created, visitor.email_captured.

POST /your/endpoint Lingly-Event: message.created Lingly-Signature: t=1763100000,v1=5f2c… {"id": "evt_…", "type": "message.created", "createdAt": 1763100000000, "workspaceId": "ws_…", "data": {"conversationId": "conv_…", "siteId": "site_…", "visitorId": "vis_…", "message": {…}}}

요청을 검증하려면 hex(HMAC-SHA256(secret, t + "." + rawBody))를 계산해 v1과 비교하고, 5분보다 오래된 타임스탬프는 거부하세요. 응답은 2xx 상태면 무엇이든 괜찮아요. 실패한 전송은 약 20분 동안 재시도되며, 계속 실패하는 엔드포인트는 일시 중지돼요. 같은 이벤트가 가끔 두 번 도착할 수 있으니 id로 중복을 걸러 내세요.