통합

제어판 → Integrations — 지식에 접근하기 위한 콘텐츠 소스와 채널을 연결하세요.

#콘텐츠 소스

#연결됨 (항상 활성)

#사용 가능한 커넥터

연결할 수 있는 소스 수는 요금제에 따라 제한됩니다. 한도가 찬 경우 소스의 "연결" 버튼이 비활성화됩니다 — 하나를 연결 해제하거나 상위 요금제로 전환하세요. Slack 및 Telegram 봇은 이 한도에 포함되지 않습니다.

#GitHub 연결

#1단계 — 인증

1. LiKE에서 Integrations → GitHub → **"연결"**로 이동합니다
2. 인증 방법을 선택합니다:

#2단계 — 콘텐츠 선택

1. 연결 후, 폴더와 파일이 있는 저장소 트리가 표시됩니다
2. 가져올 특정 파일이나 폴더를 체크합니다 (Selective Sync)
3. 지원 형식: .md, .mdx, Wiki 페이지

#3단계 — 동기화 실행

1. **"Sync"**를 클릭합니다
2. 진행 상황이 실시간으로 표시됩니다
3. 완료되면 문서가 GitHub 라벨과 함께 목록에 나타납니다

#GitLab 연결

#1단계 — 인증

1. LiKE에서 Integrations → GitLab → **"연결"**로 이동합니다
2. 인증 방법을 선택합니다:

#2단계 — 콘텐츠 선택

1. Wiki 페이지 및 Markdown 파일이 있는 프로젝트 트리가 표시됩니다
2. 가져올 특정 페이지를 체크합니다 (Selective Sync)

#3단계 — 동기화 실행

GitHub와 동일 — **"Sync"**를 클릭하고 완료될 때까지 기다립니다.

#Gitea 연결

Gitea는 셀프 호스팅 git 플랫폼입니다. Personal Access Token과 인스턴스의 필수 URL을 통해 연결됩니다(기본적으로 클라우드 Gitea는 없습니다).

#1단계 — Gitea에서 토큰 생성

1. Gitea에서 Settings → Applications → Generate New Token을 엽니다
2. read:repository 및 read:user 스코프를 부여합니다
3. 토큰을 복사합니다

#2단계 — LiKE에서 연결

