명령어 레퍼런스
talkbridge <명령> [옵션]. 인증이 필요한 명령은 먼저 setup / login으로 키를 등록해야 합니다.
옵션 표기: --brand 브랜드(채널) 키 · --to(=--user) 대상 고객 키 · --brand 없으면 대부분 필수.
전체 명령
| 명령 | 동작 | 주요 옵션 |
|---|---|---|
setup [<키>] | 키 검증·저장 / 인자 없으면 TUI | --endpoint, sink·CRM·AI 플래그 |
login | 웹 OAuth 페어링으로 키 발급·저장 | --console, --endpoint |
whoami | 내 이름·권한·엔드포인트·허용 브랜드 | — |
history | 상담 이력(진행중/완료, convId) | --brand |
rooms | 상담방 리스트 / 특정 방 메시지 | --brand(필수), --user, --max N |
send | 텍스트/리치 발송 | --brand, --to, --text, --rich-json <파일> |
profile | 발신프로필 조회 | --brand(필수) |
webhook-domain | 수신도메인 조회/설정 | get/set, --brand, --url |
chat | 채팅기능 토글 | activate/deactivate, --brand |
schedule | 상담시간 조회/설정 | get/set, --brand, --json <파일> |
block / unblock | 사용자 차단 / 해제 | --brand, --to |
end-with-bot | 종료 + 봇 전환(handoff) | --brand, --to, --event |
sysmsg | 시스템메시지 조회 | --brand(필수) |
upload | 멀티미디어 업로드 | image/file/audio/video, --brand, --file |
gateway | 아웃바운드 게이트웨이 데몬 | start/stop/restart/status → 게이트웨이 |
knowledge | 상담지식 온톨로지(그래프 RAG) | status/install/build/search/view |
model | AI 모델 조회·선택 | list / set <id> |
chatbot | AI 상담 보조 대화형 TUI | (setup·model 선행) |
자주 쓰는 예시
내 정보 · 이력
talkbridge whoami
talkbridge history --brand mybrand
talkbridge rooms --brand mybrand --user kakao:Uabc123 --max 20
발신 (텍스트)
talkbridge send --brand mybrand --to kakao:Uabc123 --text "안녕하세요"
발신 (리치)
리치 봉투 JSON 파일을 만들어 전달합니다. chat_bubble_type 는 필수이며, user_key·sender_key·serial_number 는 서버가 채웁니다.
talkbridge send --brand mybrand --to kakao:Uabc123 --rich-json rich.json
채널 설정
# 수신도메인
talkbridge webhook-domain set --brand mybrand --url https://hook.example.com
# 채팅기능 토글
talkbridge chat activate --brand mybrand
# 상담시간 (JSON 파일로)
talkbridge schedule set --brand mybrand --json schedule.json
고객 관리 · 핸드오프
talkbridge block --brand mybrand --to kakao:Uabc123
talkbridge unblock --brand mybrand --to kakao:Uabc123
talkbridge end-with-bot --brand mybrand --to kakao:Uabc123 --event welcome
업로드
talkbridge upload image --brand mybrand --file photo.jpg
talkbridge upload file --brand mybrand --file manual.pdf
과금 유의
발신형 명령(send, 리치 발송 등)은 구독 플랜에 포함된 상담 건수를 소진합니다. 조회·설정 명령은 비과금입니다. 남은 건수를 모두 소진하면 발송이 차단되며, 상위 플랜으로 업그레이드하면 재개됩니다.
디스코드 인채널 커맨드
게이트웨이(Discord sink)가 가동 중이면 상담원이 디스코드 스레드에서 /cs-close, /cs-memo, /cs-who 를 쓸 수 있습니다. → 게이트웨이