# 전화약속관리
## 전화약속 상세 변경/완료
> \## 기능설명\
> \* 전화약속 상세 정보를 변경하거나, 완료처리 합니다.\
> \---\
> \## 상세설명\
> \* 선택한 전화약속 정보를 변경하거나, 완료처리 합니다.\
> \* 예약일시/알림설정, 휴대폰번호, 상담메모 수정이 가능합니다.\
> \* 약속정보를 변경하면 기존 전화약속 정보는 완료처리하고 신규 전화약속 정보를 생성합니다.\
> \* 수정으로 신규 생성된 전화약속 담당자는 로그인한 상담원 입니다.
```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"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/cs-bo-api/undefined-1.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.