전화약속관리

전화약속 상세 변경/완료

post

기능설명

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

상세설명

선택한 전화약속 정보를 변경하거나, 완료처리 합니다.
예약일시/알림설정, 휴대폰번호, 상담메모 수정이 가능합니다.
약속정보를 변경하면 기존 전화약속 정보는 완료처리하고 신규 전화약속 정보를 생성합니다.
수정으로 신규 생성된 전화약속 담당자는 로그인한 상담원 입니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

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

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-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

전화약속 상세 정보 조회

get

기능설명

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

상세설명

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

Authorizations

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

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

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "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

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

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

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

ccnNoStringRequired

상담번호

Example: 10004891

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get/v2/customerservice/phoneAppointmentMgmt/getPhoneAppointmentHistoryList

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

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

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-01-01T00:00:00.000Z",
  "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"
    }
  ]
}

이전보상유형관리

다음OB유형관리

마지막 업데이트 7일 전