본문으로 건너뛰기

톡브릿지 제품 사실 정본 (TalkBridge Product Facts)

이 문서는 원고에 쓰는 사실의 기준이다. 문서는 바뀐다 — 원고에 쓰기 전 해당 URL을 다시 연다. 출처: 홈 https://talkbridge.io/ · 문서 https://api.talkbridge.io/ · 확인 2026-09-12. 여기 없는 사실은 "미확인"이다. 추측으로 채우지 않는다.

한 줄​

톡브릿지는 카카오 상담톡으로 들어오는 고객 상담을, 팀이 원하는 곳(Discord · Slack · 자체 시스템 · AI 앱)으로 잇는 통합 브릿지다. 홈 문구: "연결은 톡, 응대는 딸깍!" / "쉬운 연결, 쉬운 상담" / "카카오 상담을 원하는 곳으로 연결합니다".

쉽게 말해, 고객은 평소처럼 카카오톡에서 채널로 말을 걸고, 달라지는 것은 응대하는 팀 쪽 도구뿐이다 (FAQ).

연동 방식 — 셋 (+ 간편 연동)​

방식누구에게무엇으로문서
MCP (노코드)코딩 없이 상담을 운영하려는 파트너Claude 데스크톱 / ChatGPT에 커넥터 주소 추가 → 대화로 채널 연결·상담 조회·응대·AI 상담 운영https://api.talkbridge.io/mcp/intro/ · /mcp/connect/ · /mcp/usage/
간편 연동 (노코드)Discord/Slack을 쓰는 팀설치 버튼으로 자동 연결. 상담 1건 = Discord 스레드 1개, Slack은 Socket Mode 양방향홈 · /cli/gateway/ (호스티드 게이트웨이)
CLI터미널·스크립트·자동화, 보안 요건이 엄격한 팀talkbridge 명령. 발신·설정·게이트웨이 관리, --json 한 줄 출력/cli/install/ · /cli/setup/ · /cli/commands/ · /cli/gateway/
API / 웹훅자체 시스템에 붙이는 개발자REST 발신·설정 API + HMAC 서명 웹훅 수신/getting-started/ · /authentication/ · /api/outbound/ · /webhooks/setup/

홈의 표현: 직접 연동 = "Bypass/개발자 모드", 간편 연동 = "Bridge/노코드 모드". 홈 주장: "최소 3분이면 연결 완료"(기존 3일 대비), 3단계 = 채널 인증 → 연결 키 발급 → 봇 설치.

톡브릿지 센터 — 설정 5단계 (문서 /center/setup-status/)​

  1. 브랜드 생성
  2. 카카오 채널 등록 — 브랜드에 카카오 채널 추가
  3. 채널 인증 — 관리자 휴대폰 인증번호
  4. 상담 수신처 연결 — Discord / Slack / Webhook 중 선택
  5. 상담 활성화 — 토글. 상담 수락과 수신처 자동 전달을 함께 제어
  • 결제 없이 5단계 완료 가능 (가입 시 Free 자동 적용, 카드 등록 불필요)
  • 미완료 단계가 있으면 사이드바에 "설정 필요" 배지
  • 카카오 비즈니스 채널 심사 대기 중이어도 진행 상황이 저장되어 멈춘 단계부터 이어감

카카오 채널 준비 (문서 /kakao-channel/ — 카카오 몫)​

  • 카카오톡 채널 보유(없으면 카카오비즈니스에서 무료 개설) → 비즈니스 채널 전환·인증 심사(통상 1~3영업일, 서류는 신청자 유형별) → 채널 공개·검색 허용 → 채널명·검색용 아이디·채널 URL 확인
  • 카카오 절차 문의는 카카오 고객센터(cs.kakao.com), 톡브릿지 기술 문의는 help@talkbridge.io
  • ⚠ 홈 요약에는 심사 "3~5일"로도 적혀 있다 — 원고에는 "며칠(카카오 심사 기준)"으로 쓰고 특정 일수는 단정하지 않는다

