API 연동

위젯 JavaScript API

설치된 위젯은 window.Cliptalk 객체로 제어할 수 있습니다.

#CliptalkSettings

위젯 스크립트보다 먼저 정의하는 설정 객체입니다.

속성	타입	설명
`user`	object	로그인 회원 정보 { id, name, email, phone, hash }
`locale`	string	위젯 언어 강제 지정 (ko, en, ja, zh-TW, zh-CN)

window.CliptalkSettings = {
  user: { id: 'user_1001', name: '김클립', email: 'clip@example.com' },
  locale: 'ko'
};

JSCliptalk.identify(user | null)

로그인·로그아웃 시 회원 정보를 바꿉니다. 다음에 채팅 창을 열 때 적용됩니다. null 을 넘기면 비회원으로 돌아갑니다.

window.Cliptalk.identify({ id: 'user_1001', name: '김클립' });
window.Cliptalk.identify(null); // 로그아웃

JSCliptalk.setLocale(lang)

위젯 언어를 바꿉니다. null 이면 자동 감지로 돌아갑니다.

window.Cliptalk.setLocale('ja');

JSCliptalk.open() · Cliptalk.close()

채팅 창을 열거나 닫습니다. "1:1 문의" 버튼 같은 사이트 내 버튼에 연결하세요.

<button onclick="window.Cliptalk && Cliptalk.open()">
  1:1 채팅 상담
</button>