블로그로 돌아가기
Tech Insight2026년 11월 22일178

카카오톡 챗봇 만들기 2026 — 오픈빌더는 「챗봇 관리자센터」가 됐고, 갈림길은 스킬 서버 5초다

카카오톡 챗봇 만들기는 시나리오와 스킬 서버로 갈린다. 오픈빌더는 「챗봇 관리자센터」가 됐고, LLM 을 붙이면 스킬 타임아웃 5초에 막힌다. 콜백은 5분·1회, 말풍선은 3개, simpleText 는 500자에서 접힌다. 비즈 채널 인증 요건과 비용 축까지 공식 문서 수치로 정리했다.

카카오톡 챗봇 만들기는 두 갈래다. 하나는 챗봇 관리자센터에서 블록과 시나리오를 눌러 만드는 길이고, 다른 하나는 스킬(skill) 서버를 띄워 우리 서버가 답을 만들어 보내는 길이다. 예전에 「카카오 i 오픈빌더」로 불렸던 그 도구가 지금은 챗봇 관리자센터라는 이름으로 같은 자리에 있다. 둘을 가르는 기준은 기능 목록이 아니라 응답 시간이다. 카카오 챗봇 플랫폼의 스킬 처리시간 SLA 는 5초이고, LLM 을 붙이는 순간 그 5초는 거의 항상 모자란다. 그래서 「카톡 봇 만들기」의 실제 설계 질문은 "시나리오로 될 일인가, 스킬 서버로 넘길 일인가, 넘긴다면 콜백을 쓸 것인가"로 좁혀진다. 이 글은 공식 문서에서 확인한 수치만으로 그 갈림길을 정리한다.

이름부터 확인하고 시작한다 — 오픈빌더는 어디로 갔나

검색하면 아직 「카카오 i 오픈빌더」 기준으로 쓴 글이 많이 나온다. 2026-11-22 에 직접 확인한 결과는 이렇다.

  • 공식 문서군(kakaobusiness.gitbook.io/main/tool/chatbot)은 도구 이름을 「챗봇 관리자센터」로 적는다. 문서 어디에도 「카카오 i 오픈빌더」라는 표기는 남아 있지 않다.
  • 옛 주소 i.kakao.com/openbuilder 를 열면 페이지 제목(<title>)이 「챗봇 관리자센터」다. chatbot.kakao.com 도 같은 제목을 돌려준다.
  • 공식 소개 문장은 "'챗봇 관리자센터'는 카카오 인공지능 기술을 이용하여 카카오톡 채널 챗봇과 카카오미니 보이스봇을 동시에 설계할 수 있는 카카오 AI 설계 플랫폼입니다"다.

즉 제품이 사라진 것이 아니라 이름이 바뀐 것이고, 주소는 그대로 살아 있다. 외주 견적서나 사내 기획서에 「오픈빌더로 구축」이라고 적혀 있어도 가리키는 대상은 같다. 다만 문서를 찾을 때는 새 이름으로 찾아야 원문이 나온다.

하나 더. 챗봇은 카카오톡 채널에 붙어서 동작한다. 채널 없이 챗봇만 따로 쓰는 경로는 없다. 그래서 「카카오톡 챗봇 만들기」는 사실상 "채널 만들기 + 봇 설계 + (필요하면) 스킬 서버"의 세 묶음이다.

시나리오로 할 일과 스킬 서버로 넘길 일 — 어디서 갈리나

챗봇 관리자센터 안에서 블록에 답을 직접 적어 두면 서버가 필요 없다. 반대로 주문 조회, 재고 확인, 사내 문서 검색, LLM 답변처럼 그때그때 값이 달라지는 답은 스킬 서버로 넘겨야 한다. 판단 기준을 표로 고정해 두면 회의가 짧아진다.

조건시나리오(블록)로스킬 서버로
답이 미리 정해져 있다✅ 블록에 그대로 적는다과설계
사용자마다 답이 다르다❌ 분기만 늘어난다✅
외부 시스템(ERP·DB·API) 조회❌✅
LLM·RAG 로 답을 생성한다❌✅ (콜백 필요)
응답이 1초 안에 끝난다✅✅
응답이 5초를 넘긴다—✅ 콜백 필수
운영 인력이 직접 문구를 고친다✅ 관리자센터에서 수정배포가 필요하다
말풍선 3개를 넘겨 보내고 싶다불가(블록당 최대 3)불가(응답도 최대 3)