MCP로 할 수 있는 것 (문서 /mcp/usage/)​

4단계 운영: ① 채널 연결(처음 1회 — 채널 추가 → 인증 → 상담톡 활성화 → 수신 연결, AI가 단계별 안내) ② 상담 조회("지금 상담 중인 고객들 보여줘") ③ 상담 응대(답장 발송·상담 종료·고객 차단) ④ AI 상담 서포터 — AI가 문의를 읽고 맥락에 맞게 답을 써서 카카오로 발송. "정중하고 친절하게, 환불은 3~5영업일 안내 포함" 같은 지침만 주면 된다.

  • 연결: Claude — 설정 → 커넥터 → 커스텀 커넥터 추가 / ChatGPT — 설정 → 커넥터 → 새로 추가 → MCP 서버 (개발자 모드, Plus/Pro/Team 필요). 값은 센터 AI 도구 연결 화면에서 복사 (/center/ai-tools/)
  • 연결 확인: "내 브랜드 목록 보여줘"에 도구가 응답하면 성공 (센터가 직접 확인해 주지 않는다)
  • 보안: 파트너 계정으로 로그인, AI는 그 계정이 관리하는 브랜드만 접근
  • OpenAI dots에서도 동작 (2026-10-06 사용자 실사용 확인): dots(2026-09-29 DevDay, ChatGPT Pro·Business Premium)는 계정에 연결한 ChatGPT 플러그인을 쓰므로, ChatGPT 앱에서 플러그인(MCP) 연결만 하면 dot이 상담방 조회·대화 분석을 한다(사용자 확인). 연결: 설정 → 커넥터(앱·도구 추가) → 새로 추가 → MCP 서버 https://mcp.talkbridge.io/mcp → Google 로그인 1회, 키 불필요. 확인 문구 "내 파트너 정보랑 관리 중인 브랜드 알려줘" (https://api.talkbridge.io/mcp/connect/, 2026-10-06 확인). 실사용 화면: manuscript/articles/images/250-…/dot-talkbridge-analysis.png. 원고 표기: 서버리스 AI 비서. 분석만 맡길 때는 dot Custom Rules로 발신·종료 동작을 "묻기/막기" 권장
  • xAI Grok Bot에서도 동작 (2026-10-08 사용자 확인): Grok Bot(xAI, 2026-08-11 베타, 비서마다 클라우드 컴퓨터, 커넥터·플러그인·MCP 서버, 결과 큰 동작 승인, 팀 Bot은 Slack 채널)은 대화창에 톡브릿지 MCP 주소를 붙여 넣고 "연결해 줘"라고 하면 OAuth 로그인으로 연결된다(사용자 실사용, 개발용 주소 화면). 출처: https://docs.x.ai/grok-bot/teams-and-enterprises. 원고 표기 "Grok Bot"(인포그래픽 구 표기 "그룻봇" 쓰지 않음)
  • Hermes 봇 조합 (2026-10-08 사용자 확인): Hermes Agent(Nous Research)는 Discord·Slack에 봇으로 들어가 에이전트 역할 → 톡브릿지 Discord·Slack 간편 연동 채널에 함께 두면 상담을 읽고 분석. 보조 경로로 ~/.hermes/config.yaml mcp_servers에 톡브릿지 MCP 등록(원격 HTTP + OAuth 2.1, Hermes 문서). ⚠ Discord·Slack에서 다른 봇이 단 스레드 답글의 카카오 발신 여부는 미확인 — 원고에 단정하지 않는다

