전화약속관리

전화약속 상세 변경/완료

post

기능설명

• 전화약속 상세 정보를 변경하거나, 완료처리 합니다.

---

상세설명

• 선택한 전화약속 정보를 변경하거나, 완료처리 합니다.

• 예약일시/알림설정, 휴대폰번호, 상담메모 수정이 가능합니다.

• 약속정보를 변경하면 기존 전화약속 정보는 완료처리하고 신규 전화약속 정보를 생성합니다.

• 수정으로 신규 생성된 전화약속 담당자는 로그인한 상담원 입니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

ccnNostringOptional

상담번호

Example: 10004891

cnslProcSeqstringOptional

상담처리순번

Example: 1

telPrmsSeqstringOptional

전화약속순번

Example: 1

savegubstringOptional

저장구분(0:변경, 1:처리완료)

Example: 0

prmsDtmstringOptional

약속일시

Example: 2023-09-18 14:49

notiTmCdstring · enumOptional

알림시간코드(CS013)

Example: 15Possible values:

prmsMethCdstring · enumOptional

약속방식코드(CS008)

Example: 10Possible values:

prmsStatCdstring · enumOptional

약속상태코드(CS009)

Example: 20Possible values:

cnslMemostringOptional

상담메모

Example: 전화약속 테스트 합니다.

aempConfDtmstringOptional

담당자확인일시

Example: 2023-09-15 15:03:37

telTryCntstringOptional

전화시도수

Example: 0

cnslindInfoMemostringOptional

상담개인정보메모

telRgnNostringOptional

전화지역번호

Example: 010

telTxnoNostringOptional

전화국번번호

Example: 1111

telEndNostringOptional

전화끝번호

Example: 2222

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

post

/v2/customerservice/phoneAppointmentMgmt/savePhoneAppointment

HTTPcURLJavaScriptPython

POST /api/bo/v2/customerservice/phoneAppointmentMgmt/savePhoneAppointment HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 308

{
  "ccnNo": 10004891,
  "cnslProcSeq": 1,
  "telPrmsSeq": 1,
  "savegub": 0,
  "prmsDtm": "2023-09-18 14:49",
  "notiTmCd": 15,
  "prmsMethCd": 10,
  "prmsStatCd": 20,
  "cnslMemo": "전화약속 테스트 합니다.",
  "aempConfDtm": "2023-09-15 15:03:37",
  "telTryCnt": 0,
  "cnslindInfoMemo": "text",
  "telRgnNo": "010",
  "telTxnoNo": 1111,
  "telEndNo": 2222
}

{
  "timestamp": "2026-02-27T18:20:57.644Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

전화약속 상세 정보 조회

get

기능설명

• 전화약속 상세 정보를 조회 합니다.

---

상세설명

• 선택한 전화약속 상세 정보를 조회 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNostringOptional

상담번호

Example: 10004891

cnslProcSeqstringOptional

상담처리순번

Example: 1

telPrmsSeqstringOptional

전화약속순번

Example: 1

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentPopup

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentPopup HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:20:57.644Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "procState": "text",
    "procStateCd": "text",
    "prmsDtm": "text",
    "notiTmCd": "text",
    "prmsMethCd": "text",
    "cnslMemo": "text",
    "mbrNo": "text",
    "mbrId": "text",
    "mbrNm": "text",
    "telRgnNo": "text",
    "telTxnoNo": "text",
    "telTxnoNos": "text",
    "telEndNo": "text",
    "telEndNos": "text",
    "ordNo": "text",
    "ccnNo": "text",
    "acptmnNm": "text",
    "acptmnId": "text",
    "acpCont": "text",
    "acptmnDept": "text",
    "procmnNm": "text",
    "procmnId": "text",
    "procmnDept": "text",
    "aempConfDtm": "text",
    "aempProcDtm": "text",
    "cnslProcSeq": "text",
    "telPrmsSeq": "text",
    "cnslTypText": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

전화약속 목록 조회

get

기능설명

• 전화약속 목록을 조회 합니다.

---

상세설명

• 선택한 조건에 맞는 전화약속 목록을 조회 합니다.

---

코드정리

• 기간검색종류(periodType): 예약일자(0), 완료일자(1)

• 전약상태(procState): 예약(R), 임박(I), 지연(D), 완료(C)

• 회원검색종류(mbrType): 회원ID(0), 회원명(1)

• 담당자검색종류(userType): 접수자(0), 처리자(1)

---

수정 번호

• Release v2.00_240613: 기간 검색 조건 개선

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

periodTypestringOptional

기간 검색 종류

Example: 0

startDatestring · dateOptional

검색시작일자

Example: 2023-08-20

endDatestring · dateOptional

검색종료일자

Example: 2023-09-19

procStatestringOptional

전화약속상태

Example: R

prmsMethCdstring · enumOptional

약속방식코드(CS008)

Example: 10Possible values:

mbrNostringOptional

회원번호

Example: 10000001

userTypestringOptional

담당자 검색 종류

Example: 0

userTextstringOptional

담당자ID

Example: x2beecc

ordNostringOptional

주문번호

Example: 20230718O002626

ccnNostringOptional

상담번호

Example: 10004891

siteNostringOptional

사이트번호

Example: 1

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "procState": "text",
      "procStateCd": "text",
      "prmsDtm": "text",
      "notiTmCd": "text",
      "prmsMethCd": "text",
      "cnslMemo": "text",
      "mbrNo": "text",
      "mbrId": "text",
      "mbrNm": "text",
      "telRgnNo": "text",
      "telTxnoNo": "text",
      "telEndNo": "text",
      "ordNo": "text",
      "ccnNo": "text",
      "acptmnNm": "text",
      "accpCont": "text",
      "accpDtm": "text",
      "acptmnDept": "text",
      "procmnId": "text",
      "procmnNm": "text",
      "procmnTel": "text",
      "procmnEmpNo": "text",
      "procmnDept": "text",
      "aempProcDtm": "text",
      "cnslProcSeq": "text",
      "telPrmsSeq": "text",
      "procmnProcDtm": "text",
      "acptmnId": "text",
      "siteNm": "text"
    }
  ]
}

