sambot에서 가져오기
sambot에서 반응, 레이블, 파일, 대화를 옮기는 방법. 아카이브에 들어 있는 내용과 추가 모드와 교체 모드의 차이를 설명합니다.
이 페이지에서
sambot.ru에서 옮겨 오려면 먼저 봇 데이터를 아카이브로 내려받은 다음 GetMyBot에 업로드합니다. 반응, 레이블, 이미지, 파일을 옮길 수 있습니다. 대화 기록은 별도의 아카이브로 업로드합니다.
명령줄을 쓰지 않는다면 Chrome 확장 프로그램을 선택하세요. 자동으로 내보내려면 Python 내보내기 도구를 쓸 수 있습니다. 이전을 마친 뒤에는 고객을 봇으로 안내하기 전에 봇과의 채팅에서 명령, 버튼, 파일이 제대로 동작하는지 확인하세요.
이전되는 항목
- 반응: 봇의 전체 동작.
- 레이블: 색상이 지정된 구독자 태그.
- 미디어: 반응이 참조하는 이미지와 파일.
- 대화 기록: 봇과 사용자가 주고받은 대화(별도 아카이브).
반응 아카이브 가져오기
반응 아카이브의 이름은 mybot-export.zip입니다. 반응 섹션에서 아카이브 가져오기를 누르고 파일과 업로드 모드를 선택합니다. API로는 POST /api/bots/{id}/reactions/import를 사용합니다. 기술 문서에서는 이 아카이브를 번들이라고도 부릅니다. 아카이브 내용:
manifest.json: 헤더. 형식 버전, 소스(sambot), 봇 이름, 내보낸 날짜, 카운터가 들어 있습니다.reactions.json: 반응 배열(필수).labels.json: 레이블 목록(선택).media/<sha256>.<ext>: 미디어 파일(선택).
두 가지 모드를 사용할 수 있습니다.
- 추가 (
append): 아카이브의 반응이 현재 반응에 더해집니다. - 교체 (
replace): 봇의 현재 반응을 삭제한 뒤 아카이브에서 반응을 불러옵니다.
반응 아카이브의 압축을 푼 파일 전체 크기는 64 MiB로 제한됩니다.
대화 기록 가져오기
대화 기록은 별도의 아카이브 mybot-dialogs.zip으로 옮깁니다. 이 아카이브에는 사용자 프로필과 첨부 파일이 포함된 메시지가 들어 있어서, 가져오기가 끝나면 지난 대화가 바로 사용자 섹션에 표시됩니다.
아카이브는 세 가지 방법으로 업로드할 수 있습니다.
- 대화 권한이 있다면 사용자 섹션의 "기록 가져오기" 버튼으로 업로드합니다.
- API:
subscribers:write범위의 개인 토큰으로POST /api/bots/{id}/dialogs/import(multipart,file필드)를 호출합니다. 가져오기 진행 상황은GET /api/bots/{id}/dialogs/import/{import_id}로 확인합니다. - MCP:
import_dialogs도구가 최대 48 MB의 아카이브를 base64로 받고,get_dialog_import가 상태를 반환합니다.
가져오기는 백그라운드에서 진행되며 누구에게도 아무것도 보내지 않습니다. 이미 업로드된 tg_message_id를 가진 메시지는 건너뛰므로, 아카이브를 다시 업로드하거나 나누어 업로드해도 됩니다. 대화 기록은 기한 없이 보관됩니다.
대화 아카이브의 압축을 푼 파일 전체 크기는 256 MiB로 제한됩니다.
내보내기 도구 (Python)
tools/sambot_export 패키지는 sambot.ru에 있는 봇 페이지를 읽고 파일을 내려받아 ZIP 아카이브를 만듭니다. 접근하려면 이미 열려 있는 브라우저 세션의 데이터가 담긴 쿠키 파일이 필요합니다. 개발자용 명령은 tools/sambot_export 디렉터리에서 실행합니다: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.
- 기본적으로 반응, 레이블, 미디어를 내보냅니다.
--mode dialogs모드는 대화 기록을 별도의mybot-dialogs.zip으로 내보냅니다.- 인증은 이미 열려 있는 브라우저 세션의 쿠키로만 가능합니다. 로그인 양식이 자동 요청을 막도록 보호되어 있어서 비밀번호는 사용할 수 없습니다.
Chrome 확장 프로그램
명령을 실행하고 싶지 않다면 Chrome 확장 프로그램 **"GetMyBot: sambot에서 내보내기"**를 사용하세요. 이 확장 프로그램은 sambot.ru 페이지에서 바로 봇을 내보냅니다. 활성 탭과 다운로드에 대한 접근 권한을 요청하고, https://sambot.ru/*에서 동작하며, 세션 쿠키는 브라우저 밖으로 나가지 않습니다. 확장 프로그램은 GetMyBot으로 가져올 수 있는 같은 ZIP 아카이브를 만듭니다.
이전 순서
- 내보내기 도구나 확장 프로그램으로 봇을 내보냅니다. 그러면
mybot-export.zip(필요하면mybot-dialogs.zip도)을 받게 됩니다. - 반응 아카이브를 봇으로 가져옵니다("추가" 또는 "교체" 모드).
- 필요하면 대화 기록을 가져옵니다.
- 반응과 레이블을 확인합니다. 파일을 옮겼다면 미디어 라이브러리도 확인합니다.