> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/cs-bo-api/undefined-1.md).
# 전화약속관리
## 전화약속 상세 변경/완료
> \## 기능설명\
> \* 전화약속 상세 정보를 변경하거나, 완료처리 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 전화약속 정보를 변경하거나, 완료처리 합니다.\
> \* 예약일시/알림설정, 휴대폰번호, 상담메모 수정이 가능합니다.\
> \* 약속정보를 변경하면 기존 전화약속 정보는 완료처리하고 신규 전화약속 정보를 생성합니다.\
> \* 수정으로 신규 생성된 전화약속 담당자는 로그인한 상담원 입니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PhoneAppointmentPopupRequest":{"type":"object","properties":{"ccnNo":{"type":"string","description":"상담번호"},"cnslProcSeq":{"type":"string","description":"상담처리순번"},"telPrmsSeq":{"type":"string","description":"전화약속순번"},"savegub":{"type":"string","description":"저장구분(0:변경, 1:처리완료)"},"prmsDtm":{"type":"string","description":"약속일시"},"notiTmCd":{"type":"string","description":"알림시간코드(CS013)","enum":["ALIM_MIN_1","ALIM_MIN_3","ALIM_MIN_5","ALIM_MIN_10","ALIM_MIN_15","ALIM_MIN_20","ALIM_MIN_30"]},"prmsMethCd":{"type":"string","description":"약속방식코드(CS008)","enum":["CALL"]},"prmsStatCd":{"type":"string","description":"약속상태코드(CS009)","enum":["APPOINTMENT","COMPLETE"]},"cnslMemo":{"type":"string","description":"상담메모"},"aempConfDtm":{"type":"string","description":"담당자확인일시"},"telTryCnt":{"type":"string","description":"전화시도수"},"cnslindInfoMemo":{"type":"string","description":"상담개인정보메모"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/phoneAppointmentMgmt/savePhoneAppointment":{"post":{"tags":["전화약속관리"],"summary":"전화약속 상세 변경/완료","description":"## 기능설명\n* 전화약속 상세 정보를 변경하거나, 완료처리 합니다.\n---\n## 상세설명\n* 선택한 전화약속 정보를 변경하거나, 완료처리 합니다.\n* 예약일시/알림설정, 휴대폰번호, 상담메모 수정이 가능합니다.\n* 약속정보를 변경하면 기존 전화약속 정보는 완료처리하고 신규 전화약속 정보를 생성합니다.\n* 수정으로 신규 생성된 전화약속 담당자는 로그인한 상담원 입니다.\n","operationId":"savePhoneAppointment","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneAppointmentPopupRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 전화약속 상세 정보 조회
> \## 기능설명\
> \* 전화약속 상세 정보를 조회 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 전화약속 상세 정보를 조회 합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponsePhoneAppointmentPopupResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/PhoneAppointmentPopupResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PhoneAppointmentPopupResponse":{"type":"object","properties":{"procState":{"type":"string"},"procStateCd":{"type":"string"},"prmsDtm":{"type":"string"},"notiTmCd":{"type":"string"},"prmsMethCd":{"type":"string"},"cnslMemo":{"type":"string"},"mbrNo":{"type":"string"},"mbrId":{"type":"string"},"mbrNm":{"type":"string"},"telRgnNo":{"type":"string"},"telTxnoNo":{"type":"string"},"telTxnoNos":{"type":"string"},"telEndNo":{"type":"string"},"telEndNos":{"type":"string"},"ordNo":{"type":"string"},"ccnNo":{"type":"string"},"acptmnNm":{"type":"string"},"acptmnId":{"type":"string"},"acpCont":{"type":"string"},"acptmnDept":{"type":"string"},"procmnNm":{"type":"string"},"procmnId":{"type":"string"},"procmnDept":{"type":"string"},"aempConfDtm":{"type":"string"},"aempProcDtm":{"type":"string"},"cnslProcSeq":{"type":"string"},"telPrmsSeq":{"type":"string"},"cnslTypText":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentPopup":{"get":{"tags":["전화약속관리"],"summary":"전화약속 상세 정보 조회","description":"## 기능설명\n* 전화약속 상세 정보를 조회 합니다.\n---\n## 상세설명\n* 선택한 전화약속 상세 정보를 조회 합니다.\n","operationId":"getPhoneAppointmentPopup","parameters":[{"name":"ccnNo","in":"query","description":"상담번호","required":false,"schema":{"type":"string","description":"상담번호"}},{"name":"cnslProcSeq","in":"query","description":"상담처리순번","required":false,"schema":{"type":"string","description":"상담처리순번"}},{"name":"telPrmsSeq","in":"query","description":"전화약속순번","required":false,"schema":{"type":"string","description":"전화약속순번"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePhoneAppointmentPopupResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 전화약속 목록 조회
> \## 기능설명\
> \* 전화약속 목록을 조회 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 조건에 맞는 전화약속 목록을 조회 합니다.\
> \---\
> \## 코드정리\
> \* 기간검색종류(periodType): 예약일자(0), 완료일자(1)\
> \* 전약상태(procState): 예약(R), 임박(I), 지연(D), 완료(C)\
> \* 회원검색종류(mbrType): 회원ID(0), 회원명(1)\
> \* 담당자검색종류(userType): 접수자(0), 처리자(1)\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240613: 기간 검색 조건 개선
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponsePhoneAppointmentResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PhoneAppointmentResponse"}}}},"PhoneAppointmentResponse":{"type":"object","properties":{"procState":{"type":"string"},"procStateCd":{"type":"string"},"prmsDtm":{"type":"string"},"notiTmCd":{"type":"string"},"prmsMethCd":{"type":"string"},"cnslMemo":{"type":"string"},"mbrNo":{"type":"string"},"mbrId":{"type":"string"},"mbrNm":{"type":"string"},"telRgnNo":{"type":"string"},"telTxnoNo":{"type":"string"},"telEndNo":{"type":"string"},"ordNo":{"type":"string"},"ccnNo":{"type":"string"},"acptmnNm":{"type":"string"},"accpCont":{"type":"string"},"accpDtm":{"type":"string"},"acptmnDept":{"type":"string"},"procmnId":{"type":"string"},"procmnNm":{"type":"string"},"procmnTel":{"type":"string"},"procmnEmpNo":{"type":"string"},"procmnDept":{"type":"string"},"aempProcDtm":{"type":"string"},"cnslProcSeq":{"type":"string"},"telPrmsSeq":{"type":"string"},"procmnProcDtm":{"type":"string"},"acptmnId":{"type":"string"},"siteNm":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentList":{"get":{"tags":["전화약속관리"],"summary":"전화약속 목록 조회","description":"## 기능설명\n* 전화약속 목록을 조회 합니다.\n---\n## 상세설명\n* 선택한 조건에 맞는 전화약속 목록을 조회 합니다.\n---\n## 코드정리\n* 기간검색종류(periodType): 예약일자(0), 완료일자(1)\n* 전약상태(procState): 예약(R), 임박(I), 지연(D), 완료(C)\n* 회원검색종류(mbrType): 회원ID(0), 회원명(1)\n* 담당자검색종류(userType): 접수자(0), 처리자(1)\n---\n## 수정 번호\n* Release v2.00_240613: 기간 검색 조건 개선\n","operationId":"getPhoneAppointmentList","parameters":[{"name":"periodType","in":"query","description":"기간 검색 종류","required":false,"schema":{"type":"string","description":"기간 검색 종류"}},{"name":"startDate","in":"query","description":"검색시작일자","required":false,"schema":{"type":"string","format":"date","description":"검색시작일자"}},{"name":"endDate","in":"query","description":"검색종료일자","required":false,"schema":{"type":"string","format":"date","description":"검색종료일자"}},{"name":"procState","in":"query","description":"전화약속상태","required":false,"schema":{"type":"string","description":"전화약속상태"}},{"name":"prmsMethCd","in":"query","description":"약속방식코드(CS008)","required":false,"schema":{"type":"string","description":"약속방식코드(CS008)","enum":["CALL"]}},{"name":"mbrNo","in":"query","description":"회원번호","required":false,"schema":{"type":"string","description":"회원번호"}},{"name":"userType","in":"query","description":"담당자 검색 종류","required":false,"schema":{"type":"string","description":"담당자 검색 종류"}},{"name":"userText","in":"query","description":"담당자ID","required":false,"schema":{"type":"string","description":"담당자ID"}},{"name":"ordNo","in":"query","description":"주문번호","required":false,"schema":{"type":"string","description":"주문번호"}},{"name":"ccnNo","in":"query","description":"상담번호","required":false,"schema":{"type":"string","description":"상담번호"}},{"name":"siteNo","in":"query","description":"사이트번호","required":false,"schema":{"type":"string","description":"사이트번호"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponsePhoneAppointmentResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 전화약속 상세 약속 이력 목록 조회
> \## 기능설명\
> \* 전화약속 상세 약속 이력 목록을 조회 합니다.\
> \---\
> \## 상세설명\
> \* 전화약속 예약한 상담의 전체 변경이력 목록을 조회 합니다.\
> \* 마지막 상담이력만 상세보기가 가능 합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponsePhoneAppointmentResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/PhoneAppointmentResponse"}}}},"PhoneAppointmentResponse":{"type":"object","properties":{"procState":{"type":"string"},"procStateCd":{"type":"string"},"prmsDtm":{"type":"string"},"notiTmCd":{"type":"string"},"prmsMethCd":{"type":"string"},"cnslMemo":{"type":"string"},"mbrNo":{"type":"string"},"mbrId":{"type":"string"},"mbrNm":{"type":"string"},"telRgnNo":{"type":"string"},"telTxnoNo":{"type":"string"},"telEndNo":{"type":"string"},"ordNo":{"type":"string"},"ccnNo":{"type":"string"},"acptmnNm":{"type":"string"},"accpCont":{"type":"string"},"accpDtm":{"type":"string"},"acptmnDept":{"type":"string"},"procmnId":{"type":"string"},"procmnNm":{"type":"string"},"procmnTel":{"type":"string"},"procmnEmpNo":{"type":"string"},"procmnDept":{"type":"string"},"aempProcDtm":{"type":"string"},"cnslProcSeq":{"type":"string"},"telPrmsSeq":{"type":"string"},"procmnProcDtm":{"type":"string"},"acptmnId":{"type":"string"},"siteNm":{"type":"string"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentHistoryList":{"get":{"tags":["전화약속관리"],"summary":"전화약속 상세 약속 이력 목록 조회","description":"## 기능설명\n* 전화약속 상세 약속 이력 목록을 조회 합니다.\n---\n## 상세설명\n* 전화약속 예약한 상담의 전체 변경이력 목록을 조회 합니다.\n* 마지막 상담이력만 상세보기가 가능 합니다.\n","operationId":"getPhoneAppointmentHistoryList","parameters":[{"name":"ccnNo","in":"query","description":"상담번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponsePhoneAppointmentResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 전화약속 알림 목록 조회
> \## 기능설명\
> \* 상담원의 전화약속 알림 목록을 조회 힙니다.\
> \---\
> \## 상세설명\
> \* 로그인한 상담원이 처리해야 할 전화약속 목록을 조회 합니다.\
> \* 임박한 전화약속은 팝업 형태로 노출 됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListPhoneAppointmentResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/PhoneAppointmentResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PhoneAppointmentResponse":{"type":"object","properties":{"procState":{"type":"string"},"procStateCd":{"type":"string"},"prmsDtm":{"type":"string"},"notiTmCd":{"type":"string"},"prmsMethCd":{"type":"string"},"cnslMemo":{"type":"string"},"mbrNo":{"type":"string"},"mbrId":{"type":"string"},"mbrNm":{"type":"string"},"telRgnNo":{"type":"string"},"telTxnoNo":{"type":"string"},"telEndNo":{"type":"string"},"ordNo":{"type":"string"},"ccnNo":{"type":"string"},"acptmnNm":{"type":"string"},"accpCont":{"type":"string"},"accpDtm":{"type":"string"},"acptmnDept":{"type":"string"},"procmnId":{"type":"string"},"procmnNm":{"type":"string"},"procmnTel":{"type":"string"},"procmnEmpNo":{"type":"string"},"procmnDept":{"type":"string"},"aempProcDtm":{"type":"string"},"cnslProcSeq":{"type":"string"},"telPrmsSeq":{"type":"string"},"procmnProcDtm":{"type":"string"},"acptmnId":{"type":"string"},"siteNm":{"type":"string"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentAlarmList":{"get":{"tags":["전화약속관리"],"summary":"전화약속 알림 목록 조회","description":"## 기능설명\n* 상담원의 전화약속 알림 목록을 조회 힙니다.\n---\n## 상세설명\n* 로그인한 상담원이 처리해야 할 전화약속 목록을 조회 합니다.\n* 임박한 전화약속은 팝업 형태로 노출 됩니다.\n","operationId":"getPhoneAppointmentAlarmList","parameters":[{"name":"aempId","in":"query","description":"담당자ID","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPhoneAppointmentResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```