1. LiKE에서 Integrations → Gitea → **"연결"**로 이동합니다
2. 인스턴스의 Base URL을 지정합니다(예: https://gitea.company.com) — 이 필드는 필수이며, 없으면 연결이 진행되지 않습니다
3. 토큰을 붙여넣습니다
4. 문서를 저장할 위치(공간과 그 안의 폴더 — 또는 새로 만들기)와 모드(Sync — 지속적인 미러 / Import — 일회성 복사)를 선택합니다

Gitea 관리자가 미리 OAuth 애플리케이션을 설정한 경우 OAuth 2.0도 지원됩니다. 기본 경로는 토큰입니다.

#3단계 — 콘텐츠 선택 및 동기화

1. Wiki 페이지 및 Markdown 파일(.md, .mdx)이 있는 저장소 트리가 표시됩니다
2. 필요한 노드를 체크하고(Selective Sync) **"Sync"**를 클릭합니다
3. 푸시 시 자동 업데이트를 위해 webhook을 설정하세요 — 시크릿은 커넥터 카드에서 생성됩니다. Gitea의 문서는 읽기 전용입니다(GitHub/GitLab과 동일)

#파일 선택 및 동기화 필터 (GitHub, GitLab, Gitea)

git 소스(GitHub, GitLab, Gitea)의 경우, 무엇을 동기화할지 선택하는 로직은 단순한 "저장소 켜기/끄기"보다 더 세밀합니다:

#무엇이 동기화되나요

#경로 필터 (선택적 동기화)

저장소에서 정확히 무엇을 가져올지 좁힐 수 있습니다:

#변경 감지 (최근 변경)

LiKE는 매번 실행할 때마다 "모든 것을 다운로드"하지 않습니다. 변경 감지가 사용됩니다:

• GitHub — webhook(권장) 또는 If-Modified-Since 헤더를 사용한 폴링을 통해. webhook은 푸시에 즉시 반응하고, 폴링은 6/12/24/48시간마다(자동 동기화에 따라 다름) 수행됩니다.
• GitLab — 마찬가지: webhook 또는 Projects API를 통한 last_activity_at 폴링.
• Gitea — webhook(X-Gitea-Signature 서명) 또는 폴링. 푸시 트리거는 *.md/*.mdx가 변경될 때만 실행됩니다.

변경이 감지되면 영향을 받은 파일만 동기화되고, 나머지 코퍼스는 재계산되지 않습니다. 이로써 많은 GitHub/GitLab API 할당량과 실행 시간이 절약됩니다.

#브랜치 및 태그

#기록 및 충돌

• 동기화 기록 — 커넥터 카드의 "History" 탭: 날짜, 상태( ok / 경고 / 오류), 추가/업데이트/삭제된 문서 수, 실행 시간. "저장소의 문서가 왜 나타나지 않았는지" 디버깅하는 데 유용합니다.
• 편집 충돌 — 소스의 문서가 LiKE에서 편집된 경우(GitHub/GitLab의 경우 기본적으로 허용되지 않음 — 문서는 읽기 전용입니다). 모드가 Import(일회성 복사)이면 문서가 편집 가능해지고 소스와의 연결이 끊어집니다.

#다른 커넥터의 Selective Sync

Notion, Confluence, Wiki.js — 이들은 고유한 선택 로직(페이지 트리)이 있지만 원리는 동일합니다:

1. 연결 시 소스의 콘텐츠 트리가 표시됩니다
2. 체크박스 — 필요한 노드를 표시합니다
3. 나머지는 가져오지 않습니다
4. 재동기화 시 선택한 항목만 업데이트됩니다

#Wiki.js 연결

#1단계 — Wiki.js API 토큰 받기

1. Wiki.js를 엽니다 → Administration → API Access
2. API를 활성화합니다(비활성화된 경우)
3. New API Key를 클릭합니다
4. 키 이름을 지정합니다(예: LiKE Integration)
5. 그룹: Administrators(모든 페이지에 대한 접근이 필요함)
6. 만료: 만료 없음 또는 1년
7. 생성된 토큰을 복사합니다

#2단계 — LiKE에서 연결

1. LiKE에서 Integrations → Wiki.js → **"연결"**로 이동합니다
2. Wiki.js의 URL을 입력합니다(예: https://wiki.company.com)
3. API 토큰을 붙여넣습니다
4. 모드를 선택합니다:

5. Save를 클릭합니다

#3단계 — 동기화 구성

#Confluence 연결

Confluence는 OAuth 2.0을 통해 연결됩니다 — 비밀번호 입력 없는 안전한 인증입니다.

#1단계 — Confluence 사이트 연결

1. Confluence Cloud가 필요합니다 — 주소 형식은 your-company.atlassian.net입니다. Confluence Server 및 Data Center는 지원되지 않습니다
2. «연결»을 클릭하고 Atlassian 계정에 로그인하세요
3. 접근 권한 창에서 Confluence 사이트를 선택하고 «Accept»를 클릭하세요. LiKE는 본인이 접근할 수 있는 내용만 볼 수 있습니다
4. «Access denied»가 표시되나요? start.atlassian.com에서 계정에 Confluence 사이트가 있는지 확인하세요. 사이트가 있다면 Atlassian 관리자에게 앱 연결을 허용해 달라고 요청하세요: admin.atlassian.com → Apps → 내 사이트 → Connected apps → Settings → «Block user apps» 끄기

권한을 검토합니다 — LiKE는 읽기 전용을 요청합니다: 페이지 콘텐츠 및 스페이스 목록

#2단계 — 문서 저장 위치와 가져올 내용

Confluence 카드에서 **"설정"**을 엽니다:

**"동기화"**를 클릭합니다.

#선택 방식

아무것도 선택하지 않으면 동기화할 내용이 없으며, 카드에 그렇게 표시됩니다. 선택을 해제한 공간은 해당 폴더와 함께 LiKE에서 제거됩니다.

#가져오지 않는 항목

• 개인 공간 — 트리에 표시되지 않습니다. 직원의 개인 메모이며 이름이 사람의 이름이기 때문입니다.
• 사람 멘션 — 레이블이 있는 멘션은 레이블 텍스트가 남고, 레이블이 없는 멘션은 제거됩니다. 작업 담당자는 가져오지 않습니다. LiKE는 Atlassian 사용자의 식별자나 프로필을 저장하지 않습니다.

Confluence의 문서는 읽기 전용입니다. 편집하려면 Confluence에서 원본을 변경하면 다음 동기화 시 LiKE가 업데이트합니다.

Confluence 연결을 해제할 때 LiKE에서 문서 복사본을 유지(편집 가능해짐)하거나 삭제할 수 있습니다.

#Notion 연결

#1단계 — Notion에서 통합 생성

1. Notion을 엽니다 → 아바타(왼쪽 상단 모서리)를 클릭 → Settings
2. 왼쪽 메뉴에서 My connections(또는 Integrations)를 선택합니다
3. Develop or manage integrations → New integration을 클릭합니다
4. 이름을 입력하고(예: LiKE Import) 워크스페이스를 선택합니다
5. Submit을 클릭 → Internal Integration Secret을 복사합니다(ntn_로 시작; 이전 통합의 경우 — secret_로 시작)

#2단계 — 통합에 페이지 접근 권한 부여

기본적으로 통합은 어떤 페이지에도 접근할 수 없습니다. 명시적으로 허용해야 합니다:

1. Notion에서 가져오려는 각 페이지(또는 상위 페이지/데이터베이스)를 엽니다
2. ⋯(점 세 개, 오른쪽 상단 모서리) → Connect to → LiKE Import 통합을 선택합니다
3. 접근을 확인합니다

#3단계 — LiKE에서 연결

1. LiKE에서 → 제어판 → Integrations → Notion → "연결"
2. Integration Secret을 붙여넣습니다(1단계에서 복사함)
3. 문서를 저장할 위치를 선택합니다: 공간과 그 안의 폴더 — 또는 여기에서 바로 새 폴더나 새 공간을 만듭니다
4. 모드를 선택합니다:

5. "콘텐츠 선택" 단계에서 가져올 대상을 선택합니다: 카탈로그 전체 또는 개별 페이지. 카탈로그는 2단계에서 접근 권한을 부여한 루트 페이지 또는 데이터베이스입니다. 아무것도 선택하지 않으면 마법사에서 다음 단계로 넘어갈 수 없습니다
6. **"연결 및 동기화"**를 클릭합니다 — 각 카탈로그의 문서는 3단계에서 선택한 폴더 안의 전용 폴더에 들어갑니다

#선택 방식

텍스트가 없는 페이지(예: 속성만 있는 데이터베이스 레코드)는 문서가 되지 않습니다. Notion 카드에 건너뛴 페이지 수가 표시됩니다: "건너뛴 빈 페이지: N".

#4단계 — 설정

Notion 카드에서 **"설정"**을 엽니다:

Notion 연결을 해제할 때 LiKE에서 문서 복사본을 유지(편집 가능해짐)하거나 삭제할 수 있습니다.

#웹 커넥터

웹 커넥터는 몇 분 만에 귀사 웹사이트의 페이지를 LiKE에 연결합니다. 주소를 붙여넣으면 LiKE가 사이트맵(sitemap) 또는 링크 순회로 페이지를 찾아 텍스트를 가져오고, 사본을 최신 상태로 유지합니다. 이 페이지들에서는 바로 LiKE AI 검색이 동작하며, 필요하면 사이트에 검색 위젯을 설치할 수 있습니다 — 고객용 또는 직원용으로.

문서나 헬프 센터가 이미 게시되어 있는 경우에 유용합니다 — 자체 도메인, Docusaurus, GitBook, Docsify 등. 사이트는 공개되어 있어야 합니다. 한 조직은 사이트 하나를 연결합니다.

#1단계 — 주소와 페이지 찾는 방식

연동 → 웹 커넥터 → 연결. 주소를 붙여넣으세요. 어느 페이지 주소라도 괜찮으며, 사이트 전체를 가져옵니다.

페이지 찾는 방식:

• 사이트맵으로 — 기본값. 사이트맵은 저희가 찾습니다: 먼저 robots.txt, 그다음 /sitemap.xml을 확인합니다;
• 사이트맵 없음 — 링크 따라가기 — 홈페이지에서 이 사이트 안의 링크를 따라갑니다. 크롤링 깊이를 지정하세요. 사이트가 스크립트로 그리는 페이지는 링크 순회로 보이지 않습니다.

사이트 확인을 누르세요. 사이트맵을 찾지 못하면 마법사가 링크 순회를 켜고 다시 확인하도록 제안합니다.

#2단계 — 가져올 대상

확인 단계에서는 아무것도 저장하지 않습니다: 발견된 페이지 수와 추가될 페이지 수를 보여 줍니다. 분량이 요금제에 맞지 않으면 수집 후가 아니라 바로 알려 드립니다.

• 언어 버전 — 사이트가 여러 언어로 페이지를 제공할 때 나타납니다. 가져올 버전을 선택하세요. 숫자와 폴더가 그에 맞춰 다시 계산됩니다.
• 가져올 대상 — 베이스에 만들어질 폴더 목록과 각 폴더의 페이지 수. 체크된 항목을 가져오며, 체크를 해제한 폴더는 다시 체크할 수 있습니다. 선택됨 카운터는 체크된 항목만 셉니다.
• 태그·카테고리 보관 페이지 — 어차피 베이스에 들어올 글의 링크 모음 — 는 기본적으로 가져오지 않으며, 필요하면 체크하세요.
• 사이트가 연도별로 구성되어 있으면 각 연도가 별도 폴더가 됩니다. 연도가 세 개 이상이면 사이트의 가장 최근 두 해가 체크되어 있으며, 나머지는 직접 체크할 수 있습니다.
• 사이트의 홈페이지는 "홈" 폴더의 별도 문서가 됩니다.
• 한 번의 수집당 페이지 수는 사이트 크기가 아니라 저희 설정입니다: 나머지는 다음 수집에서 가져옵니다.

페이지가 어느 폴더에 속하는지는 페이지 자체에서만 알 수 있으므로, 추가될 페이지보다 더 많은 페이지를 확인합니다. 마법사는 두 숫자를 모두 보여 줍니다.

제안: 무엇을 가져올까(링크 순회 시에만). 모델에 묻기 버튼은 어떤 주소 그룹을 가져오고 어떤 그룹을 제외할지 이유와 함께 제안합니다. 이는 결정이 아니라 제안입니다: 동의하는 항목을 체크하세요. 사용량은 편집기의 AI 작업과 동일하게 계산되며, 답변은 저장되어 다시 계산 버튼으로만 새로 계산됩니다.

#3단계 — 저장 방식과 저장 위치

페이지 저장 방식:

• 내부용 — 팀만 볼 수 있음 — 기본값;
• 공개 — 누구나 볼 수 있음.

선택한 폴더가 이미 모두에게 공개되어 있으면 마법사가 이를 알리고 공개을 제안합니다. 이러한 폴더의 페이지는 누구나 볼 수 있습니다. 팀만 보게 하려면 내부용을 선택하십시오. 그러면 공개 폴더에서도 숨겨진 상태로 유지됩니다. 비공개 폴더에서는 내부 페이지가 폴더의 접근 권한을 따릅니다. 나중에 폴더를 공개하면 개인정보 검사를 거쳐 함께 공개됩니다.

공개 접근에는 두 가지 체크가 모두 필요합니다: 사이트와 그 콘텐츠에 대한 권리가 있다는 것, 그리고 사이트의 개인정보가 적법하게 게시되었고 이를 검색과 어시스턴트 답변에서 제공할 권리가 있다는 것. 체크하지 않으면 연결 버튼이 활성화되지 않습니다. 동의는 기록되며(누가, 언제, 어떤 문구를 확인했는지) 이 사이트의 모든 문서에 적용됩니다: 문서를 게시할 때 개인정보를 문서마다 따로 확인할 필요가 없습니다. 편집기에서 작성한 문서에는 적용되지 않습니다. 동의를 철회하려면 사이트 연결을 해제하고 "내부용"을 선택해 다시 연결하세요.

저장 위치: 공간과 그 안의 폴더를 선택하세요. 알맞은 폴더가 없으면 내부에 컬렉션 만들기, 알맞은 공간이 없으면 새 공간 만들기를 선택하세요. 연결할 때 만들어집니다. 공간 자체는 대상이 될 수 없으며, 폴더는 비어 있어야 합니다: 소스 폴더에는 커넥터만 콘텐츠를 넣습니다.

연결을 누르면 수집이 즉시 시작되고, 진행 상황은 커넥터 카드(“선택한 92개 중 22개 동기화 중”)와 백그라운드 작업 표시에서 확인할 수 있습니다.

#가져오는 것과 가져오지 않는 것

• 사이트의 메뉴·머리글·바닥글을 제외한 본문 내용을 가져옵니다.
• 폴더는 마법사에서, 이후에는 커넥터 설정(설정 → 사이트 폴더)에서 체크합니다.
• 검색, 태그 같은 보조 섹션은 기본적으로 건너뜁니다.
• 한 번의 수집당 페이지 수는 한 번의 수집을 제한합니다. 매우 큰 사이트에 대한 보호 장치입니다.
• robots.txt에서 차단된 페이지는 가져오지 않으며, 그 수는 실행 요약에 표시됩니다.
• 어시스턴트 답변과 문서 머리글에 원본 페이지로 가는 사이트에서 열기 링크가 있습니다.

#이후 업데이트

자동으로 업데이트를 켜두면 일정에 따라 사이트를 다시 읽습니다. 변경된 페이지만 다시 색인됩니다. 실행 요약에도 “추가됨”, “업데이트됨”, “변경 없음”으로 표시됩니다. 변경되지 않은 페이지는 색인 한도를 소모하지 않습니다.

원본에서 사라진 문서 삭제는 기본적으로 꺼져 있습니다. 사이트에서 페이지가 사라져도 문서는 ‘원본에서 사라짐’ 표시와 함께 베이스에 남습니다. 사본이 사이트를 엄격히 따라야 한다면 켜세요.

연결 후 언어 버전 변경(설정 → 언어 버전)은 소스의 구성을 바꿉니다. 이전 버전의 문서는 사이트가 더 이상 업데이트하지 않으므로, LiKE가 처리 방법을 묻습니다: 삭제 또는 내 문서로 남기기(편집 가능해짐). 답하지 않으면 설정이 저장되지 않습니다.

#연결 가능한 사이트와 그렇지 않은 사이트

공개 사이트라면 연결됩니다 — 대부분의 문서 생성기처럼 사이트맵(sitemap)이 있거나, 사이트맵이 없어도 링크 순회로. 그 밖의 경우는 연결한 뒤가 아니라 확인 단계에서 미리 알려 드립니다.

사이트가 연결된 뒤에도 일부 페이지는 제외될 수 있습니다. robots.txt에서 차단된 페이지, 오류를 반환하는 페이지, 10 MB를 넘는 페이지, HTML이 아닌 응답이 그렇습니다. 모두 실행 요약에 사유와 함께 “건너뜀”, “robots.txt에 의해 차단됨”으로 표시됩니다.

파일(PDF, ZIP, 이미지)은 사이트에서 가져오지 않습니다. 이를 위한 별도의 경로가 있습니다 — 자체 처리 방식을 갖춘 파일 가져오기입니다.

#제한

• 조직당 사이트 1개;
• 사이트는 공개여야 합니다. 비밀번호로 보호된 페이지는 읽지 않습니다.
• 사이트맵은 필수가 아닙니다. 없으면 링크 순회가 동작하지만, 사이트가 링크로 연결한 것만 볼 수 있습니다.
• robots.txt를 준수하며, 거기에 지정된 요청 간 대기 시간도 지킵니다.

연결 해제. 동기화가 중단되며, 이미 가져온 문서는 삭제하거나 일반 문서로 남길 수 있습니다. 연결 해제 시 LiKE가 이를 묻습니다.

#연결 후: AI 검색과 사이트 위젯

1. 수집이 끝나면 사이트 페이지는 편집기에서 작성한 문서와 동등하게 LiKE AI 검색에 참여하며, 답변은 원본 페이지로 연결됩니다 — 사이트에서 열기.
2. 귀사 사이트에서 바로 검색하려면 위젯을 만드세요: 통합 → 채널 → JS Widget → 위젯 관리 → 위젯 만들기. 위젯을 넣을 사이트 주소에 이 사이트의 주소를 입력하세요.
3. 위젯 유형을 선택하세요:
   • 공개 — 공개 문서만 검색하며 모든 방문자에게 열려 있습니다. 고객용으로 적합합니다. 이를 위해 사이트 페이지를 공개로 저장하세요(3단계).
   • 기업 — 내부 문서를 포함해 선택한 공간을 검색하며 로그인이 필요합니다. 직원용으로 적합합니다.
4. 검색 범위를 추가하고 위젯을 활성화하세요. 공개 유형은 모든 공개 글 또는 커넥터가 페이지를 넣은 폴더(컬렉션)를 선택합니다. 공개 위젯은 공간 전체를 범위로 지정할 수 없습니다. 기업 유형은 공간 또는 사이트 페이지가 있는 폴더를 선택합니다.
5. 삽입 코드를 복사해 귀사 사이트에 붙여넣으세요. WordPress, Tilda, Wix, Webflow, Squarespace, Shopify, Framer, Google Tag Manager, Docusaurus에서 어디에 넣는지는 API 및 위젯의 웹사이트 빌더에서 코드를 넣는 위치 섹션을 참조하세요.

#파일 가져오기

#파일 업로드

1. 제어판 → Import
2. 파일을 끌어다 놓거나 업로드 영역을 클릭합니다
3. 지원 형식: PDF, DOCX, TXT, MD, RTF, ZIP
4. AI가 각 파일에 대한 제목과 슬러그를 자동으로 생성합니다
5. 게시하기 전에 제목을 편집하거나 편집기에서 열 수 있습니다

#ZIP 아카이브

여러 문서가 포함된 ZIP 아카이브를 업로드하세요 — LiKE가 각 파일을 자동으로 압축 해제하고 처리합니다. 전체 지식 베이스를 마이그레이션하는 데 편리합니다.

ZIP 내부에서 지원되는 파일: PDF, DOCX, TXT, MD, RTF. 다른 파일(이미지, 실행 파일)은 건너뜁니다.

#링크로 가져오기

문서 링크를 붙여넣으세요 — LiKE가 다운로드하여 가져옵니다:

1. 제어판 → Import → "링크로 가져오기" 섹션
2. URL을 붙여넣기 → "추가" 클릭
3. 한 번에 최대 10개의 링크를 추가할 수 있습니다
4. **"가져오기"**를 클릭합니다

지원 소스:

• Google Docs — DOCX로 자동 내보내기
• Google Sheets — CSV로 내보내기
• Dropbox — 직접 파일 링크
• PDF, DOCX, TXT, MD 또는 RTF 파일에 대한 모든 직접 URL

#기본 공개 범위

각 소스에 대해 기본 공개 범위를 구성할 수 있습니다:

• 초안 — 문서가 숨김 상태로 생성됩니다
• 팀 — 인증된 사용자에게 표시됩니다
• 공개 — 익명 사용자를 포함한 모든 사람에게 표시됩니다

Integrations → 소스 카드 → 공개 범위에서 구성합니다.

#접근 채널

채널을 통해 직원들이 익숙한 도구로 정보를 검색할 수 있습니다.

#Slack 봇

기능:

• /like how do I set up SSO? → Slack에서 바로 AI 답변
• 아무 채널에서 @LiKE 멘션 → 스레드에 답변
• 소스 문서 링크(클릭 가능)

#Telegram 봇

봇이 지식 베이스를 바탕으로 팀의 질문에 텔레그램에서 바로 답합니다.

#1단계. 텔레그램에서 봇 만들기

봇은 웹사이트가 아니라 텔레그램 안에서, 서비스 봇 @BotFather를 통해 만듭니다. 텔레그램에서 BotFather를 검색하고 파란색 체크 표시가 있는 계정을 선택하십시오. 비슷한 이름이 많으며 체크 표시만이 진짜임을 알려 줍니다. 대화를 열고 시작을 누른 뒤 일반 메시지로 보내십시오:

/newbot

BotFather가 두 가지를 묻습니다:

1. 표시 이름 — 대화 참여자에게 보입니다. 어떤 언어든 공백도 가능하며, 예를 들어 Lynkora 도우미.
2. 주소 — 검색에서 봇을 찾을 때 쓰입니다. 라틴 문자·숫자·밑줄만 가능하고 반드시 bot으로 끝나야 합니다. 예: lynkora_help_bot.

토큰을 받게 됩니다 — 8123456789:AAEhBOwe… 형태의 문자열입니다. 다음 단계에서 필요합니다. 봇이 이미 있는데 토큰을 잃어버렸다면 /mytoken 명령을 쓰십시오.

#2단계. 봇을 LiKE에 연결

통합 → Telegram 을 열고 Bot Token 칸에 토큰을 붙여 넣은 뒤 연결 을 누르십시오. 소유자 또는 관리자 권한이 필요합니다.

토큰이 거부되면 콜론 앞 숫자를 포함해 문자열 전체를 복사했는지, 양끝에 공백이 없는지 확인하십시오. 다른 봇의 토큰은 사용할 수 없습니다.

연결되면 카드에 봇 주소와 활성 표시가 나타납니다.

#3단계. 답변의 출처 선택

설정 을 누르고 봇이 답변을 가져올 공간 을 지정하십시오. 특정 컬렉션으로 범위를 좁힐 수도 있습니다. 이 설정이 없으면 봇은 어떤 질문에도 모른다고 답합니다.

같은 화면에서 공개 문서만 제공할지 내부 문서까지 제공할지 정합니다. 내부 문서는 질문한 사람이 확인되어야 합니다 — 다음 단계를 보십시오.

#4단계. 봇이 일할 곳 정하기

개인 대화 — 봇과 일대일로 나누는 대화입니다. 누가 쓰는지 봇이 알도록 대화를 계정에 연결합니다. 포털 첫 화면에서 «채팅으로 질문» 을 누르고 «연결 코드 받기» 를 선택한 뒤, 코드를 봇에게 한 번에 보내십시오. 코드는 일회용이며 10분간 유효합니다. 연결 후에는 그 사람의 권한에 따라 내부 문서까지 답합니다. 각자 자신의 대화를 연결합니다.

그룹 대화 — 봇이 모두에게 답하지만 공개 문서로만 답합니다. 공용 대화에서는 누가 질문했는지 알 수 없기 때문입니다.

그룹에서 작동시키려면:

1. 메시지 숨김을 끕니다: BotFather에 /setprivacy 를 보내고 봇을 고른 뒤 Disable 을 누르십시오. 텔레그램은 기본적으로 그룹 메시지를 봇에게 숨기므로 봇이 질문을 전혀 보지 못합니다.
2. 봇을 그룹에서 내보낸 뒤 다시 추가하십시오. 그렇지 않으면 설정이 적용되지 않습니다. 텔레그램은 봇이 들어오는 시점에 이 설정을 적용합니다.
3. 통합 설정에서 그룹 대화를 허용 목록에 추가하십시오.

#5단계. 확인

지식 베이스에 있는 주제로 질문해 보십시오. 답변은 같은 대화에 출처 문서 링크와 함께 도착합니다.

답변 언어는 질문 언어를 따릅니다 — 독일어로 물으면 독일어로 답합니다. «서비스 메시지 언어» 설정은 거절 안내와 연결 확인 등 서비스 메시지에만 적용됩니다.

#연결 해제와 삭제

LiKE에서 연결 해제: 통합 → Telegram → «연결 해제». 봇이 답변을 멈추고 연결이 제거됩니다. 봇 자체는 텔레그램에 남아 다시 연결할 수 있습니다.

봇 교체: 먼저 현재 봇의 연결을 해제한 뒤 새 봇을 연결하십시오. 순서를 바꾸면 이전 봇이 계속 LiKE를 향한 채 아무도 처리하지 않을 메시지를 보냅니다.

봇 완전 삭제: BotFather에서 /deletebot. 되돌릴 수 없습니다 — 주소가 해제되고 봇은 복구할 수 없습니다.

#봇이 답하지 않을 때

#JS 위젯 (귀사의 웹사이트용)

모든 웹사이트에 삽입할 수 있는 플로팅 AI 검색 버튼입니다. 가장 인기 있는 통합입니다 — 사용자가 페이지 모서리의 버튼을 보고 클릭하면 AI와의 채팅 및 지식 베이스 전체 검색이 열립니다.

#간단한 설치

AI 답변 한도를 모두 사용한 경우. 공개 위젯은 페이지에 전혀 표시되지 않습니다 — 버튼도, 한도 메시지도 없으며 단축키도 작동하지 않습니다. 한도가 다시 사용 가능해지면 다음 페이지 로드 시 위젯이 나타납니다.

#기본 매개변수

#Dual-auth: 두 가지 인증 모드 (ADR 0032)

LiKE에서 위젯은 두 가지 모드 중 하나로 작동할 수 있습니다 — 생성 시 선택합니다:

각 모드 구성 및 백엔드 통합에 대한 자세한 내용은 API 및 위젯을 참조하세요.

#Scope: 위젯이 찾을 수 있는 것

위젯을 생성할 때 scope를 설정합니다 — 정확히 무엇을 검색할지:

하나의 위젯 내에서 여러 scope 항목을 결합할 수 있습니다(예: 동일한 스페이스의 두 컬렉션).

#테넌트당 다중 위젯 (ADR 0029 Stage 4)

조직 내에서 서로 다른 scope와 모드를 가진 여러 독립 위젯을 생성할 수 있습니다:

각각 고유한 api-key와 사용 분석을 가지며, 키는 독립적으로 취소할 수 있습니다. 관리는 **통합 → 채널 → JS Widget → "위젯 관리"**에 있습니다.

#세션 관리 (Session JWT 모드)

Session JWT 모드에서는 각 사용자 세션마다 고유한 sessionId가 있습니다. 관리자는 특정 위젯의 활성 세션을 보고 토큰을 강제로 취소할 수 있습니다(예: 침해가 의심되는 경우). 목록은 Integrations → Widgets → [위젯] → Sessions에 있습니다.

#iframe / 직접 링크

전체 LiKE 검색 인터페이스를 모든 페이지에 삽입:

1. Integrations → iframe → 코드 복사
2. <iframe src="...">를 페이지에 붙여넣습니다
3. 또는 직접 링크를 사용하여 이동합니다(임베드가 아닌 전체 페이지)

iframe과 Direct Link도 dual-auth를 지원합니다 — 생성 시 선택합니다.

#REST API

프로그래밍 방식 통합을 위한 전체 API(예: 자체 UI 또는 다른 시스템과의 통합):

1. 통합 → Public API → "키 생성"
2. 이름과 허용 도메인을 지정합니다
3. 키를 복사합니다 — 한 번만 표시되며, 다시 열면 마스킹됩니다

X-API-Key 헤더로 키를 사용하세요. 키로는 공개 문서만 제공됩니다.

주요 엔드포인트:

제한: 요청은 키별로 제한되며, 초과 시 Retry-After 헤더와 함께 HTTP 429가 반환됩니다.

전체 API 문서: API 및 위젯.

#언어

LiKE는 AI 검색 및 교차 언어 검색을 위해 25개 이상 언어를 지원합니다(인터페이스 자체는 12개 UI 로케일로 제공됩니다):

Русский, English, Deutsch, Français, Español, Português, Italiano, Nederlands, Polski, Čeština, Svenska, Dansk, Suomi, Română, Magyar, Hrvatski, Türkçe, Afrikaans, Kiswahili, Bahasa Indonesia, Tiếng Việt, Українська, Српски, Български, Ελληνικά, 한국어, 日本語, 中文, हिन्दी, ไทย, עברית, العربية.

교차 언어 검색: 한 언어로 된 질문 → 다른 언어로 된 문서에서의 답변.