본문으로 건너뛰기
문서 메뉴시작하기

개발자 문서

시작하기

엔트로피 메신저는 웹사이트에 붙이는 고객 상담 채팅이에요. 고객 대화는 팀의 수신함으로 모이고, 피드백은 이슈로 이어지고, 반영되면 고객에게 다시 알려요. 이 문서는 채널을 만들고 첫 대화를 받기까지를 안내해요.

핵심 개념

메신저의 핵심 개체
개체설명
Channel메신저를 붙이는 제품 하나예요. 브랜드 색, 환영 메시지, 허용 도메인(allowedOrigins), 알림 링크에 쓰는 returnUrl을 가져요.
Contact대화하는 고객이에요. 이름과 인증된 이메일 또는 휴대폰 번호, 약관 동의 기록을 가져요. 회원 연동 시 externalMemberId로 우리 회원과 이어져요.
Conversation고객과의 대화 한 건이에요. kind는 support 또는 feedback, state는 open·snoozed·closed예요. 이슈와 연결되면 linkedIssueId가 채워져요.
Message대화 속 메시지예요. body는 항상 일반 텍스트이고 HTML로 렌더링하지 않아요. internal: true는 운영자끼리만 보는 메모예요.

키와 시크릿

채널 키와 시크릿
이름형식어디에 쓰나요
플러그인 키pk_…브라우저에서 메신저를 부팅할 때 써요. 공개돼도 괜찮아요.
시크릿 키ent_sk_…서버 API와 피드백 API 호출에 써요. 서버에만 두세요.
회원 해시 시크릿memberHashSecret로그인 회원의 memberHash를 서버에서 계산할 때 써요. 회원 연동
웹훅 시크릿webhookSecret웹훅 서명을 검증할 때 써요. 웹훅

API 주소

모든 API는 https://entropy.ly/api 아래에 있어요. 요청과 응답은 JSON이고, 필드 이름은 camelCase, 시간은 ISO-8601 UTC예요.

세 단계로 시작하기

  1. 채널 만들기 — 엔트로피 워크스페이스 설정에서 채널을 만들고, 메신저를 띄울 도메인을 allowedOrigins에 넣어요. 이때 나오는 시크릿을 안전한 곳에 보관하세요.
  2. 위젯 붙이기 — 아래 스니펫을 웹사이트에 붙여 넣어요. 자세한 옵션은 메신저 위젯 설치를 보세요.
  3. 대화 받기 — 고객이 이름과 연락처 인증을 마치면 대화가 시작돼요. 운영자는 엔트로피에서 바로 답하거나 서버 API로 자체 상담 화면에 붙일 수 있어요.
HTML
<script>
(function (w, d) {
  if (w.EntropyMessenger) return;
  var q = [];
  var f = function () { q.push(arguments); };
  f.q = q;
  w.EntropyMessenger = f;
  var s = d.createElement('script');
  s.async = true;
  s.src = 'https://entropy.ly/messenger/v1/loader.js';
  d.head.appendChild(s);
})(window, document);

EntropyMessenger('boot', {
  pluginKey: 'pk_live_xxxxxxxxxxxx',
  language: 'ko', // 'ko' | 'en' | 'ja'
});
</script>
</body> 바로 앞에 붙여 넣으세요. pluginKey는 공개 키라서 브라우저에 노출돼도 괜찮아요.

다음으로 읽을 문서