설정 API
채널의 상담 설정(상담시간·채팅기능·수신도메인)을 조회·변경합니다.
- 조회(GET)는 BrandRead, 변경(POST)은 BrandWrite.
- Base URL:
https://api.talkbridge-dev.com - 응답 봉투:
{ "ok": boolean, "code": string, "message": string, "data": object }
상담시간
GET /api/agent/channel/schedule?brand=mybrand
POST /api/agent/channel/schedule
변경 바디:
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
brandKey | string | ✅ | 브랜드 키 |
weekTimetable | array | ✅ | 요일별 상담시간 슬롯 |
weekTimetable[] 항목:
| 필드 | 타입 | 설명 |
|---|---|---|
day | string | 요일 |
startAt | string | 시작 시각 |
endAt | string | 종료 시각 |
curl -X POST https://api.talkbridge-dev.com/api/agent/channel/schedule \
-H "Authorization: Bearer blumnb-..." -H "Content-Type: application/json" \
-d '{
"brandKey": "mybrand",
"weekTimetable": [
{ "day": "MON", "startAt": "09:00", "endAt": "18:00" },
{ "day": "TUE", "startAt": "09:00", "endAt": "18:00" }
]
}'
노트
weekTimetable가 비어 있으면 400 EMPTY 로 거부됩니다.
채팅기능 토글
상담 채팅 기능을 켜거나 끕니다.
POST /api/agent/channel/chat
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
brandKey | string | ✅ | 브랜드 키 |
active | boolean | ✅ | 활성/비활성 |
수신도메인
GET /api/agent/channel/domain?brand=mybrand
POST /api/agent/channel/domain
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
brandKey | string | ✅ | 브랜드 키 |
domain | string | ✅ | 수신도메인 |
경고
수신도메인 변경은 실제 채널 수신 경로를 바꿉니다. bypass 게이트웨이를 사용하는 구성에서는 이 값을 임의로 바꾸지 마세요 — 상담 수신이 끊길 수 있습니다.
발신프로필 · 시스템메시지 (조회)
GET /api/agent/profile?brand=mybrand
GET /api/agent/sysmsg?brand=mybrand
각각 발신프로필, 등록된 시스템메시지를 조회합니다. 응답의 data에 카카오 원본 형식이 담깁니다.