전화약속 상세 약속 이력 목록 조회

get

기능설명

• 전화약속 상세 약속 이력 목록을 조회 합니다.

---

상세설명

• 전화약속 예약한 상담의 전체 변경이력 목록을 조회 합니다.

• 마지막 상담이력만 상세보기가 가능 합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringRequired

상담번호

Example: 10004891

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentHistoryList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentHistoryList?ccnNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "procState": "text",
      "procStateCd": "text",
      "prmsDtm": "text",
      "notiTmCd": "text",
      "prmsMethCd": "text",
      "cnslMemo": "text",
      "mbrNo": "text",
      "mbrId": "text",
      "mbrNm": "text",
      "telRgnNo": "text",
      "telTxnoNo": "text",
      "telEndNo": "text",
      "ordNo": "text",
      "ccnNo": "text",
      "acptmnNm": "text",
      "accpCont": "text",
      "accpDtm": "text",
      "acptmnDept": "text",
      "procmnId": "text",
      "procmnNm": "text",
      "procmnTel": "text",
      "procmnEmpNo": "text",
      "procmnDept": "text",
      "aempProcDtm": "text",
      "cnslProcSeq": "text",
      "telPrmsSeq": "text",
      "procmnProcDtm": "text",
      "acptmnId": "text",
      "siteNm": "text"
    }
  ]
}

전화약속 알림 목록 조회

get

기능설명

• 상담원의 전화약속 알림 목록을 조회 힙니다.

---

상세설명

• 로그인한 상담원이 처리해야 할 전화약속 목록을 조회 합니다.

• 임박한 전화약속은 팝업 형태로 노출 됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

aempIdStringRequired

담당자ID

Responses

200

성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

업무처리 오류 내용

*/*

get

/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentAlarmList

HTTPcURLJavaScriptPython

GET /api/bo/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentAlarmList?aempId=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:20:57.644Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "procState": "text",
      "procStateCd": "text",
      "prmsDtm": "text",
      "notiTmCd": "text",
      "prmsMethCd": "text",
      "cnslMemo": "text",
      "mbrNo": "text",
      "mbrId": "text",
      "mbrNm": "text",
      "telRgnNo": "text",
      "telTxnoNo": "text",
      "telEndNo": "text",
      "ordNo": "text",
      "ccnNo": "text",
      "acptmnNm": "text",
      "accpCont": "text",
      "accpDtm": "text",
      "acptmnDept": "text",
      "procmnId": "text",
      "procmnNm": "text",
      "procmnTel": "text",
      "procmnEmpNo": "text",
      "procmnDept": "text",
      "aempProcDtm": "text",
      "cnslProcSeq": "text",
      "telPrmsSeq": "text",
      "procmnProcDtm": "text",
      "acptmnId": "text",
      "siteNm": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}