마지막 줄이 설계에서 자주 걸린다. 스킬 서버를 쓰면 무엇이든 보낼 수 있다고 생각하기 쉬운데, 말풍선 개수 상한은 두 경로에서 똑같다. 아래에서 다시 본다.

5초 벽 — LLM 을 붙이면 반드시 만난다

공식 콜백 가이드는 "카카오 챗봇 플랫폼의 스킬의 처리시간 SLA(skill timeout: 5sec) 초과될 때에도 응답을 받아올 수 있습니다"라고 적는다. 즉 기본 타임아웃은 5초이고, 그걸 넘기려면 콜백을 써야 한다.

이게 왜 중요한가. 요즘 쓰는 조합 — 사용자 발화를 임베딩해 사내 문서를 찾고, 그 문서를 프롬프트에 넣어 LLM 에 물어보고, 답을 다듬어 돌려주는 흐름 — 은 검색 0.3~1초, 생성 3~15초다. 생성 모델이 길게 답하면 5초는 그냥 지나간다. 콜백 없이 올리면 운영 첫날부터 간헐적 무응답이 난다. 평소에는 짧게 답해서 통과하다가, 질문이 길어진 순간부터 깨지므로 테스트에서 안 잡히는 종류의 고장이다.

콜백은 이렇게 동작한다.

  1. 챗봇 관리자센터에서 해당 블록의 콜백 설정을 켠다.
  2. 그 블록의 요청에는 userRequest.callbackUrl 이 담겨 온다. 콜백이 꺼진 블록에는 이 값이 없다.
  3. 스킬 서버는 5초 안에 「생각하는 중」 같은 대기 응답을 먼저 돌려준다. 이때 최상위에 "useCallback": true 를 넣는다.
  4. 실제 답이 완성되면 callbackUrl 로 HTTP POST 한다. 본문 형식은 평소 스킬 응답과 같고, 그 내용이 사용자에게 다음 말풍선으로 나간다.

제약이 둘 있고, 둘 다 설계를 바꾼다.

  • 유효시간 5분: "콜백URL은 … 일정시간(callbackUrl valid time: 5min)동안 유효하며 1회에 한하여 사용할 수 있습니다." 5분을 넘기면 만료다.
  • 1회 한정: 진행 상황을 여러 번 밀어 넣는 식의 스트리밍은 안 된다. 긴 작업은 "다 되면 알려 드릴게요" 쪽으로 설계하고, 중간 보고가 필요하면 알림톡 같은 다른 경로를 쓴다.

테스트 단계에서 한 번 더 걸린다. 공식 문서는 "테스트 환경(봇테스트, 채널 커스텀 유효성 테스트)의 callback token은 사용할 수 없습니다"라고 적고, "봇테스트에서는 스킬 응답 v2를 사용하는 경우에만 콜백 응답을 확인할 수 있습니다"라고 덧붙인다. 콜백은 실제 채널에 붙여서 검증해야 한다는 뜻이다. 그래서 개발 채널을 미리 하나 만들어 두는 편이 낫다.

최소 스킬 서버 — 받는 모양과 보내는 모양

스킬 서버는 특별한 SDK 가 필요 없다. HTTPS 로 POST 를 받아 정해진 JSON 을 돌려주는 엔드포인트 하나면 된다. 받는 쪽(SkillPayload)의 주요 필드는 intent, userRequest, bot, action, flow 다. 실무에서 쓰는 건 보통 두 개다.

  • userRequest.utterance — "봇 시스템에 전달된 사용자의 발화"
  • action.params — 블록에서 뽑은 엔티티가 이름을 키로 들어온다(action.detailParams 는 상세형)

보내는 쪽은 version / template / context / data 네 부분이고, version 은 현재 "2.0" 만 지원한다. 문서는 "version이 없다면 구 버전의 응답으로 간주하기 때문에, 항상 version을 포함해야 합니다"라고 경고한다. 가장 단순한 응답은 이렇다.

{
  "version": "2.0",
  "template": {
    "outputs": [
      { "simpleText": { "text": "간단한 텍스트 요소입니다." } }
    ]
  }
}

파이썬으로 즉시 응답형을 띄우면 이 정도다.

from fastapi import FastAPI, Request

