본문으로 건너뛰기

설정 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

변경 바디:

필드타입필수설명
brandKeystring브랜드 키
weekTimetablearray요일별 상담시간 슬롯

weekTimetable[] 항목:

필드타입설명
daystring요일
startAtstring시작 시각
endAtstring종료 시각
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
필드타입필수설명
brandKeystring브랜드 키
activeboolean활성/비활성

수신도메인

GET /api/agent/channel/domain?brand=mybrand
POST /api/agent/channel/domain
필드타입필수설명
brandKeystring브랜드 키
domainstring수신도메인
경고

수신도메인 변경은 실제 채널 수신 경로를 바꿉니다. bypass 게이트웨이를 사용하는 구성에서는 이 값을 임의로 바꾸지 마세요 — 상담 수신이 끊길 수 있습니다.


발신프로필 · 시스템메시지 (조회)

GET /api/agent/profile?brand=mybrand
GET /api/agent/sysmsg?brand=mybrand

각각 발신프로필, 등록된 시스템메시지를 조회합니다. 응답의 data에 카카오 원본 형식이 담깁니다.