setup & 로그인
CLI가 상담 채널에 접근하려면 시크릿키(blumnb-...)와 엔드포인트가 필요합니다. 자격은 검증 후 ~/.bridge-agent/config.json 에 저장됩니다.
두 가지 등록 방법이 있습니다.
방법 1 — login (OAuth 페어링, 권장)
브라우저로 톡브릿지 센터에 로그인해 브랜드를 고르면, CLI가 자동으로 BrandWrite 키를 발급받아 저장합니다.
talkbridge login
흐름:
- CLI가 브라우저로 톡브릿지 센터의
/Partner/CliLogin을 엽니다. - 파트너가 로그인 후 브랜드를 선택합니다.
- 톡브릿지 센터가 5자리·5분 유효 코드를 표시합니다.
- 터미널에 코드를 입력하면, CLI가 키를 교환·검증·저장합니다.
옵션: --console <URL>, --endpoint <URL>
방법 2 — setup
(a) TUI 마법사
인자 없이 실행하면 대화형 설정 마법사(Terminal.Gui)가 뜹니다.
talkbridge setup
화면 구성:
Channel
├─ Inbound ▸ Kakao (시크릿키 · [Health check] 로 라이브 검증)
└─ Outbound ▸ Discord / Slack / Webhook (게이트웨이 sink)
CS Features ▸ Customer Memo (SQLite / MySQL / CSV)
AI ▸ AI Chatbot (프로바이더 · 베이스URL · 키 → 모델 선택)
Knowledge ▸ Ontology
- 기존 설정이 있 으면 재설정할 섹션만 체크하고, 미선택 섹션은 기존값을 유지합니다.
- Kakao 단계 [Health check] 버튼으로 입력한 키를 즉시 검증할 수 있습니다.
- AI 단계는
GET /v1/models로 실제 모델 목록을 조회해 고릅니다.
TUI 문제 해결
- 화살표 키가 취소로 오작동하면
BRIDGE_TUI_DIAG=1로 실행해 키 이벤트 로그를 남길 수 있습니다(temp 파일). - Windows에서는 WindowsDriver + VT 입력 모드 해제로 이 문제를 회피합니다.
(b) 비대화형 (시크릿키·플래그)
키를 인자로 주면 검증 후 바로 저장합니다(TUI 없이).
talkbridge setup blumnb-xxxx-xxxx-xxxx --endpoint https://<bridge-endpoint>
주요 플래그:
| 그룹 | 플래그 |
|---|---|
| 기본 | --key, --endpoint |
| Webhook sink | --webhook-url, --webhook-secret(HMAC 서명), --webhook-brand, --webhook-console |
| Discord sink | --discord-token, --guild, --channel, --discord-brand |
| Slack sink | --slack-bot(xoxb), --slack-app(xapp), --slack-channel, --slack-brand |
| CRM | --crm sqlite|mysql|csv, --sqlite-path, --mysql-conn, --csv-path |
| AI | --ai-base, --ai-key, --ai-model, --ai-provider, --ai-api chat|responses |
설정 완료 후 이름·권한·허용 브랜드가 출력됩니다.
인증 & 엔드포인트
- 모든 요청은
Authorization: Bearer <시크릿키>로 인증합니다. - 키는 스코프를 가집니다: BrandRead / BrandWrite / Admin. 발신·설정 변경은 BrandWrite 이상이 필요합니다.
- 기본 브릿지 엔드포인트는
https://webhook.talkbridge-dev.com이며,setup --endpoint또는login으로 바꿀 수 있습니다. - 자격 저장 위치는
talkbridge env의config경로입니다 — 사용자 전용 권한으로 보호됩니다.
검증
talkbridge whoami
이름·권한(스코프)·엔드포인트·허용 브랜드가 나오면 준비 완료입니다. → 명령어 레퍼런스