app = FastAPI()

def simple_text(text: str) -> dict:
    return {"version": "2.0",
            "template": {"outputs": [{"simpleText": {"text": text[:980]}}]}}

@app.post("/skill")
async def skill(req: Request):
    body = await req.json()
    utterance = body["userRequest"]["utterance"]
    params = body.get("action", {}).get("params", {})
    answer = lookup(utterance, params)
    return simple_text(answer)

LLM 을 붙이는 콜백형은 여기서 두 조각이 늘어난다. 먼저 대기 응답을 돌려주고, 백그라운드에서 답을 만들어 callbackUrl 로 POST 한다.

import httpx
from fastapi import BackgroundTasks

@app.post("/skill-llm")
async def skill_llm(req: Request, bg: BackgroundTasks):
    body = await req.json()
    cb = body["userRequest"].get("callbackUrl")
    utterance = body["userRequest"]["utterance"]
    if not cb:
        return simple_text("이 블록은 콜백이 꺼져 있습니다.")
    bg.add_task(answer_later, cb, utterance)
    return {"version": "2.0", "useCallback": True,
            "data": {"text": "찾아보고 있어요. 10초쯤 걸립니다."}}

async def answer_later(cb: str, utterance: str):
    text = await generate(utterance)
    async with httpx.AsyncClient(timeout=20) as c:
        await c.post(cb, json=simple_text(text))

text[:980] 로 자른 이유는 다음 절에 있다.

말풍선 제한이 설계를 바꾼다 — 숫자로 먼저 본다

응답 포맷 문서에 적힌 상한을 모아 두면 기획서를 고칠 일이 줄어든다. 아래는 공식 문서의 값이다.

항목상한
template.outputs 개수1개 이상 3개 이하
template.quickReplies 개수10개 이하
simpleText.text1,000자 (500자 초과분은 접히고 「전체 보기」로 펼친다)
응답 1개당 크기30,720 bytes 초과 시 발송되지 않음
블록당 연속 응답최대 3개
바로연결 버튼블록당 1개 · 버튼당 14글자 · 최대 10개
카드 버튼가로 최대 2개 · 세로 최대 3개
listCard.items최대 5개(케로셀형 4개)
basicCard.description최대 230자
user.id최대 70자

LLM 을 붙일 때 실제로 걸리는 건 500자 접힘이다. 1,000자까지 들어가긴 하지만 사용자가 처음 보는 건 500자뿐이다. 그러니 생성 프롬프트에 "핵심을 400자 안에 먼저 쓰고, 상세는 그 뒤에"를 넣는 쪽이 UI 설계보다 효과가 크다. 모델에게 길이를 맡기면 거의 매번 접힌다.

30,720 bytes 제한도 조용히 걸린다. 문서는 "스킬 응답의 경우, 사용자가 입력한 JSON 사이즈와 실제 발송되는 응답의 사이즈가 상이할 수 있습니다"라고 적어 둔다. 검색 결과를 카드로 10개 밀어 넣는 설계는 여기서 막힌다 — 애초에 outputs 가 3개까지라 그 설계 자체가 성립하지 않는다.

운영에 올리려면 — 인증 두 개가 선행 조건이다

테스트는 쉽고 운영이 어렵다. 실서비스 채널에 봇을 붙이려면 공식 문서가 말하는 두 인증이 둘 다 필요하다.

"봇을 제작하는 마스터가 [카카오톡 채널 관리자센터]에서 비즈 카카오톡 채널 인증을 받고 [카카오 디벨로퍼스]에서 비즈앱 인증을 각각 받습니다. 그리고 [카카오 디벨로퍼스]에서 위에서 만든 비즈니스 인증 채널 및 비즈 앱을 연결해줍니다."

여기서 실무가 막히는 지점이 셋이다.

  1. 주체가 「마스터」다. 채널 마스터와 디벨로퍼스 앱 소유자가 다른 사람이면 연결 단계에서 멈춘다. 외주로 맡길 때 가장 자주 터지는 자리이므로 킥오프에서 계정 주인을 먼저 확정한다.
  2. "카카오 로그인 활성화" ON 이 필수다. 문서가 명시한다. 꺼져 있으면 연결이 안 된다.
  3. 인증 채널은 실제 서비스용 채널로 신청해야 한다. 문서는 "비즈니스 인증 채널을 신청하실 때에는 실제 서비스에서 사용할 카카오톡 채널로 신청해야 합니다"라고 적는다. 테스트 채널로 심사를 받아 두고 나중에 바꾸는 경로가 아니다.

