카카오톡 채널 연동#
STORM을 카카오톡 채널에서 챗봇으로 쓰기 위한 설정 방법입니다. 카카오 챗봇 관리자센터의 봇 ID를 STORM에 등록해 API 키를 발급받고, 그 키를 카카오 스킬에 연결한 뒤 배포하면 됩니다.2.
STORM에서 카카오톡 채널 생성 → 봇 ID 입력 → 연동하기 → API 키 발급
3.
카카오 챗봇 관리자센터에서 스킬 생성 (STORM Endpoint + API 키 입력)
4.
폴백 블록에 스킬 연결 및 Callback 설정
1️⃣ 봇 ID 확인하기 (카카오 챗봇 관리자센터)#
STORM과 연결할 카카오 챗봇의 봇 ID를 확인합니다.2.
좌측 메뉴에서 설정 → 챗봇 관리 탭으로 이동합니다.
2️⃣ STORM에서 카카오톡 채널 생성하기#
채널 연동 메뉴에서 채널 추가하기 버튼을 클릭해 새 채널을 생성합니다.
아래 항목을 순서대로 입력한 뒤 연동하기를 클릭합니다.
채널 이름#
카카오톡과 연동할 채널의 이름을 입력합니다. 채널 이름은 STORM 내에서 해당 카카오톡 연결을 구분하기 위한 식별자 역할을 합니다.Endpoint#
카카오 스킬에서 호출할 STORM의 엔드포인트입니다. 자동으로 채워지며, 3단계 스킬 생성 시 그대로 사용하므로 복사 버튼으로 복사해 둡니다.Endpoint: https://live-stargate.sionic.im/kakaotalk/event
폴더 지정#
카카오톡 채널이 참조할 지식 문서의 범위를 지정합니다. 지정된 폴더 내의 문서만 검색하여 STORM이 응답을 생성하게 되며, 폴더를 지정하지 않으면 전체 문서를 대상으로 검색이 이루어집니다.API 키#
연동하기 버튼을 누르면 API 키가 발급됩니다. 발급된 키는 복사 버튼으로 복사해 두고, 3단계에서 카카오 스킬의 헤더 값으로 입력합니다.API 키는 연동하기를 누른 뒤에 생성됩니다. 연동 전에는 API 키 항목이 비어 있는 것이 정상입니다.
Bot id#
3️⃣ 스킬 만들기 (카카오 챗봇 관리자센터)#
카카오톡에 들어온 질문을 STORM으로 전달하는 스킬을 생성합니다.1.
카카오 챗봇 관리자센터에서 스킬 → 스킬 목록 → 스킬 생성을 클릭합니다.
2.
스킬명을 입력합니다. (예: STORM 콜백 스킬)
3.
URL에 STORM의 Endpoint를 입력합니다.URL: https://live-stargate.sionic.im/kakaotalk/event
4.
Value: 2단계에서 발급받은 STORM API 키
4️⃣ 폴백 블록 설정하기#
카카오톡으로 사용자의 질문이 들어오면 폴백 블록에 매칭되어 3단계에서 만든 스킬을 호출하도록 설정합니다.스킬 선택 및 봇 응답 설정#
2.
파라미터 설정의 스킬 검색/선택에서 3단계에서 생성한 스킬을 선택합니다.
3.
봇 응답에 기본으로 들어 있는 텍스트 응답을 모두 삭제합니다.
봇 응답에 텍스트 응답이 남아 있으면 STORM의 답변 대신 해당 텍스트가 전송됩니다. 반드시 스킬데이터만 남겨 주세요.
Callback 설정#
1.
폴백 블록 우측 상단의 ··· 버튼 → Callback 설정을 클릭합니다.
2.
callbackUrl을 발행합니다 토글을 켭니다.
3.
필요한 경우 응답대기 메시지를 입력합니다. STORM이 답변을 생성하는 동안 사용자에게 먼저 전송되는 메시지입니다. 카카오 스킬의 기본 응답 제한 시간은 5초입니다. STORM의 답변 생성에는 5초 이상 걸릴 수 있으므로 Callback 설정을 반드시 켜 주세요.
5️⃣ 카카오 챗봇 배포하기#
1.
카카오 챗봇 관리자센터에서 배포 메뉴를 클릭합니다.
2.
우측 상단 배포 버튼을 누르고, 확인 팝업에서 다시 배포를 클릭합니다.
저장하지 않은 내용은 배포에 적용되지 않습니다. 스킬과 폴백 블록이 모두 저장되었는지 확인한 뒤 배포해 주세요.
이후 스킬(API 키, URL)이나 폴백 블록 설정을 변경한 경우에도 반드시 다시 배포해야 반영됩니다.
✅ 카카오톡에서 사용하기#
배포가 완료되면 카카오톡에서 해당 채널과의 채팅방에 질문을 입력해 STORM 에이전트의 답변을 받을 수 있습니다.