포지셔닝 — Ready For Your Agent (2026-10-08 사용자 확정)​

  • 톡브릿지는 완성된 AI 에이전트를 제공하지 않는다. 고객사가 채택한 에이전트를 위한 준비 — 개발자 사이트 https://blumnai-playground.github.io/talk-bridge/ 첫 화면 "Ready For Your Agent"
  • Discord·Slack·Buzz에 들어가는 톡브릿지 봇은 AI가 아닌 고객 소통 전용 봇. 분석·판단은 같은 채널의 AI 에이전트 봇 몫. 톡브릿지는 A2A가 아니다
  • 새 AI 벤더의 비서형 봇마다 유용성을 지속 확인, 오픈소스 샘플(웹훅·CLI 01~05) https://github.com/BlumnAI-Playground/talk-bridge 지속 제공 — 최근 Jev(05) 샘플과 Buzz CLI 연동 추가
  • 서버리스 비서는 초기(OpenAI·xAI 경쟁). 원고에서 비서 간 가격 직접 비교는 하지 않는다(요금제 이름만)

Bridge Skills (문서 /guides/bridge-skills/)​

"AI에게 주는 업무 매뉴얼" — SKILL.md 마크다운, Claude 데스크톱·ChatGPT 공통. 추천 템플릿 셋: 상담 응대(브랜드 톤) · 상담 마무리(종료 인사·후속) · 일일 브리핑(진행 중 상담 요약). 운영 팁: 스킬(변하지 않는 규정) + 메모리(현장 노트)의 조합.

CLI (문서 /cli/commands/, /cli/gateway/)​