개발/테스트는 개발 채널로 분리한다. 문서는 운영 채널을 "실 서비스 목적의 카카오톡 채널", 개발 채널을 "개발 및 테스트 목적의 카카오톡 채널"로 정의하고, 배포 전 상태의 봇을 개발 채널에 붙여 내부 테스트할 수 있다고 설명한다. 그리고 봇 상태는 "봇 생성 후, 한 번도 배포한 적이 없는 경우: 준비", "첫 번째 배포 후, 정상적으로 봇이 작동하는 경우: 실행"으로 적혀 있다 — 한 번은 배포해야 운영 채널과 연결된다.

일정으로 옮기면 이렇다. 봇 설계와 스킬 서버는 2~3주면 1차가 돌지만, 비즈 채널·비즈앱 심사는 우리가 통제할 수 없는 구간이다. 그래서 외주 일정표에서는 인증을 가장 앞에 둔다. 개발을 먼저 끝내 놓고 심사를 기다리면 그 주간은 통째로 비는 주가 된다.

돈은 어디서 나가나

카카오톡 챗봇의 비용은 한 덩어리가 아니다. 공식 문서에서 확인되는 것과 확인되지 않는 것을 갈라 둔다.

항목공식 문서 기준
챗봇 관리자센터 이용료문서에 금액 표기 없음 (읽은 문서군에 요금 페이지가 없다)
채널 메시지 발송캐시 충전 방식 · "메시지 건당 비용은 15원, 20원(VAT별도)발생합니다"
메시지 발송 선행 조건캐시 충전 + 비즈월렛 생성
스킬 서버우리 쪽 비용 (서버·트래픽)
LLM 호출우리 쪽 비용 (토큰 과금)

주의할 점. 위 15원·20원은 채널 메시지 발송 단가이고, 문서가 어떤 메시지 유형에 어느 금액이 붙는지는 설명하지 않는다. 그러니 견적에 쓸 때는 "건당 15~20원(VAT 별도) 구간"으로 적고 유형별 단가는 발송 직전에 채널 관리자센터에서 확인하는 쪽이 안전하다. 그리고 사용자가 봇에게 말을 걸어 답하는 대화 자체는 이 발송 과금과 다른 축이다 — 우리가 먼저 보내는 메시지가 과금 대상이다.

실제 총비용에서 가장 크게 움직이는 건 보통 LLM 토큰이다. 문의가 하루 300건이고 한 건에 입력 2,000 · 출력 500 토큰이면 월 2,250만 토큰이다. 모델을 한 단계 내리거나, 자주 오는 질문 상위 20개를 블록 응답으로 빼면 호출 자체가 줄어든다. 「전부 LLM」은 품질이 아니라 청구서 문제로 먼저 돌아온다.

흔한 실패 3개

1. 콜백 없이 LLM 을 붙인다. 가장 많다. 데모에서는 짧게 답해 5초를 통과하고, 운영에서 질문이 길어지면 무응답이 섞인다. 재현이 안 되는 버그로 2~3주를 쓰는 경우를 봤다. LLM 이 끼면 블록 콜백 설정부터 켜고 시작한다.

2. 말풍선 상한을 모르고 기획한다. "검색 결과 10건을 카드로 보여 준다" 같은 요구가 기획서에 그대로 들어간다. outputs 는 3개까지, listCard.items 는 5개까지다. 상한을 먼저 공유하면 "상위 3건 + 더보기 링크"로 요구가 자연스럽게 정리된다.

3. 인증을 마지막에 둔다. 비즈 채널·비즈앱 인증 주체가 「마스터」라는 걸 모르고, 외주사 계정으로 앱을 만들어 두고 고객사 채널에 붙이려다 멈춘다. 계정 소유 구조는 개발 착수 전에 문서로 확정한다.

어디까지 직접 하고 어디서부터 사람을 붙일까