묶음명령
인증·정보setup(키 저장, TUI) · login(OAuth 페어링) · whoami(자격·권한 브랜드)
메시지send(텍스트·리치·첨부) · delete(24시간 이내) · upload
채널 관리webhook-domain · chat(메시징 토글) · schedule(상담시간) · block / unblock
조회history · rooms · knowledge(로컬 그래프 온톨로지)
게이트웨이gateway start / status / restart / stop
  • --json: 한 줄 JSON, REST 필드명 유지(userKey, serial, timestampUnixMs)
  • 자동화 스크립트는 npm 셸 래퍼 대신 바이너리 직접 실행 권장 (Windows spawn 실패·메시지 깨짐 방지)
  • 과금: 발신 명령만 구독 건수 소모, 조회·설정은 무료
  • 게이트웨이 = 로컬 데몬. 브릿지 코어의 SSE 스트림을 구독해 인바운드를 sink(웹훅 / Discord / Slack)로 릴레이. Discord·Slack 양방향은 BrandWrite 키 + 단일 브랜드 필수. CLI 게이트웨이 재시도: 1.3.1부터 Discord·Slack·Buzz 공통으로 일시 실패 최대 5회(재시작 후에도 유지)·전송 여부 불명은 1회만·영구 실패는 스레드에 실패 안내(SendFailurePolicy, PR #58). 이전 버전은 경량 재시도(최대 3회). 웹훅 시크릿 설정 시 HMAC 서명 헤더(X-Bridge-Signature 등) 자동 추가
  • Buzz 수신처 (CLI 1.3.1, 2026-10-06 — 클로즈 베타, CLI에서만 이용 가능, 공식 문서 미게재): 구축형 오픈소스 메신저 Buzz(Block, Nostr 릴레이) 채널로 상담을 잇는다. 상담 1건 = 스레드 1개, 스레드 답글 → 카카오 발신(작성자 구분 없음 — 에이전트가 써도 발신). setup --buzz-relay/--buzz-key/--buzz-channel/--buzz-brand → buzz check → gateway restart. 사람 키를 owner로 봇 신원 생성(owner 키 미저장). 답글 3초 폴링·1시간 넘은 답글 버림·발신 실패는 스레드 안내. BrandWrite + 단일 브랜드. 호스티드 게이트웨이·센터 설치 버튼 없음, cs-* 매크로 없음. 출처: 제품 저장소 CLI README(PR #58) · 사용자 확인

API / 웹훅 (문서 /getting-started/ … /webhooks/reliability/, /guides/self-build-bot/)​

  • 키: API 키(blumnb-...) · 웹훅 서명 시크릿(whsec_...) · 브랜드 키. 연결 키는 발급 시 1회만 노출, 민감 값은 암호화 저장 (FAQ)
  • Self-Build Bot 4단계: ① HMAC-SHA256 서명 검증 ② Delivery-Id로 멱등 처리 ③ 마지막 수신 메시지 조회 ④ 아웃바운드 API로 응답. HTTP 200을 먼저 돌려주고 실제 처리는 비동기로
  • 무한루프 방지: kind: "agent" 메시지는 건너뛴다. 서명 실패는 401, 게이트웨이가 재시도
  • 문서 절: Outbound Messages · Settings · Responses & Errors · Webhooks(Configuration · Payload & Events · Signature Verification · Content Retrieval · Retries & Idempotency)

운영 제약 (원고에서 틀리기 쉬운 것)​

제약사실출처
발신 가능 시점카카오 상담톡은 활성화된 세션에만 발신 가능. 세션 종료 후엔 고객이 새로 문의해야 답장 가능/mcp/usage/
상담시간고객이 상담을 걸 수 있는 운영 시간. 채널에 매달린 값이라 브랜드 설정 → 채널에서 채널별로 조정. 하루 1구간(요일당 시작~종료 한 구간), 시간을 넣지 않은 요일은 휴무. 비워 두고 활성화하면 24시간 무휴 자동 설정. 입력은 표시 시간대, 저장 시 KST로 자동 변환. CLI schedule get/set으로도 설정. ⚠ AI 앱(MCP)으로 상담 시간을 바꾼다는 근거는 /mcp/intro/·/mcp/usage/·/center/consult-hours/ 어디에도 없다 — 원고에 쓰지 않는다/center/consult-hours/ · /mcp/usage/ (2026-09-20 재확인)
상담원 배정·근태없다. 상담 배분·배정·대기열·상담원별 교대 기능은 공식 문서 어디에도 없고 센터 메뉴에도 없다. 상담은 설정된 수신처 전부에 도착하고 누가 받을지는 팀이 정한다. 상담시간(있음)과 반드시 구분해 서술한다문서 전수 확인 0건 (2026-09-20)
AI → 사람AI 에이전트가 먼저 응대하고 필요할 때 상담사로 전환하는 흐름 지원FAQ
메시지 삭제24시간 이내/cli/commands/
다른 채널현재 대표 채널은 카카오 상담톡. 확장 일정은 공개 안내 없음 — 원고에서 약속 금지FAQ
여러 채널채널(브랜드)별로 연결 구성 가능FAQ

수신처 팬아웃 · 복합 운영 (제품팀 확인 2026-09-13 + /cli/gateway/)​

사실출처
센터의 상담 수신처(Discord · Slack · 웹훅)는 여러 개를 함께 둘 수 있고, 들어온 상담은 설정된 수신처 모두에 팬아웃된다. 하나가 실패해도 나머지는 지속제품팀 확인(2026-09-13) · CLI 게이트웨이 문서 "Sink 3종 동시 팬아웃"
권장 연동 순서: ① Discord/Slack 먼저 연결(실제 문의를 사람이 받음) → ② 웹훅/게이트웨이를 두 번째 수신처로 붙여 개발 → ③ 완료 후 답하는 창구 선택. 새 키·채널 재설정·별도 환경 이전 불필요제품팀 확인(2026-09-13)
운영에서는 답하는 창구를 하나만 권장 — 기능 제약이 아니라 단일 지점 상담이 깨지는 운영 혼선 방지제품팀 확인(2026-09-13)
연결 수에는 제약이 없으므로 조합 가능: 폴백(Discord/Slack 유지) · 보조 에이전트(CLI 게이트웨이에 답하지 않는 요약·분류·그래프 적재 에이전트) · "레고 블록"식 복합 운영제품팀 확인(2026-09-13)
주의: 발신 agent echo는 모든 수신처에 되돌아온다 — 보조 에이전트도 필터 필요웹훅 계약(샘플 저장소) + 팬아웃 사실의 귀결

기존 문제의 배경(원고 서술용): 채널을 열고 상담 시스템을 붙이는 동안 실제 문의가 들어오면 대응 불가 → 종래 우회는 채널 검색 차단 또는 별도 환경 개발 후 이전(새 키·채널 설정·배포 사이클 동반).

원고에서 쓰지 않는 것 — 데모·시드 데이터​

샘플 저장소의 데모 데이터(예: 03 샘플의 demo:seed로 만드는 상담 기록)는 설명을 위해 연출한 가상 데이터이며 저장소에 커밋되지 않는다. 실제로는 파트너 채널의 진짜 상담으로 동작한다.

  • 원고에 건수·내용을 제품 구성물처럼 적지 않는다 ("데모 데이터 N건이 들어 있습니다" ✗)
  • 기능을 소개할 때는 실제 동작 기준으로 쓴다 ("여러분 채널에 쌓인 실제 상담으로 그래프를 만듭니다" ✓)
  • 데모 데이터로 만든 화면 캡처는 사용 가능하다 — 캡처는 화면의 예시이지 데이터의 약속이 아니다
  • 확정: M021 검수 후 사용자 지적(2026-09-13)

요금 (홈 · FAQ · /center/billing/)​

구분내용
Free가입 시 자동. 30일 안에 총 3건, 카드 등록 불필요, 매달 다시 채워지지 않음. Discord·Slack 연동 무료
Pro상담 건수별 4구간. 자동 충전
Enterprise1,000건 초과 — 별도 문의(맞춤 견적)

Pro 4구간 (2026-09-20 /center/billing/ 재확인)

월 상담 건수공급가액실제 결제액(VAT 10% 포함)건당
100건15,000원16,500원150원
300건45,000원49,500원150원
500건75,000원82,500원150원
1,000건140,000원154,000원140원
  • VAT 표기 원문: "화면과 문서의 금액은 공급가액이 기준이고, 실제 결제액(VAT 10% 포함)을 함께 표시합니다." 랜딩 각주는 "모든 요금은 부가세(VAT) 별도입니다" — 원고에서는 두 금액을 함께 쓴다
  • 과금 단위 원문: "상담 건수는 메시지 수가 아니라 상담방이 열린 날 기준(KST) 으로 셉니다. 같은 고객과 같은 날 여러 번 대화해도 1건입니다." 상담원 수로 과금하지 않음. 랜딩 부제 "상담하지 않은 고객에 대한 금액은 받지 않아요"
  • 하루의 경계: "계정의 표시 시간대와 무관하게 한국 표준시(KST) 자정"
  • 남은 건수는 다음 달로 이월되지 않음. 요금제를 올리면 즉시 결제되고 그날부터 새 주기가 시작되며 잔여 건수가 새 요금제에 합산됨(100건제 잔여 40 → 300건제 340건). 내릴 때는 다음 결제일부터, 잔여 이월 없음
  • 알림: 소진율 80%에 1회 이메일, 소진 시 이메일
  • 구독·건수는 계정 단위 하나, 브랜드 여러 개가 한 풀을 공유. 단 고객 식별은 브랜드 단위 — 같은 사람도 브랜드가 다르면 2건
  • 환불: 첫 유료 결제일로부터 7일 이내 + 그 결제로 받은 건수를 한 건도 쓰지 않았을 때만. 요금제 상향 결제는 청약철회 대상 아님
  • 취소해도 연동(카카오 채널·Discord·Slack·웹훅)은 유지 — 종료일 이후 Free로 전환될 뿐
  • 탈퇴: 유료 이용 중이면 주기 종료일에 예약, Free는 즉시

용어 (원고 표기 기준)​

용어뜻표기
톡브릿지 / TalkBridge제품명한글 "톡브릿지", 첫 등장 시 (TalkBridge) 병기
톡브릿지 센터파트너 콘솔(console.talkbridge.io)"센터"
브랜드센터의 최상위 단위. 카카오 채널·수신처·키가 브랜드에 묶인다그대로
카카오 상담톡카카오 비즈니스 채널의 1:1 상담 기능. 톡브릿지의 대표 채널"카카오 상담톡" (상담톡·카카오톡 채널과 혼용 금지)
연결 키발급 1회 노출되는 인증 값. API 키 blumnb-…, 웹훅 시크릿 whsec_…실제 값은 절대 예시로 쓰지 않는다
수신처 (sink)상담이 전달되는 곳 — Discord / Slack / 웹훅본문 "수신처", 개발자편에서 (sink) 병기
게이트웨이인바운드를 수신처로 릴레이하는 데몬. 로컬(CLI) / 호스티드그대로
세션고객이 문의해 열린 상담 단위. 활성 중에만 발신 가능"상담 세션"
AI 상담 서포터MCP 연결 후 AI가 문의를 읽고 답을 써 보내는 운영 방식문서 표기 그대로
Bridge SkillAI에게 주는 업무 매뉴얼(SKILL.md)"브릿지 스킬(Bridge Skill)"
상담 1건상담방이 열린 날 기준(KST). 같은 고객·같은 날은 몇 번이든 1건과금 설명 시 정의를 반드시 병기
간편 모드 / 개발자 모드랜딩의 모드 2분. 영문 kicker NO CODE / FOR DEVELOPERS이 표기 그대로. "노코드 모드"는 랜딩에 없는 말이라 쓰지 않는다
상담 매크로cs-close(종료) · cs-memo(메모) · cs-who(메모 보기)Discord는 슬래시 명령, Slack은 / 없이 낱말만

문서 URL 색인​

Getting Started: /, /kakao-channel/, /guides/agent-support/ · MCP: /mcp/intro/, /mcp/connect/, /mcp/usage/ · CLI: /cli/install/, /cli/setup/, /cli/commands/, /cli/gateway/ · API: /getting-started/, /authentication/, /api/outbound/, /api/settings/, /api/errors/ · Webhooks: /webhooks/setup/, /webhooks/payload/, /webhooks/signature/, /webhooks/content/, /webhooks/reliability/ · Guides: /guides/self-build-bot/, /guides/bridge-skills/ · Center: /center/setup-status/, /center/consult-hours/, /center/billing/, /center/account/, /center/notifications/, /center/ai-tools/ · /faq/, /support/ (모두 https://api.talkbridge.io 아래)

갱신 규칙​

  • 원고 사실 대조 중 문서와 이 정본이 어긋나면 문서가 이긴다 — 정본을 고치고 확인 시점을 갱신한다
  • 문서에 없는 사실을 제품팀이 확인해 주면 "제품팀 확인(날짜)"으로 출처를 적는다
  • 이 정본은 제품 사용자 관점의 사실만 담는다. 제품 내부 구현·저장소·하네스는 200편 원고의 영역이며 여기 적지 않는다
  • 원고에 쓰지 않는 것 (2026-09-20 확정): 미출시 채널의 확장 정책과 시점, 원가·마진·과금 내부 구조, 실고객사명, 내부 인프라·장애 이력. MCP 도구 개수도 쓰지 않는다 — 문서 표기와 실측이 어긋난다
  • 랜딩 STEP 3의 "Discode"는 오타다. 인용하지 말고 "Discord"로 쓴다

관련​

  • [[talkbridge-guide]] — 이 정본의 집행자
  • [[talkbridge-blog-track]] — 트랙 규약
  • [[technical-terminology]] — 약어 병기 규칙(MCP·API·CLI·HMAC 첫 등장 풀어쓰기)