블록 몇 개로 끝나는 안내봇은 직접 만드는 게 맞다. 관리자센터에서 문구를 고칠 수 있어 운영이 가볍다. 반대로 사내 데이터가 답에 들어가는 순간 성격이 바뀐다. 문서 수집·분할·임베딩, 검색 품질 평가, 5초 벽을 넘기는 콜백 설계, 오답 모니터링이 한 묶음으로 따라온다. 이쪽은 RAG 챗봇 개발 가이드에서 구성요소를 따로 정리했다.

트리숲은 그 전환을 진단부터 돌아가는 상태까지 한 번에 맡는 쪽을 택했다. 카톡 봇은 그 전환에서 가장 자주 첫 번째로 붙는 표면이다 — 팀이 이미 쓰는 메신저 위에 올라가기 때문이다. 실제로 MCP 로 만든 뉴스 수집·카톡 배포 시스템을 사내에서 돌리고 있고, 그 과정은 AI 뉴스 수집·카톡 배포 시스템 사례에 적어 뒀다.

FAQ

Q: 카카오톡 챗봇 만들기, 코딩 없이 가능한가요?

가능합니다. 챗봇 관리자센터에서 블록과 시나리오를 만들어 답을 직접 적어 두면 서버가 필요 없습니다. 다만 사용자마다 답이 달라지거나 외부 시스템을 조회해야 하면 스킬 서버가 필요하고, 그때부터는 개발이 들어갑니다. 경계는 "답이 미리 정해져 있는가"입니다.

Q: 카카오 i 오픈빌더는 없어진 건가요?

이름이 바뀌었습니다. 공식 문서는 「챗봇 관리자센터」로 적고, 옛 주소 i.kakao.com/openbuilder 도 같은 제목의 페이지를 돌려줍니다(2026-11-22 확인). 제품과 주소는 살아 있으니, 문서를 찾을 때만 새 이름으로 검색하면 됩니다.

Q: 스킬 서버 응답은 몇 초까지 기다려 주나요?

기본 스킬 처리시간 SLA 는 5초입니다. 그보다 오래 걸리면 콜백을 써야 하고, 콜백 URL 은 5분 동안 1회만 쓸 수 있습니다. LLM 으로 답을 생성하는 봇은 사실상 콜백이 필수입니다.

Q: 챗봇을 운영 채널에 붙이려면 무엇이 필요한가요?

마스터 계정이 카카오톡 채널 관리자센터에서 비즈 채널 인증을, 카카오 디벨로퍼스에서 비즈앱 인증을 각각 받고 둘을 연결해야 합니다. 디벨로퍼스 앱의 "카카오 로그인 활성화"가 켜져 있어야 하고, 봇은 한 번 배포해야 채널과 연결됩니다.

Q: 비용은 어떻게 잡아야 하나요?

세 축으로 나눕니다. 채널 메시지 발송은 캐시 충전 방식으로 건당 15~20원(VAT 별도) 구간이고 비즈월렛이 필요합니다. 스킬 서버와 LLM 호출은 우리 쪽 비용입니다. 챗봇 관리자센터 자체의 이용료는 공식 문서에 금액 표기가 없어, 견적서에는 확인된 항목만 올리는 편이 안전합니다.


출처

  • 카카오비즈니스 · 챗봇 관리자센터 — 응답 타입별 JSON 포맷: <https://kakaobusiness.gitbook.io/main/tool/chatbot/skill_guide/answer_json_format>
  • 카카오비즈니스 · AI 챗봇 콜백 개발 가이드: <https://kakaobusiness.gitbook.io/main/tool/chatbot/skill_guide/ai_chatbot_callback_guide>
  • 카카오비즈니스 · 봇 설정(운영/개발 채널, 인증): <https://kakaobusiness.gitbook.io/main/tool/chatbot/main_notions/bot_setting>
  • 카카오비즈니스 · 응답 설정(응답 사이즈·말풍선 스펙): <https://kakaobusiness.gitbook.io/main/tool/chatbot/main_notions/setup_answer>
  • 카카오비즈니스 · 카카오톡 채널 운영 가이드(메시지 비용): <https://kakaobusiness.gitbook.io/main/partner/smb/channel>

카카오톡 챗봇을 어디까지 직접 만들고 어디서부터 맡길지 정하기 어렵다면, AI 챗봇 개발 서비스 페이지에 유형별 비용·기간 구간을 공개해 뒀다. 그 표를 기준으로 범위를 먼저 자르는 쪽을 권한다.

관련 서비스: RAG 챗봇, 직접 구축해드립니다